Développeurs et créateurs

Créer un thème

Un thème est un document XML contenant GlobalStyles et, éventuellement, LexerStyles. Partez d’un thème exporté si vous avez besoin d’une couverture complète des langages. Le modèle Ocean est volontairement simple : une palette bleue pour l’éditeur et quelques styles Python.

Les couleurs utilisent six chiffres hexadécimaux sans #. Les entrées globales WidgetStyle décrivent la surface de l’éditeur, la marge, le curseur, la sélection et la ligne courante. Un LexerType regroupe les styles d’un langage ; les valeurs styleID appartiennent à cet analyseur lexical et ne peuvent pas être déduites d’un autre langage. fontStyle est un masque de bits : 1 gras, 2 italique, 4 souligné ; 0 correspond au style normal.

1. Téléchargez Elite-Ocean.xml et gardez une copie avant de le modifier.
2. Dans Réglages, ouvrez Importer réglages et thèmes → Importer un thème XML. L’import active une copie dans la bibliothèque de l’app ; le fichier d’origine reste inchangé.
3. Ouvrez des exemples Python et de texte brut. Vérifiez le texte, la sélection, le curseur, les marges et le contraste dans des environnements clairs et sombres.
4. Ouvrez Thèmes → Modifier les styles, utilisez Enregistrer une copie pour affiner le résultat, puis Exporter XML pour le distribuer.

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

Définir un langage avec UDL

Un fichier XML UDL décrit les extensions, groupes de mots-clés, commentaires, délimiteurs et styles. Utilisez l’éditeur de langages utilisateur intégré pour une définition plus riche ; le modèle ne colore que task, end, true et false dans les fichiers .edemo.

Importez Elite-Demo.xml comme langage utilisateur et ouvrez elite-demo.edemo. Si nécessaire, sélectionnez explicitement Elite Demo. Les extensions sont séparées par des espaces, sans point initial. Exportez une copie après les tests.

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

Créer un dictionnaire d’autocomplétion

Le XML d’API d’autocomplétion répertorie des entrées KeyWord. Une entrée de fonction peut contenir des éléments Overload et Param pour les indications d’appel. Il décrit des suggestions ; il n’implémente pas les fonctions.

Le nom du fichier importé sélectionne la ressource de langage. Gardez le nom python.xml et sélectionnez Python pendant les tests. Modifier uniquement AutoComplete language ne suffit pas pour cibler un autre langage. Conservez votre dictionnaire existant avant d’importer un remplacement.

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

Ajouter des règles de liste de fonctions

Un analyseur de fonctions utilise des expressions régulières pour identifier les déclarations et extraire leurs noms. L’exemple repère les déclarations task dans Elite Demo. Importez elite-demo-functions.xml et overridemap.xml via l’importateur de règles de fonctions.

La table de remplacement associe le nom UDL Elite Demo à elite-demo-functions.xml. Si vous avez déjà une table de remplacement, fusionnez cette association pour préserver les autres. Testez avec l’exemple .edemo et un fichier sans déclarations.

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

Partager des macros utiles

Enregistrez une petite modification répétable et testez-la sur une copie. Donnez un nom descriptif à la macro et gérez-la depuis la bibliothèque. Les exports natifs utilisent un JSON versionné ; les exports portables utilisent shortcuts.xml pour le sous-ensemble d’actions pris en charge.

Conservez le format exporté par l’app. Ne modifiez pas manuellement les identifiants internes et ne supposez pas que chaque action peut passer d’un profil à l’autre. Précisez le mode de sélection attendu, un exemple d’entrée, un exemple de sortie et la version de l’app. Les enregistrements importés inexécutables doivent être examinés plutôt que présentés comme compatibles.

Publier un catalogue UDL

Un catalogue personnalisé est un JSON avec schemaVersion 1 et un tableau entries. Chaque entrée contient un id unique, name, author, une url HTTPS de XML brut et une licence. Le champ facultatif sha256 contient l’empreinte SHA-256 à 64 chiffres de la ressource.

Le catalogue téléchargeable de ce site pointe vers le véritable XML Elite Demo et inclut sa somme de contrôle. Pour publier votre catalogue, remplacez l’entrée et l’URL par votre ressource, recalculez l’empreinte après toute modification, hébergez les deux en HTTPS, puis testez la prévisualisation et l’installation du catalogue dans l’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"
    }
  ]
}

Partager des projets et des sessions

Un XML de projet regroupe des références à des fichiers et dossiers. Il utilise NotepadPlus comme racine et des éléments Project, Folder et File avec des attributs name. Utilisez le panneau des projets pour créer, importer et exporter la structure plutôt que de dépendre de chemins absolus privés.

Le projet exporté contient des références, pas des copies des documents. Expliquez comment associer les chemins et autoriser un dossier sur un nouvel appareil. Supprimez les chemins personnels des sessions partagées, incluez un dossier d’exemple et laissez les documents privés hors du paquet.

Connecter un serveur de langage

Les outils d’analyse de code peuvent se connecter à un serveur de langage de votre choix via LSP sur TCP ou TLS. Configurez l’hôte et le port, autorisez le dossier local du projet et associez son URI si le serveur utilise un autre chemin. L’app n’installe ni ne lance le serveur à votre place.

La connexion peut envoyer le texte et les chemins des documents au serveur lorsque vous demandez des actions de langage. Expliquez la configuration du serveur, le langage pris en charge, le transport et ses pratiques de confidentialité. Utilisez l’index local du projet pour une simple recherche de symboles hors ligne.

Préparer et partager votre travail

Publiez une ressource au nom clair avec un README, l’auteur, la version, la licence, les versions de l’app prises en charge, les étapes d’installation et un petit exemple. Ajoutez une capture pour un thème et les entrées/sorties attendues pour les macros ou règles d’analyse.

Vérifiez que vous pouvez redistribuer les éléments tiers inclus. Retirez les chemins personnels, identifiants et documents privés. Ce site propose de la documentation et des modèles à télécharger, pas une galerie de dépôts : partagez votre dépôt ou URL de téléchargement, ou envoyez le lien de la ressource à l’assistance.

1. Testez l’import, sélectionnez la ressource et vérifiez son effet sur l’exemple fourni.
2. Testez le texte accentué et un fichier vide ; vérifiez les noms longs et le contraste clair/sombre.
3. Exportez la ressource finale depuis l’app, documentez les limites éventuelles et ajoutez un historique des changements.
4. Partagez l’URL, la licence et le type de ressource pour que les utilisateurs sachent ce qu’ils installent.