Sviluppatori e creatori

Creare un tema

Un tema è un documento XML che contiene GlobalStyles e, facoltativamente, LexerStyles. Parti da un tema esportato se vuoi una copertura completa dei linguaggi. Il modello Ocean è volutamente piccolo: imposta una palette blu per l’editor e alcuni stili Python.

I colori usano sei cifre esadecimali senza #. Le voci globali WidgetStyle descrivono superficie dell’editor, margine, cursore, selezione e riga corrente. Un LexerType raggruppa gli stili del linguaggio; i valori styleID appartengono a quel lexer e non possono essere dedotti da un altro linguaggio. fontStyle è una maschera di bit: 1 grassetto, 2 corsivo, 4 sottolineato; 0 è normale.

1. Scarica Elite-Ocean.xml e conserva una copia prima di modificarlo.
2. In Impostazioni, apri Importa impostazioni e temi → Importa tema XML. L’importazione attiva una copia nella biblioteca dell’app; il file originale rimane invariato.
3. Apri esempi Python e di testo semplice. Controlla testo, selezione, cursore, margini e contrasto in ambienti chiari e scuri.
4. Apri Temi → Modifica stili, usa Salva una copia per affinare il risultato, poi Esporta XML per distribuirlo.

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

Definire un linguaggio con UDL

Un file XML UDL descrive estensioni, gruppi di parole chiave, commenti, delimitatori e stili. Usa l’editor dei linguaggi utente integrato per una definizione più ricca; il modello evidenzia solo task, end, true e false nei file .edemo.

Importa Elite-Demo.xml come linguaggio utente e apri elite-demo.edemo. Se necessario, seleziona esplicitamente Elite Demo. Le estensioni sono separate da spazi e non hanno il punto iniziale. Esporta una copia dopo le prove.

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

Creare un dizionario di autocompletamento

Il XML API di autocompletamento elenca voci KeyWord. Una voce di funzione può contenere elementi Overload e Param per i suggerimenti di chiamata. Descrive suggerimenti; non implementa quelle funzioni.

Il nome del file importato seleziona la risorsa del linguaggio. Mantieni il nome python.xml per l’esempio e seleziona Python durante le prove. Cambiare solo AutoComplete language non basta per scegliere un altro linguaggio. Conserva il dizionario esistente prima di importarne uno sostitutivo.

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

Aggiungere regole per l’elenco delle funzioni

Un parser di funzioni usa espressioni regolari per identificare dichiarazioni ed estrarre nomi. L’esempio trova dichiarazioni task in Elite Demo. Importa sia elite-demo-functions.xml sia overridemap.xml tramite l’importatore di regole delle funzioni.

La mappa di override associa il nome UDL Elite Demo a elite-demo-functions.xml. Se hai già una mappa di override, unisci l’associazione per non perdere le altre. Prova con l’esempio .edemo e con un file privo di dichiarazioni.

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

Condividere macro utili

Registra una piccola modifica ripetibile e provala su una copia. Assegna un nome descrittivo alla macro e gestiscila dalla biblioteca. Gli export nativi usano JSON con versione; quelli portabili usano shortcuts.xml per il sottoinsieme di azioni supportate.

Mantieni il formato esportato dall’app. Non modificare manualmente gli ID interni e non presumere che ogni azione possa passare tra profili. Includi modalità di selezione prevista, esempio di input, esempio di output e versione dell’app. Le voci importate non eseguibili vanno esaminate, anziché presentate come supportate.

Pubblicare un catalogo UDL

Un catalogo personalizzato è un JSON con schemaVersion 1 e un array entries. Ogni voce contiene un id univoco, name, author, una url HTTPS al XML grezzo e una licenza. Il campo facoltativo sha256 contiene il digest SHA-256 a 64 cifre della risorsa.

Il catalogo scaricabile su questo sito punta al vero XML Elite Demo e include il checksum. Per pubblicare il tuo catalogo, sostituisci voce e URL con la tua risorsa, ricalcola il digest dopo le modifiche, ospita entrambi su HTTPS e prova anteprima e installazione del catalogo nell’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"
    }
  ]
}

Condividere progetti e sessioni

Un XML di progetto raggruppa riferimenti a file e cartelle. Usa NotepadPlus come radice ed elementi Project, Folder e File con attributi name. Usa il pannello dei progetti per creare, importare ed esportare la struttura anziché affidarti a percorsi assoluti privati.

Il progetto esportato contiene riferimenti, non copie dei documenti. Spiega come associare i percorsi e autorizzare una cartella su un nuovo dispositivo. Elimina i percorsi personali dalle sessioni condivise, includi una cartella di esempio e lascia fuori dal pacchetto i documenti privati.

Collegare un server di linguaggio

Gli strumenti di analisi del codice possono collegarsi a un server di linguaggio scelto da te tramite LSP su TCP o TLS. Configura host e porta, autorizza la cartella locale del progetto e associa il suo URI se il server usa un percorso diverso. L’app non installa né avvia il server al tuo posto.

La connessione può inviare testo e percorsi dei documenti al server quando richiedi azioni di linguaggio. Spiega configurazione del server, linguaggio supportato, trasporto e pratiche di privacy. Usa l’indice locale del progetto se ti serve solo la ricerca offline dei simboli.

Preparare e condividere il tuo lavoro

Pubblica una risorsa dal nome chiaro con README, autore, versione, licenza, versioni dell’app supportate, istruzioni di installazione e un piccolo esempio. Includi una schermata per un tema e input/output attesi per macro o regole del parser.

Verifica di poter ridistribuire il materiale di terzi incluso. Rimuovi percorsi personali, credenziali e documenti privati. Questo sito offre documentazione e risorse iniziali da scaricare, non una galleria di caricamenti: condividi il tuo repository o URL di download, oppure invia il link della risorsa all’assistenza.

1. Prova l’importazione, seleziona la risorsa e verifica il suo effetto sull’esempio fornito.
2. Prova testo accentato e un file vuoto; verifica nomi lunghi e contrasto chiaro/scuro.
3. Esporta la risorsa finale dall’app, documenta eventuali limiti e aggiungi un registro delle modifiche.
4. Condividi URL, licenza e tipo di risorsa, così gli altri sapranno cosa stanno installando.