Utviklere og skapere

Lag et tema

Et tema er et XML dokument som inneholder GlobalStyles og, valgfritt, LexerStyles. Start fra et eksportert tema når du trenger full språkdekning. Ocean-starteren er bevisst liten: den setter en blå redigeringspalett og noen få Python-stiler.

Farger angis med seks heksadesimale sifre uten #. Globale WidgetStyle-oppføringer beskriver editorflaten, margen, tekstmarkøren, markeringen og gjeldende linje. En LexerType samler språkstiler; styleID-verdier tilhører den aktuelle lexeren og kan ikke utledes fra et annet språk. fontStyle er en bitmaske: 1 er fet, 2 er kursiv og 4 er understreket; 0 er normal.

1. Last ned Elite-Ocean.xml og behold en kopi før du redigerer.
2. Åpne Innstillinger → Importer innstillinger og temaer → Importer tema XML. Importen aktiverer en kopi i appbiblioteket; originalfilen forblir uendret.
3. Åpne eksempler med Python og ren tekst. Kontroller tekst, markering, tekstmarkør, marger og kontrast i lyse og mørke omgivelser.
4. Åpne Temaer → Rediger stiler, bruk Lagre en kopi for å finjustere resultatet, og velg deretter Eksporter XML for å 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 språk med UDL

En UDL XML-fil beskriver utvidelser, nøkkelordgrupper, kommentarer, skilletegn og stiler. Bruk den innebygde brukerspråkredigereren for en rikere definisjon; starteren uthever bare task, end, true og false i .edemo-filer.

Importer Elite-Demo.xml som brukerspråk og åpne elite-demo.edemo. Om nødvendig, velg Elite Demo eksplisitt. Utvidelser er mellomromseparert og skrevet uten den innledende prikken. Eksporter en kopi etter testing.

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

Bygg en autofullføringsordbok

En API-ordbok for autofullføring i XML lister KeyWord-oppføringer. En funksjonsoppføring kan inneholde Overload- og Param-elementer for parameterhjelp. Den beskriver forslag; den implementerer ikke funksjonene.

Navnet på den importerte filen bestemmer språkressursen. Behold navnet python.xml på eksemplet og velg Python under testen. Det er ikke nok å bare endre AutoComplete language for å velge et annet språk. Behold den eksisterende ordboken 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>

Legg til funksjonslisteregler

En funksjonsparser bruker regulære uttrykk for å identifisere deklarasjoner og trekke ut navn. Eksemplet finner task-deklarasjoner i Elite Demo. Importer både elite-demo-functions.xml og overridemap.xml gjennom funksjonsregelimportøren.

Overstyringskartet knytter UDL-navnet Elite Demo til elite-demo-functions.xml. Når du allerede har et overstyringskart, slå sammen tilknytningen i stedet for å miste de andre tilordningene dine. Test mot .edemo-eksemplet og en fil uten 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

Ta opp en liten repeterbar redigering og test den på en kopi. Gi makroen et beskrivende navn og administrer den fra makrobiblioteket. Innebygd eksport bruker versjonert JSON; bærbare eksporter bruker shortcuts.xml for det støttede handlingsundersettet.

Behold formatet eksportert av appen. Ikke rediger interne ID-er for hånd eller anta at hver handling kan flytte mellom profiler. Inkluder forventet utvalgsmodus, inngangseksempel, utgangseksempel og appversjon. Importerte poster som ikke kan kjøres, bør gjennomgås i stedet for å annonseres som støttede.

Publiser en UDL-katalog

En tilpasset katalog er JSON med schemaVersion 1 og en entries-matrise. Hver oppføring inneholder en unik id, name, author, HTTPS rå XML url og lisens. En valgfri sha256 inneholder ressursens 64-sifrede SHA-256-sammendrag.

Den nedlastbare katalogen på dette nettstedet peker til den faktiske Elite Demo XML og inkluderer kontrollsummen. For å publisere din egen katalog, bytt ut oppføringen og URL med din egen ressurs, beregn sammendraget på nytt etter redigeringer, vert både over HTTPS, og test deretter katalogforhåndsvisningen og installasjonen 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 prosjekter og økter

En prosjektfil i XML samler referanser til filer og mapper. Den bruker NotepadPlus som rot og elementene Project, Folder og File med name-attributter. Bruk prosjektpanelet til å opprette, importere og eksportere strukturen fremfor å basere den på private absolutte stier.

Det eksporterte prosjektet inneholder referanser, ikke kopier av dokumentene. Forklar hvordan du kartlegger stier og autoriserer en mappe på en ny enhet. Fjern personlige stier fra delte økter, ta med en prøvemappe og hold private dokumenter ute av pakken.

Koble til en språkserver

Kodeintelligens kan koble til en språkserver du velger ved å bruke LSP over TCP eller TLS. Konfigurer verten og porten, autoriser den lokale prosjektmappen og kartlegg dens URI hvis serveren bruker en annen bane. Appen installerer eller starter ikke serveren for deg.

Tilkoblingen kan sende dokumenttekst og stier til den serveren når du ber om språkhandlinger. Forklar serverens oppsett, støttede språk, transport og personvernpraksis. Bruk den lokale prosjektindeksen når du bare trenger offline symboloppslag.

Pakk og del arbeidet ditt

Publiser en tydelig navngitt ressurs med en README, forfatter, versjon, lisens, støttede appversjoner, installasjonstrinn og et lite eksempel. Ta med et skjermbilde for et tema og forventet input/output for makroer eller parserregler.

Kontroller at du har lov til å videredistribuere eventuelt medfølgende tredjepartsmateriale. Fjern personlige stier, innloggingsopplysninger og private dokumenter. Dette nettstedet tilbyr dokumentasjon og startressurser, ikke et opplastingsgalleri: del ditt eget kodearkiv eller en nedlastings-URL, eller send ressurslenken til brukerstøtten på e-post.

1. Test import, velg ressursen og bekreft effekten på den medfølgende prøven.
2. Test med aksenttekst og en tom fil; sjekk lange navn og lys/mørke kontrast.
3. Eksporter den endelige ressursen fra appen, dokumenter eventuelle begrensninger og legg til en endringslogg.
4. Del URL, lisens og ressurstype slik at andre brukere vet hva de installerer.