Ontwikkelaars en makers

Een thema maken

Een thema is een XML-document met GlobalStyles en eventueel LexerStyles. Begin met een geëxporteerd thema als je volledige taalondersteuning nodig hebt. Het Ocean-startvoorbeeld is bewust klein: het stelt een blauw editorpalet en enkele Python-stijlen in.

Kleuren gebruiken zes hexadecimale cijfers zonder #. Algemene WidgetStyle-vermeldingen beschrijven het editoroppervlak, de marge, cursor, selectie en huidige regel. Een LexerType groepeert taalstijlen; styleID-waarden horen bij die lexer en kunnen niet uit een andere taal worden afgeleid. fontStyle is een bitmasker: 1 vet, 2 cursief, 4 onderstreept; 0 is normaal.

1. Download Elite-Ocean.xml en houd een kopie voordat je wijzigingen maakt.
2. Open in Instellingen Instellingen en thema’s importeren → Thema-XML importeren. De import activeert een kopie in de appbibliotheek; het oorspronkelijke bestand blijft ongewijzigd.
3. Open voorbeelden met Python en gewone tekst. Controleer tekst, selectie, cursor, marges en contrast in lichte en donkere omgevingen.
4. Open Thema’s → Stijlen bewerken, verfijn het resultaat met Bewaar een kopie en gebruik daarna Exporteer XML om het te verspreiden.

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

Een taal definiëren met UDL

Een UDL-XML-bestand beschrijft extensies, trefwoordgroepen, opmerkingen, scheidingstekens en stijlen. Gebruik voor een uitgebreidere definitie de ingebouwde editor voor gebruikerstalen; het startvoorbeeld markeert alleen task, end, true en false in .edemo-bestanden.

Importeer Elite-Demo.xml als gebruikerstaal en open elite-demo.edemo. Kies indien nodig expliciet Elite Demo. Extensies zijn gescheiden door spaties en worden zonder punt ervoor geschreven. Exporteer een kopie na het testen.

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

Een woordenboek voor automatische aanvulling maken

Autocompletion-API-XML bevat KeyWord-vermeldingen. Een functievermelding kan Overload- en Param-elementen bevatten voor aanroephints. Het beschrijft suggesties; het implementeert die functies niet.

De geïmporteerde bestandsnaam kiest het taalmateriaal. Laat het voorbeeld python.xml heten en kies Python tijdens het testen. Alleen AutoComplete language wijzigen is niet genoeg om een andere taal te kiezen. Bewaar je bestaande woordenboek voordat je een vervanging importeert.

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

Regels voor functielijsten toevoegen

Een functieparser gebruikt reguliere expressies om declaraties te herkennen en namen te extraheren. Het voorbeeld vindt task-declaraties in Elite Demo. Importeer zowel elite-demo-functions.xml als overridemap.xml via de importfunctie voor functieregels.

De overridekoppeling verbindt de UDL-naam Elite Demo aan elite-demo-functions.xml. Als je al een overridetabel hebt, voeg de koppeling samen om je andere koppelingen te behouden. Test met het .edemo-voorbeeld en een bestand zonder declaraties.

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

Nuttige macro’s delen

Neem een kleine herhaalbare bewerking op en test die op een kopie. Geef de macro een beschrijvende naam en beheer deze in de macrobibliotheek. Eigen exports gebruiken JSON met een versie; overdraagbare exports gebruiken shortcuts.xml voor het ondersteunde deel van de acties.

Behoud het formaat dat de app exporteert. Bewerk interne ID’s niet met de hand en neem niet aan dat elke actie tussen profielen overdraagbaar is. Vermeld de verwachte selectiemodus, invoervoorbeeld, uitvoervoorbeeld en appversie. Geïmporteerde vermeldingen die niet kunnen worden uitgevoerd moeten worden nagekeken en niet als ondersteund worden aangeprezen.

Een UDL-catalogus publiceren

Een eigen catalogus is JSON met schemaVersion 1 en een entries-array. Elke vermelding bevat een unieke id, name, author, een HTTPS-url voor ruwe XML en een licentie. Een optionele sha256 bevat de 64-cijferige SHA-256-vingerafdruk van het materiaal.

De downloadbare catalogus op deze site verwijst naar de echte Elite Demo XML en bevat de controlesom. Vervang voor je eigen catalogus de vermelding en URL door je eigen materiaal, bereken de vingerafdruk opnieuw na wijzigingen, host beide via HTTPS en test het voorbeeld en de installatie van de catalogus in de app.

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

Projecten en sessies delen

Project-XML groepeert verwijzingen naar bestanden en mappen. Het gebruikt NotepadPlus als hoofdelement en Project-, Folder- en File-elementen met name-attributen. Gebruik het projectpaneel om de structuur te maken, importeren en exporteren in plaats van op private absolute paden te vertrouwen.

Het geëxporteerde project bevat verwijzingen, geen kopieën van de documenten. Leg uit hoe paden worden gekoppeld en hoe een map op een nieuw apparaat wordt geautoriseerd. Verwijder persoonlijke paden uit gedeelde sessies, voeg een voorbeeldmap toe en houd privédocumenten buiten het pakket.

Een taalserver verbinden

De codeanalyse kan met een taalserver van jouw keuze verbinden via LSP over TCP of TLS. Stel host en poort in, autoriseer de lokale projectmap en koppel de URI als de server een ander pad gebruikt. De app installeert of start de server niet voor je.

De verbinding kan documenttekst en paden naar die server sturen wanneer je taalacties aanvraagt. Leg de serverconfiguratie, ondersteunde taal, het transport en het privacybeleid uit. Gebruik de lokale projectindex als je alleen offline symbolen wilt zoeken.

Je werk verpakken en delen

Publiceer duidelijk benoemd materiaal met een README, auteur, versie, licentie, ondersteunde appversies, installatiestappen en een klein voorbeeld. Voeg voor een thema een schermafbeelding toe en voor macro’s of parserregels de verwachte invoer en uitvoer.

Controleer of je meegeleverd materiaal van derden mag verspreiden. Verwijder persoonlijke paden, inloggegevens en privédocumenten. Deze website bevat documentatie en startdownloads, geen uploadgalerij: deel je eigen repository of download-URL, of mail de koppeling naar het materiaal aan ondersteuning.

1. Test het importeren, kies het materiaal en controleer de werking op het meegeleverde voorbeeld.
2. Test tekst met accenten en een leeg bestand; controleer lange namen en licht/donkercontrast.
3. Exporteer het uiteindelijke materiaal uit de app, documenteer eventuele beperkingen en voeg een wijzigingslog toe.
4. Deel de URL, licentie en het materiaaltype zodat anderen weten wat zij installeren.