Udviklere og skabere

Opret et tema

Et tema er et XML dokument, der indeholder GlobalStyles og eventuelt LexerStyles. Start fra et eksporteret tema, når du har brug for fuld sprogdækning. Ocean-starteren er bevidst lille: den sætter en blå editor-palet og et par Python-stile.

Farver angives med seks hexadecimale cifre uden #. Globale WidgetStyle-poster beskriver editorens flade, margen, tekstmarkør, markering og aktuelle linje. En LexerType samler sprogets stilarter; styleID-værdier tilhører den pågældende lexer og kan ikke udledes af et andet sprog. fontStyle er en bitmaske: 1 er fed, 2 er kursiv og 4 er understreget; 0 er normal.

1. Download Elite-Ocean.xml, og gem en kopi, før du redigerer.
2. Åbn Indstillinger → Importer indstillinger og temaer → Importer tema XML. Importen aktiverer en kopi i appens bibliotek; originalfilen ændres ikke.
3. Åbn eksempler med Python og ren tekst. Kontrollér tekst, markering, tekstmarkør, margener og kontrast i lyse og mørke omgivelser.
4. Åbn Temaer → Rediger stilarter, tilpas resultatet med Gem en kopi, og vælg derefter Eksporter XML for at dele det.

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

Definer et sprog med UDL

En UDL XML fil beskriver udvidelser, nøgleordsgrupper, kommentarer, skilletegn og typografier. Brug den indbyggede brugersprog-editor for at få en mere detaljeret definition; starteren fremhæver kun task, end, true og false i .edemo filer.

Importer Elite-Demo.xml som et brugersprog og åbn elite-demo.edemo. Vælg om nødvendigt Elite Demo eksplicit. Udvidelser er mellemrumsadskilt og skrevet uden den indledende prik. Eksporter en kopi efter test.

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

Byg en autofuldførelsesordbog

En API-ordbog til autofuldførelse i XML indeholder KeyWord-poster. En funktionspost kan indeholde Overload- og Param-elementer til funktionshjælp. Den beskriver forslag; den implementerer ikke funktionerne.

Filnavnet på den importerede fil bestemmer sprogressourcen. Behold navnet python.xml på eksemplet, og vælg Python under testen. Det er ikke nok blot at ændre AutoComplete language for at vælge et andet sprog. Behold din eksisterende ordbog, før du importerer en erstatning.

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

Tilføj funktionslisteregler

En funktionsparser bruger regulære udtryk til at identificere deklarationer og udtrække navne. Eksemplet finder task-deklarationer i Elite Demo. Importer både elite-demo-functions.xml og overridemap.xml gennem funktionsregelimporteren.

Tilsidesættelseskortet knytter UDL-navnet Elite Demo til elite-demo-functions.xml. Når du allerede har et tilsidesættelseskort, skal du flette foreningen i stedet for at miste dine andre tilknytninger. Test mod prøven .edemo og en fil uden erklæringer.

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

Del nyttige makroer

Optag en lille gentagelig redigering og test den på en kopi. Giv makroen et beskrivende navn og administrer den fra makrobiblioteket. Native eksporter bruger versioneret JSON; bærbare eksporter bruger shortcuts.xml til det understøttede handlingsundersæt.

Behold formatet eksporteret af appen. Rediger ikke interne id'er i hånden eller antag, at enhver handling kan flyttes mellem profiler. Inkluder den forventede valgtilstand, inputprøve, outputprøve og appversion. Importerede poster, der ikke kan køre, bør gennemgås i stedet for at blive annonceret som understøttede.

Udgiv et UDL-katalog

Et brugerdefineret katalog er JSON med schemaVersion 1 og et entries array. Hver post indeholder en unik id, name, author, HTTPS rå XML url og licens. En valgfri sha256 indeholder ressourcens 64-cifrede SHA-256-sammendrag.

Kataloget, der kan downloades på dette websted, peger på det faktiske Elite Demo XML og inkluderer dets kontrolsum. For at udgive dit eget katalog skal du erstatte posten og URL med din egen ressource, genberegne sammendraget efter redigeringer, hoste begge over HTTPS, derefter teste katalogeksemplet og installationen 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"
    }
  ]
}

Del projekter og sessioner

En projektfil i XML samler referencer til filer og mapper. Roden er NotepadPlus, og elementerne Project, Folder og File har name-attributter. Brug projektpanelet til at oprette, importere og eksportere strukturen frem for at basere den på private absolutte stier.

Det eksporterede projekt indeholder referencer, ikke kopier af dokumenterne. Forklar, hvordan man kortlægger stier og autoriserer en mappe på en ny enhed. Fjern personlige stier fra delte sessioner, medtag en prøvemappe, og hold private dokumenter ude af pakken.

Tilslut en sprogserver

Kode intelligens kan oprette forbindelse til en sprogserver, du vælger ved hjælp af LSP over TCP eller TLS. Konfigurer værten og porten, godkend den lokale projektmappe og kortlæg dens URI, hvis serveren bruger en anden sti. Appen installerer eller starter ikke serveren for dig.

Forbindelsen kan sende dokumenttekst og stier til den server, når du anmoder om sproghandlinger. Forklar serverens opsætning, understøttede sprog, transport og privatlivspraksis. Brug det lokale projektindeks, når du kun har brug for offline-symbolopslag.

Pak og del dit arbejde

Udgiv en klart navngivet ressource med en README, forfatter, version, licens, understøttede appversioner, installationstrin og et lille eksempel. Inkluder et skærmbillede til et tema og forventet input/output til makroer eller parserregler.

Kontrollér, at du må videredistribuere eventuelt medfølgende materiale fra tredjeparter. Fjern personlige stier, loginoplysninger og private dokumenter. Denne hjemmeside indeholder dokumentation og startressourcer til download, ikke et galleri til uploads: del dit eget kodearkiv eller downloadlink, eller send ressourcens link til support via e-mail.

1. Test import, vælg ressourcen og bekræft dens effekt på den leverede prøve.
2. Test med tekst med accent og en tom fil; tjek lange navne og lys/mørke kontrast.
3. Eksporter den endelige ressource fra appen, dokumenter eventuelle grænser og tilføj en ændringslog.
4. Del URL, licensen og ressourcetypen, så andre brugere ved, hvad de installerer.