Entwickler und Kreative

Ein Design erstellen

Ein Design ist ein XML-Dokument mit GlobalStyles und optional LexerStyles. Beginne mit einem exportierten Design, wenn du eine vollständige Sprachabdeckung benötigst. Die Ocean-Vorlage ist bewusst klein: Sie legt eine blaue Editorpalette und einige Python-Stile fest.

Farben bestehen aus sechs hexadezimalen Ziffern ohne #. Globale WidgetStyle-Einträge beschreiben Editorfläche, Rand, Cursor, Auswahl und aktuelle Zeile. Ein LexerType gruppiert Sprachstile; styleID-Werte gehören zum jeweiligen Lexer und lassen sich nicht von einer anderen Sprache ableiten. fontStyle ist eine Bitmaske: 1 fett, 2 kursiv, 4 unterstrichen; 0 ist normal.

1. Lade Elite-Ocean.xml herunter und bewahre vor Änderungen eine Kopie auf.
2. Öffne in den Einstellungen Einstellungen und Designs importieren → Design-XML importieren. Der Import aktiviert eine Kopie in der App-Bibliothek; die Originaldatei bleibt unverändert.
3. Öffne Python- und Klartextbeispiele. Prüfe Text, Auswahl, Cursor, Ränder und Kontrast in heller und dunkler Umgebung.
4. Öffne Designs → Stile bearbeiten, verfeinere das Ergebnis mit Kopie sichern und verteile es anschließend über XML exportieren.

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

Eine Sprache mit UDL definieren

Eine UDL-XML-Datei beschreibt Erweiterungen, Schlüsselwortgruppen, Kommentare, Begrenzer und Stile. Verwende für eine umfangreichere Definition den integrierten Editor für benutzerdefinierte Sprachen; die Vorlage hebt nur task, end, true und false in .edemo-Dateien hervor.

Importiere Elite-Demo.xml als benutzerdefinierte Sprache und öffne elite-demo.edemo. Wähle bei Bedarf ausdrücklich Elite Demo. Erweiterungen werden durch Leerzeichen getrennt und ohne führenden Punkt angegeben. Exportiere nach dem Test eine Kopie.

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

Ein Autovervollständigungswörterbuch erstellen

Autovervollständigungs-API-XML listet KeyWord-Einträge auf. Ein Funktionseintrag kann Overload- und Param-Elemente für Aufrufhinweise enthalten. Er beschreibt Vorschläge und implementiert diese Funktionen nicht.

Der importierte Dateiname wählt die Sprachressource aus. Behalte für das Beispiel den Namen python.xml bei und wähle beim Testen Python. Nur AutoComplete language zu ändern reicht nicht aus, um eine andere Sprache anzusprechen. Bewahre dein bisheriges Wörterbuch auf, bevor du einen Ersatz importierst.

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

Regeln für Funktionslisten hinzufügen

Ein Funktionsparser erkennt mit regulären Ausdrücken Deklarationen und extrahiert Namen. Das Beispiel findet task-Deklarationen in Elite Demo. Importiere elite-demo-functions.xml und overridemap.xml über den Import für Funktionsregeln.

Die Override-Zuordnung verknüpft den UDL-Namen Elite Demo mit elite-demo-functions.xml. Wenn du bereits eine Override-Tabelle hast, füge die Zuordnung hinzu, statt andere Zuordnungen zu verlieren. Teste mit dem .edemo-Beispiel und einer Datei ohne Deklarationen.

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

Nützliche Makros teilen

Zeichne eine kleine wiederholbare Änderung auf und teste sie an einer Kopie. Gib dem Makro einen aussagekräftigen Namen und verwalte es in der Makrobibliothek. Native Exporte nutzen versioniertes JSON; portable Exporte verwenden shortcuts.xml für die unterstützte Teilmenge der Aktionen.

Behalte das von der App exportierte Format bei. Bearbeite interne IDs nicht von Hand und gehe nicht davon aus, dass jede Aktion zwischen Profilen übertragbar ist. Nenne den erwarteten Auswahlmodus, Eingabe- und Ausgabebeispiele und die App-Version. Nicht ausführbare importierte Einträge sollten geprüft und nicht als unterstützt beworben werden.

Einen UDL-Katalog veröffentlichen

Ein eigener Katalog ist JSON mit schemaVersion 1 und einem entries-Array. Jeder Eintrag enthält eine eindeutige id, name, author, eine HTTPS-url zum XML-Rohtext und eine Lizenz. Ein optionales sha256 enthält den 64-stelligen SHA-256-Prüfwert der Ressource.

Der herunterladbare Katalog auf dieser Website verweist auf das tatsächliche Elite Demo XML und enthält dessen Prüfsumme. Ersetze zum Veröffentlichen deines eigenen Katalogs Eintrag und URL durch deine Ressource, berechne nach Änderungen den Prüfwert neu, hoste beides über HTTPS und teste Vorschau und Installation des Katalogs in der 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"
    }
  ]
}

Projekte und Sitzungen teilen

Projekt-XML gruppiert Verweise auf Dateien und Ordner. Die Wurzel heißt NotepadPlus; Project-, Folder- und File-Elemente besitzen name-Attribute. Erstelle, importiere und exportiere die Struktur über das Projektpanel, statt dich auf private absolute Pfade zu verlassen.

Das exportierte Projekt enthält Verweise, keine Dokumentkopien. Erkläre, wie Pfade zugeordnet werden und ein Ordner auf einem neuen Gerät autorisiert wird. Entferne persönliche Pfade aus geteilten Sitzungen, lege einen Beispielordner bei und halte private Dokumente aus dem Paket heraus.

Einen Sprachserver verbinden

Die Codeanalyse kann über LSP mit TCP oder TLS eine Verbindung zu einem von dir gewählten Sprachserver aufbauen. Konfiguriere Host und Port, autorisiere den lokalen Projektordner und ordne dessen URI zu, falls der Server einen anderen Pfad nutzt. Die App installiert oder startet den Server nicht für dich.

Die Verbindung kann Dokumenttext und Pfade an den Server senden, wenn du Sprachaktionen anforderst. Beschreibe Einrichtung, unterstützte Sprache, Transport und Datenschutzpraxis des Servers. Verwende den lokalen Projektindex, wenn du nur eine Offline-Symbolsuche benötigst.

Deine Arbeit zusammenstellen und teilen

Veröffentliche eine klar benannte Ressource mit README, Autor, Version, Lizenz, unterstützten App-Versionen, Installationsschritten und einem kleinen Beispiel. Füge bei Designs ein Bildschirmfoto und bei Makros oder Parserregeln die erwarteten Ein- und Ausgaben bei.

Prüfe, ob du enthaltenes Material Dritter weitergeben darfst. Entferne persönliche Pfade, Zugangsdaten und private Dokumente. Diese Website bietet Dokumentation und Starterdownloads, keine Upload-Galerie: Teile dein eigenes Repository oder eine Download-URL oder sende den Ressourcenlink per E-Mail an den Support.

1. Teste den Import, wähle die Ressource aus und prüfe ihre Wirkung am mitgelieferten Beispiel.
2. Teste Text mit Akzenten und eine leere Datei; prüfe lange Namen und den Kontrast in heller und dunkler Darstellung.
3. Exportiere die fertige Ressource aus der App, dokumentiere mögliche Grenzen und füge einen Änderungsverlauf hinzu.
4. Teile URL, Lizenz und Ressourcentyp, damit andere wissen, was sie installieren.