Kehittäjät ja tekijät

Luo teema

Teema on XML-dokumentti, joka sisältää GlobalStyles-osion ja valinnaisesti LexerStyles-osion. Aloita viedystä teemasta, kun tarvitset kattavat tyylit kaikille kielille. Ocean-aloitusesimerkki on tarkoituksella pieni: se määrittää editorille sinisen väripaletin ja muutamia Python-tyylejä.

Värit ilmaistaan kuudella heksadesimaalinumerolla ilman #-merkkiä. Yleiset WidgetStyle-merkinnät kuvaavat editorin pintaa, marginaalia, tekstikohdistinta, valintaa ja nykyistä riviä. LexerType ryhmittelee kielen tyylit; styleID-arvot kuuluvat kyseiselle lekserille, eikä niitä voi päätellä toisen kielen arvoista. fontStyle on bittimaski: 1 on lihavointi, 2 kursivointi ja 4 alleviivaus; 0 tarkoittaa tavallista tyyliä.

1. Lataa Elite-Ocean.xml ja säilytä kopio ennen muokkaamista.
2. Avaa Asetukset → Tuo asetukset ja teemat → Tuo XML-teema. Tuonti ottaa käyttöön kopion sovelluksen kirjastossa; alkuperäinen tiedosto pysyy muuttumattomana.
3. Avaa Python-esimerkkejä ja tavallisia tekstitiedostoja. Tarkista teksti, valinta, tekstikohdistin, marginaalit ja kontrasti vaaleassa ja tummassa ympäristössä.
4. Avaa Teemat → Muokkaa tyylejä, viimeistele tulos Tallenna kopio -toiminnolla ja jaa se sitten Vie XML -toiminnolla.

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

Määritä kieli UDL:llä

UDL-määritys XML-muodossa kuvaa tiedostopäätteitä, avainsanaryhmiä, kommentteja, erottimia ja tyylejä. Käytä sovelluksen omien kielten editoria monipuolisempaan määritykseen; aloitusesimerkki korostaa vain sanat task, end, true ja false .edemo-tiedostoissa.

Tuo Elite-Demo.xml omaksi kieleksi ja avaa elite-demo.edemo. Valitse tarvittaessa nimenomaan Elite Demo. Tiedostopäätteet erotetaan välilyönneillä ja kirjoitetaan ilman alkupistettä. Vie kopio testauksen jälkeen.

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

Luo automaattisesti täydentävä sanakirja

Automaattisen täydennyksen API-sanakirja XML-muodossa luettelee KeyWord-merkintöjä. Funktiomerkintä voi sisältää Overload- ja Param-elementtejä kutsuvihjeitä varten. Se kuvaa ehdotuksia; se ei toteuta näitä funktioita.

Tuodun tiedoston nimi määrittää kieliresurssin. Säilytä esimerkin nimi python.xml ja valitse Python testauksen ajaksi. Pelkän AutoComplete language -attribuutin muuttaminen ei riitä toisen kielen valitsemiseen. Säilytä nykyinen sanakirjasi ennen korvaavan sanakirjan tuontia.

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

Lisää funktioluettelosäännöt

Funktiojäsentäjä tunnistaa määrittelyt ja poimii nimet säännöllisillä lausekkeilla. Esimerkki löytää task-määrittelyt Elite Demo -kielestä. Tuo sekä elite-demo-functions.xml että overridemap.xml funktiosääntöjen tuontitoiminnolla.

Ohitusmääritys liittää UDL-nimen Elite Demo tiedostoon elite-demo-functions.xml. Jos sinulla on jo ohitusmääritys, yhdistä uusi liitos siihen, jotta muut liitokset säilyvät. Testaa .edemo-esimerkillä sekä tiedostolla, jossa ei ole määrittelyjä.

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

Jaa hyödyllisiä makroja

Tallenna pieni, toistettava muokkaus ja testaa sitä kopiolla. Anna makrolle kuvaava nimi ja hallitse sitä makrokirjastossa. Sovelluksen oma vienti käyttää versioitua JSON-muotoa; siirrettävä vienti käyttää shortcuts.xml-tiedostoa tuetulle toimintojen osajoukolle.

Säilytä sovelluksen viemä muoto. Älä muokkaa sisäisiä tunnuksia käsin äläkä oleta, että kaikki toiminnot siirtyvät profiilien välillä. Liitä mukaan odotettu valintatila, syöte- ja tulosesimerkit sekä sovellusversio. Tuodut tietueet, joita ei voi suorittaa, on tarkistettava; niitä ei pidä esitellä tuettuina.

Julkaise UDL-luettelo

Oma luettelo on JSON-tiedosto, jossa on schemaVersion-arvo 1 ja entries-taulukko. Jokainen merkintä sisältää yksilöllisen id-tunnuksen, name-nimen, author-tekijän, XML-raakatiedoston HTTPS-osoitteen url-kentässä sekä lisenssin. Valinnainen sha256 sisältää resurssin 64-numeroisen SHA-256-tiivisteen.

Tältä sivustolta ladattava luettelo viittaa todelliseen Elite Demo -määritykseen XML-muodossa ja sisältää sen tarkistussumman. Jos julkaiset oman luettelon, korvaa merkintä ja URL omalla resurssillasi, laske tiiviste uudelleen muokkausten jälkeen ja julkaise molemmat HTTPS-yhteydellä. Testaa sitten luettelon esikatselu ja asennus sovelluksessa.

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

Jaa projekteja ja istuntoja

Projektin XML-tiedosto ryhmittelee viittaukset tiedostoihin ja kansioihin. Sen juurielementti on NotepadPlus, ja elementit Project, Folder ja File käyttävät name-attribuutteja. Luo, tuo ja vie rakenne projektipaneelissa sen sijaan, että käyttäisit yksityisiä absoluuttisia polkuja.

Viety projekti sisältää viittaukset, ei dokumenttien kopioita. Kerro, miten polut yhdistetään ja kansiolle annetaan käyttöoikeus uudella laitteella. Poista henkilökohtaiset polut jaetuista istunnoista, liitä esimerkkikansio mukaan ja jätä yksityiset dokumentit pois paketista.

Yhdistä kielipalvelin

Koodityökalut voivat muodostaa yhteyden valitsemaasi kielipalvelimeen LSP-protokollalla TCP- tai TLS-yhteyden yli. Määritä palvelin ja portti, anna käyttöoikeus paikalliseen projektikansioon ja yhdistä sen URI, jos palvelin käyttää eri polkua. Sovellus ei asenna tai käynnistä palvelinta puolestasi.

Yhteys voi lähettää dokumentin tekstin ja polut palvelimelle, kun pyydät kielitoimintoja. Kerro palvelimen asetuksista, tuetusta kielestä, siirtotavasta ja tietosuojakäytännöistä. Käytä paikallista projekti-indeksiä, kun tarvitset vain paikallisen symbolihaun ilman verkkoyhteyttä.

Pakkaa ja jaa työsi

Julkaise selkeästi nimetty resurssi ja liitä mukaan README, tekijä, versio, lisenssi, tuetut sovellusversiot, asennusohjeet ja pieni esimerkki. Lisää teemalle kuvakaappaus sekä makroille tai jäsennyssäännöille odotetut syöte- ja tulosesimerkit.

Varmista, että saat jakaa mukana tulevaa kolmannen osapuolen aineistoa edelleen. Poista henkilökohtaiset polut, tunnistetiedot ja yksityiset dokumentit. Tämä sivusto tarjoaa dokumentaatiota ja ladattavia aloitusresursseja, ei käyttäjien latausgalleriaa: jaa oma lähdekoodivarastosi tai lataus-URL tai lähetä resurssilinkki sähköpostitse tukeen.

1. Testaa tuonti, valitse resurssi ja tarkista sen vaikutus mukana tulevaan esimerkkiin.
2. Testaa aksenttimerkkejä sisältävällä tekstillä ja tyhjällä tiedostolla; tarkista pitkät nimet sekä vaalea ja tumma kontrasti.
3. Vie lopullinen resurssi sovelluksesta, dokumentoi mahdolliset rajat ja lisää muutosloki.
4. Jaa URL, lisenssi ja resurssityyppi, jotta muut käyttäjät tietävät, mitä he asentavat.