Vývojáři a tvůrci

Vytvoř motiv

Motiv je XML dokument obsahující GlobalStyles a volitelně LexerStyles. Pokud potřebuješ plné pokrytí jazyků, začni exportovaným motivem. Startovací Ocean je záměrně malý: nastaví modrou paletu editoru a několik stylů Pythonu.

Barvy používají šest hexadecimálních číslic bez #. Globální položky WidgetStyle popisují plochu editoru, okraj, kurzor, výběr a aktuální řádek. LexerType seskupuje jazykové styly; hodnoty styleID patří k danému lexeru a nelze je odhadovat z jiného jazyka. fontStyle je bitová maska: 1 tučné, 2 kurzíva, 4 podtržené; 0 je normální.

1. Stáhni Elite-Ocean.xml a před úpravami si ponech kopii.
2. V Nastavení otevři Import nastavení a motivů → Import motivu XML. Import aktivuje kopii v knihovně aplikace; původní soubor zůstane beze změn.
3. Otevři ukázky Pythonu a prostého textu. Zkontroluj text, výběr, kurzor, okraje a kontrast ve světlém i tmavém prostředí.
4. Otevři Motivy → Upravit styly, použij Uložit kopii k doladění a poté Export XML ke sdílení.

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

Definuj jazyk pomocí UDL

Soubor UDL XML popisuje přípony, skupiny klíčových slov, komentáře, oddělovače a styly. Pro bohatší definici použij vestavěný editor uživatelských jazyků; příklad pouze zvýrazňuje task, end, true a false v souborech .edemo.

Importuj Elite-Demo.xml jako uživatelský jazyk a otevři elite-demo.edemo. Podle potřeby výslovně vyber Elite Demo. Přípony se oddělují mezerami a zapisují bez úvodní tečky. Po testování exportuj kopii.

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

Vytvoř slovník automatického doplňování

XML API automatického doplňování uvádí položky KeyWord. Položka funkce může obsahovat prvky Overload a Param pro nápovědu k volání. Popisuje návrhy; tyto funkce neimplementuje.

Název importovaného souboru vybírá jazykový zdroj. Ponech příkladu název python.xml a při testování vyber Python. Změna samotného AutoComplete language nestačí k přiřazení jinému jazyku. Před importem náhrady si ponech existující slovník.

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

Přidej pravidla seznamu funkcí

Parser funkcí pomocí regulárních výrazů rozpoznává deklarace a získává názvy. Příklad najde deklarace task v Elite Demo. Importuj elite-demo-functions.xml i overridemap.xml pomocí importéru pravidel funkcí.

Mapa přepsání přiřazuje název UDL Elite Demo k elite-demo-functions.xml. Pokud už mapu máš, sluč přiřazení, abys nepřišel o ostatní mapování. Testuj s příkladem .edemo i se souborem bez deklarací.

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

Sdílej užitečná makra

Nahraj malou opakovatelnou úpravu a vyzkoušej ji na kopii. Dej makru výstižný název a spravuj ho z knihovny maker. Nativní exporty používají verzovaný JSON; přenositelné exporty používají shortcuts.xml pro podporovanou podmnožinu akcí.

Zachovej formát exportovaný aplikací. Neupravuj ručně interní identifikátory ani nepředpokládej, že lze každou akci přenášet mezi profily. Přilož očekávaný režim výběru, ukázkový vstup, ukázkový výstup a verzi aplikace. Importované záznamy, které nelze spustit, je potřeba prověřit, nikoli označovat za podporované.

Publikuj katalog UDL

Vlastní katalog je JSON se schemaVersion 1 a polem entries. Každá položka obsahuje jedinečné id, name, author, HTTPS url surového XML a licenci. Volitelné sha256 obsahuje 64místný otisk SHA-256 zdroje.

Katalog ke stažení na tomto webu odkazuje na skutečné XML Elite Demo a obsahuje jeho kontrolní součet. Pro vlastní katalog nahraď položku a URL svým zdrojem, po úpravách přepočítej otisk, oba soubory hostuj přes HTTPS a pak otestuj náhled katalogu a instalaci v aplikaci.

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

Sdílej projekty a relace

Projektové XML seskupuje odkazy na soubory a složky. Používá kořen NotepadPlus a prvky Project, Folder a File s atributy name. Strukturu vytvářej, importuj a exportuj z panelu projektů místo spoléhání na soukromé absolutní cesty.

Exportovaný projekt obsahuje odkazy, ne kopie dokumentů. Vysvětli mapování cest a povolení složky v novém zařízení. Ze sdílených relací odstraň osobní cesty, přilož ukázkovou složku a soukromé dokumenty nech mimo balíček.

Připoj jazykový server

Nástroje pro analýzu kódu se mohou připojit k vybranému jazykovému serveru pomocí LSP přes TCP nebo TLS. Nastav hostitele a port, povol místní projektovou složku a mapuj její URI, pokud server používá jinou cestu. Aplikace server za tebe neinstaluje ani nespouští.

Připojení může tomuto serveru odesílat text dokumentu a cesty, když si vyžádáš jazykové akce. Vysvětli nastavení serveru, podporovaný jazyk, přenos a postupy ochrany soukromí. Když potřebuješ jen vyhledávání symbolů bez sítě, použij místní index projektu.

Zabal a sdílej svou práci

Publikuj jasně pojmenovaný zdroj s README, autorem, verzí, licencí, podporovanými verzemi aplikace, instalačním postupem a malým příkladem. K motivu přidej snímek obrazovky, k makrům nebo pravidlům parseru očekávaný vstup a výstup.

Ověř, že smíš šířit přiložené materiály třetích stran. Odstraň osobní cesty, přihlašovací údaje a soukromé dokumenty. Tento web nabízí dokumentaci a startovací soubory, ne galerii pro nahrávání: sdílej vlastní repozitář nebo URL ke stažení, případně pošli odkaz na zdroj podpoře e-mailem.

1. Otestuj import, vyber zdroj a ověř jeho účinek na dodané ukázce.
2. Testuj text s diakritikou a prázdný soubor; zkontroluj dlouhé názvy a kontrast světlého a tmavého vzhledu.
3. Exportuj finální zdroj z aplikace, popiš případná omezení a přidej přehled změn.
4. Sdílej URL, licenci a typ zdroje, aby ostatní věděli, co instalují.