Dezvoltatori și creatori

Creează o temă

O temă este un document XML care conține GlobalStyles și, opțional, LexerStyles. Începe de la o temă exportată când ai nevoie de acoperire completă a limbajelor. Exemplul Ocean este intenționat mic: stabilește o paletă albastră pentru editor și câteva stiluri Python.

Culorile folosesc șase cifre hexazecimale fără #. Intrările globale WidgetStyle descriu suprafața editorului, marginea, cursorul, selecția și linia curentă. Un LexerType grupează stilurile limbajului; valorile styleID aparțin acelui lexer și nu pot fi ghicite din alt limbaj. fontStyle este o mască de biți: 1 aldin, 2 cursiv, 4 subliniat; 0 este normal.

1. Descarcă Elite-Ocean.xml și păstrează o copie înainte de editare.
2. În Configurări, deschide Importă configurări și teme → Importă temă XML. Importul activează o copie în biblioteca aplicației; fișierul original rămâne nemodificat.
3. Deschide exemple Python și text simplu. Verifică textul, selecția, cursorul, marginile și contrastul în medii luminoase și întunecate.
4. Deschide Teme → Editează stiluri, folosește Salvează o copie pentru ajustări, apoi Exportă XML pentru distribuire.

<?xml version="1.0" encoding="UTF-8"?>
<NotepadPlus>
  <GlobalStyles>
    <WidgetStyle name="Default Style" styleID="32" fgColor="DCEBFF" bgColor="102C54" fontName="Menlo" fontSize="14" fontStyle="0" />
    <WidgetStyle name="Line number margin" styleID="33" fgColor="88A9D2" bgColor="102C54" />
    <WidgetStyle name="Caret colour" styleID="2069" fgColor="62ADFF" />
    <WidgetStyle name="Selected text colour" styleID="0" fgColor="FFFFFF" bgColor="245B96" />
    <WidgetStyle name="Current line background colour" styleID="0" bgColor="15365F" />
  </GlobalStyles>
  <LexerStyles>
    <LexerType name="python" desc="Python" ext="py pyw">
      <WordsStyle name="KEYWORD" styleID="5" fgColor="84C1FF" bgColor="102C54" fontStyle="1" />
      <WordsStyle name="COMMENTLINE" styleID="1" fgColor="8BA6C8" bgColor="102C54" fontStyle="2" />
    </LexerType>
  </LexerStyles>
</NotepadPlus>

Definește un limbaj cu UDL

Un fișier UDL XML descrie extensii, grupuri de cuvinte-cheie, comentarii, delimitatori și stiluri. Folosește editorul de limbaje integrat pentru o definiție mai bogată; exemplul evidențiază doar task, end, true și false în fișiere .edemo.

Importă Elite-Demo.xml ca limbaj de utilizator și deschide elite-demo.edemo. Dacă este necesar, selectează explicit Elite Demo. Extensiile sunt separate prin spații și scrise fără punctul inițial. Exportă o copie după testare.

<?xml version="1.0" encoding="UTF-8"?>
<NotepadPlus>
  <UserLang name="Elite Demo" ext="edemo" udlVersion="2.1">
    <Settings>
      <Global caseIgnored="no" allowFoldOfComments="no" foldCompact="no" forcePureLC="0" decimalSeparator="0" />
      <Prefix Keywords1="no" />
    </Settings>
    <KeywordLists>
      <Keywords name="Keywords1">task end true false</Keywords>
    </KeywordLists>
    <Styles>
      <WordsStyle name="DEFAULT" styleID="0" fgColor="102C54" bgColor="F8FBFF" fontStyle="0" />
      <WordsStyle name="KEYWORDS1" styleID="4" fgColor="1559AD" bgColor="F8FBFF" fontStyle="1" />
    </Styles>
  </UserLang>
</NotepadPlus>

Creează un dicționar de completare automată

XML-ul API de completare automată enumeră intrări KeyWord. O intrare de funcție poate conține elemente Overload și Param pentru indicii de apel. Descrie sugestii; nu implementează acele funcții.

Numele fișierului importat selectează resursa de limbaj. Păstrează numele python.xml și selectează Python la testare. Schimbarea doar a AutoComplete language nu este suficientă pentru a ținti alt limbaj. Păstrează dicționarul existent înainte de a importa un înlocuitor.

<?xml version="1.0" encoding="UTF-8"?>
<NotepadPlus>
  <AutoComplete language="python">
    <Environment ignoreCase="no" startFunc="(" stopFunc=")" paramSeparator="," />
    <KeyWord name="save_note" func="yes">
      <Overload retVal="None" descr="Save a note to the selected path.">
        <Param name="path: str" />
        <Param name="text: str" />
      </Overload>
    </KeyWord>
    <KeyWord name="project_name" />
  </AutoComplete>
</NotepadPlus>

Adaugă reguli pentru lista de funcții

Un parser de funcții folosește expresii regulate pentru a identifica declarații și a extrage nume. Exemplul găsește declarații task în Elite Demo. Importă atât elite-demo-functions.xml, cât și overridemap.xml prin importatorul regulilor de funcții.

Harta de suprascriere asociază numele UDL Elite Demo cu elite-demo-functions.xml. Dacă ai deja o hartă, îmbină asocierea în loc să pierzi celelalte mapări. Testează cu exemplul .edemo și cu un fișier fără declarații.

<?xml version="1.0" encoding="UTF-8"?>
<NotepadPlus>
  <functionList>
    <parser id="elite-demo" displayName="Elite Demo">
      <function mainExpr="(?m)^task\h+\w+">
        <functionName><nameExpr expr="task\h+\K\w+" /></functionName>
      </function>
    </parser>
  </functionList>
</NotepadPlus>

Distribuie macrocomenzi utile

Înregistrează o modificare mică și repetabilă și testeaz-o pe o copie. Dă macrocomenzii un nume descriptiv și gestioneaz-o din bibliotecă. Exporturile native folosesc JSON versionat; exporturile portabile folosesc shortcuts.xml pentru subsetul de acțiuni acceptate.

Păstrează formatul exportat de aplicație. Nu edita manual ID-urile interne și nu presupune că orice acțiune se poate muta între profiluri. Include modul de selecție așteptat, un exemplu de intrare, un exemplu de ieșire și versiunea aplicației. Înregistrările importate care nu pot rula trebuie verificate, nu prezentate ca acceptate.

Publică un catalog UDL

Un catalog propriu este JSON cu schemaVersion 1 și un tablou entries. Fiecare intrare conține un id unic, name, author, url HTTPS pentru XML brut și licența. Un sha256 opțional conține amprenta SHA-256 de 64 de cifre a resursei.

Catalogul descărcabil de pe acest site indică XML-ul real Elite Demo și include suma de control. Pentru a publica propriul catalog, înlocuiește intrarea și URL-ul cu resursa ta, recalculează amprenta după modificări, găzduiește ambele fișiere prin HTTPS, apoi testează previzualizarea și instalarea în aplicație.

{
  "schemaVersion": 1,
  "entries": [
    {
      "id": "elite-demo",
      "name": "Elite Demo",
      "author": "NotePad Elite",
      "url": "https://notepadelite.pages.dev/resources/Elite-Demo.xml",
      "license": "MIT",
      "sha256": "840e13fc62289ec0edf66a525370b30626d400a46e0fb559c4fb9e9c268f6fee"
    }
  ]
}

Distribuie proiecte și sesiuni

Un XML de proiect grupează referințe la fișiere și dosare. Folosește NotepadPlus ca rădăcină și elemente Project, Folder și File cu atribute name. Folosește panoul proiectelor pentru creare, import și export, în loc să te bazezi pe căi absolute private.

Proiectul exportat conține referințe, nu copii ale documentelor. Explică maparea căilor și autorizarea unui dosar pe un dispozitiv nou. Elimină căile personale din sesiunile distribuite, include un dosar de exemplu și nu pune documente private în pachet.

Conectează un server de limbaj

Instrumentele de analiză a codului se pot conecta la un server de limbaj ales de tine prin LSP peste TCP sau TLS. Configurează gazda și portul, autorizează dosarul local al proiectului și mapează URI-ul dacă serverul folosește altă cale. Aplicația nu instalează și nu pornește serverul în locul tău.

Conexiunea poate trimite textul documentului și căile către acel server când soliciți acțiuni de limbaj. Explică configurarea serverului, limbajul acceptat, transportul și practicile de confidențialitate. Folosește indexul local al proiectului când ai nevoie doar de căutarea simbolurilor offline.

Împachetează și distribuie munca ta

Publică o resursă cu un nume clar, README, autor, versiune, licență, versiuni de aplicație acceptate, pași de instalare și un exemplu mic. Include o captură de ecran pentru o temă și intrarea/ieșirea așteptată pentru macrocomenzi sau reguli de parser.

Verifică dacă poți redistribui materialele terților incluse. Elimină căile personale, acreditările și documentele private. Acest site oferă documentație și exemple de pornire, nu o galerie de încărcare: distribuie propriul depozit sau URL de descărcare ori trimite asistenței un e-mail cu legătura resursei.

1. Testează importul, selectează resursa și verifică efectul asupra exemplului furnizat.
2. Testează text cu diacritice și un fișier gol; verifică nume lungi și contrastul luminos/întunecat.
3. Exportă resursa finală din aplicație, documentează limitele și adaugă un istoric al modificărilor.
4. Distribuie URL-ul, licența și tipul resursei, astfel încât ceilalți să știe ce instalează.