Utvecklare och kreatörer

Skapa ett tema

Ett tema är ett XML-dokument med GlobalStyles och valfritt LexerStyles. Börja med ett exporterat tema när du behöver full språktäckning. Starttemat Ocean är avsiktligt litet: det anger en blå editorpalett och några Python-stilar.

Färger anges med sex hexadecimala siffror utan #. Globala WidgetStyle-poster beskriver editoryta, marginal, markör, markering och aktuell rad. En LexerType grupperar språkstilar; styleID-värden hör till just den lexern och kan inte gissas från ett annat språk. fontStyle är en bitmask: 1 fet, 2 kursiv, 4 understruken; 0 är normal.

1. Hämta Elite-Ocean.xml och behåll en kopia före redigering.
2. I Inställningar öppnar du Importera inställningar och teman → Importera XML-tema. Importen aktiverar en kopia i appbiblioteket; originalfilen lämnas oförändrad.
3. Öppna exempel för Python och vanlig text. Kontrollera text, markering, markör, marginaler och kontrast i ljusa och mörka omgivningar.
4. Öppna Teman → Redigera stilar, använd Spara en kopia för att finjustera och sedan Exportera XML för att distribuera temat.

<?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>

Definiera ett språk med UDL

En UDL XML-fil beskriver filändelser, nyckelordsgrupper, kommentarer, avgränsare och stilar. Använd den inbyggda editorn för användarspråk för en mer fullständig definition; startfilen markerar bara task, end, true och false i .edemo-filer.

Importera Elite-Demo.xml som ett användarspråk och öppna elite-demo.edemo. Välj Elite Demo uttryckligen om det behövs. Filändelser avgränsas med blanksteg och skrivs utan inledande punkt. Exportera en kopia efter testning.

<?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>

Skapa en ordlista för automatisk komplettering

XML för automatisk API-komplettering listar KeyWord-poster. En funktionspost kan innehålla Overload- och Param-element för anropshjälp. Den beskriver förslag; den implementerar inte funktionerna.

Det importerade filnamnet väljer språkresursen. Behåll namnet python.xml och välj Python när du testar. Att bara ändra AutoComplete language räcker inte för att rikta resursen till ett annat språk. Behåll din befintliga ordlista innan du importerar en ersättare.

<?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>

Lägg till regler för funktionslistor

En funktionsparser använder reguljära uttryck för att identifiera deklarationer och extrahera namn. Exemplet hittar task-deklarationer i Elite Demo. Importera både elite-demo-functions.xml och overridemap.xml med importören för funktionsregler.

Åsidosättningskartan kopplar UDL-namnet Elite Demo till elite-demo-functions.xml. Om du redan har en sådan karta slår du ihop associationen i stället för att förlora andra kopplingar. Testa med .edemo-exemplet och en fil utan deklarationer.

<?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>

Dela användbara makron

Spela in en liten upprepningsbar ändring och testa den på en kopia. Ge makrot ett beskrivande namn och hantera det i makrobiblioteket. Nativa exporter använder versionshanterad JSON; portabla exporter använder shortcuts.xml för den delmängd av åtgärder som stöds.

Behåll formatet som appen exporterar. Ändra inte interna ID:n manuellt och anta inte att varje åtgärd kan flyttas mellan profiler. Inkludera förväntat markeringsläge, exempel på indata och utdata samt appversion. Importerade poster som inte kan köras bör granskas i stället för att beskrivas som stödda.

Publicera en UDL-katalog

En egen katalog är JSON med schemaVersion 1 och en entries-array. Varje post innehåller ett unikt id, name, author, en HTTPS-url till rå XML och en licens. Ett valfritt sha256 innehåller resursens 64-siffriga SHA-256-summa.

Den hämtningsbara katalogen på webbplatsen pekar på den faktiska XML-filen för Elite Demo och innehåller dess kontrollsumma. För en egen katalog ersätter du posten och URL:en med din resurs, räknar om summan efter ändringar, publicerar båda över HTTPS och testar sedan förhandsvisning och installation i appen.

{
  "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"
    }
  ]
}

Dela projekt och sessioner

Projekt-XML grupperar referenser till filer och mappar. Det använder NotepadPlus som rot och Project-, Folder- och File-element med name-attribut. Skapa, importera och exportera strukturen i projektpanelen i stället för att förlita dig på privata absoluta sökvägar.

Det exporterade projektet innehåller referenser, inte kopior av dokumenten. Förklara hur sökvägar mappas och en mapp godkänns på en ny enhet. Ta bort personliga sökvägar från delade sessioner, inkludera en exempelmapp och håll privata dokument utanför paketet.

Anslut en språkserver

Kodanalysverktygen kan ansluta till en språkserver du väljer med LSP över TCP eller TLS. Ange värd och port, godkänn den lokala projektmappen och mappa dess URI om servern använder en annan sökväg. Appen installerar eller startar inte servern åt dig.

Anslutningen kan skicka dokumenttext och sökvägar till servern när du begär språkåtgärder. Förklara serverinställningar, språkstöd, transport och integritetspraxis. Använd det lokala projektindexet när du bara behöver söka efter symboler offline.

Paketera och dela ditt arbete

Publicera en tydligt namngiven resurs med README, upphovsperson, version, licens, appversioner som stöds, installationssteg och ett litet exempel. Ta med en skärmbild för ett tema och förväntad indata/utdata för makron eller parserregler.

Kontrollera att du får distribuera material från tredje part som ingår. Ta bort personliga sökvägar, inloggningsuppgifter och privata dokument. Webbplatsen är dokumentation och startfiler, inget uppladdningsgalleri: dela ditt eget arkiv eller en hämtnings-URL, eller mejla resurslänken till supporten.

1. Testa import, välj resursen och kontrollera effekten på det medföljande exemplet.
2. Testa med accenttecken och en tom fil; kontrollera långa namn och kontrast i ljust och mörkt läge.
3. Exportera den slutliga resursen från appen, dokumentera eventuella begränsningar och lägg till en ändringslogg.
4. Dela URL, licens och resurstyp så att andra vet vad de installerar.