Розробники та творці

Створіть тему

Тема — це документ XML, що містить GlobalStyles і, за бажанням, LexerStyles. Почніть з експортованої теми, якщо вам потрібне повне мовне покриття. Стартер Ocean навмисно малий: він встановлює синю палітру редактора та кілька стилів Python.

Кольори задаються шістьма шістнадцятковими цифрами без #. Глобальні записи WidgetStyle описують поверхню редактора, поля, текстовий курсор, виділення та поточний рядок. Елемент LexerType групує стилі мови; значення styleID належать відповідному лексеру, і їх не можна вивести зі значень іншої мови. fontStyle — бітова маска: 1 — напівжирний, 2 — курсив, 4 — підкреслений; 0 — звичайний стиль.

1. Завантажте Elite-Ocean.xml і збережіть копію перед редагуванням.
2. У налаштуваннях відкрийте «Імпортувати налаштування й теми» → «Імпортувати тему XML». Імпорт активує копію в бібліотеці застосунку; оригінальний файл не змінюється.
3. Відкрийте приклади Python і звичайного тексту. Перевірте текст, виділення, курсор, поля та контраст у світлому й темному оточенні.
4. Відкрийте «Теми» → «Редагувати стилі», удоскональте результат командою «Зберегти копію» та виберіть «Експортувати XML» для поширення.

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

Визначте мову за допомогою UDL

Файл UDL XML описує розширення, групи ключових слів, коментарі, роздільники та стилі. Для докладнішого визначення використовуйте вбудований редактор власних мов; початковий приклад підсвічує лише task, end, true і false у файлах .edemo.

Імпортуйте Elite-Demo.xml як мову користувача та відкрийте elite-demo.edemo. Якщо потрібно, виберіть Elite Demo явно. Розширення відокремлюються пробілами та пишуться без крапки на початку. Експортуйте копію після тестування.

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

Створіть словник автодоповнення

Автозаповнення API XML містить список KeyWord записів. Запис функції може містити елементи Overload і Param для підказок щодо виклику. Він описує пропозиції; він не реалізує ці функції.

Імпортований файл вибирає мовний ресурс. Збережіть приклад під назвою python.xml і виберіть Python під час тестування. Для націлювання на іншу мову недостатньо лише змінити AutoComplete language. Збережіть наявний словник перед імпортом заміни.

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

Додайте правила списку функцій

Синтаксичний аналізатор функцій використовує регулярні вирази для ідентифікації оголошень і вилучення імен. У прикладі знайдено оголошення завдань у Elite Demo. Імпортуйте як elite-demo-functions.xml, так і overridemap.xml за допомогою імпортера правил функції.

Карта перевизначення пов’язує ім’я UDL Elite Demo із elite-demo-functions.xml. Якщо у вас уже є карта заміни, об’єднайте асоціацію, щоб не втрачати інші зіставлення. Перевірте зразок .edemo і файл без декларацій.

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

Поділіться корисними макросами

Запишіть невелику повторювану правку та протестуйте її на копії. Дайте макросу описове ім’я та керуйте ним із бібліотеки макросів. Рідний експорт використовує версії JSON; портативний експорт використовує shortcuts.xml для підмножини підтримуваних дій.

Збережіть формат, експортований програмою. Не редагуйте внутрішні ідентифікатори вручну та не припускайте, що кожна дія може переміщатися між профілями. Включіть очікуваний режим вибору, вхідний зразок, вихідний зразок і версію програми. Імпортовані записи, які не можуть бути запущені, слід переглядати, а не повідомляти про підтримку.

Опублікуйте каталог UDL.

Власний каталог — це JSON з полем schemaVersion зі значенням 1 і масивом entries. Кожен запис містить унікальний id, name, author, HTTPS-адресу вихідного XML у полі url та ліцензію. Необов’язкове поле sha256 містить 64-цифровий хеш SHA-256 ресурсу.

Каталог, який можна завантажити на цьому сайті, вказує на фактичний Elite Demo XML і містить його контрольну суму. Щоб опублікувати власний каталог, замініть запис і URL на свій власний ресурс, перерахуйте дайджест після редагування, розмістіть обидва на HTTPS, а потім протестуйте попередній перегляд каталогу та встановлення в програмі.

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

Поділіться проєктами та сесіями

Проєкт XML групує посилання на файли й папки. Його кореневий елемент — NotepadPlus, а елементи Project, Folder і File мають атрибути name. Створюйте, імпортуйте й експортуйте структуру через панель проєктів, а не покладайтеся на приватні абсолютні шляхи.

Експортований проєкт містить посилання, а не копії документів. Поясніть, як відобразити шляхи та авторизувати папку на новому пристрої. Вилучіть особисті шляхи зі спільних сеансів, додайте папку зразків і не додавайте особисті документи до пакета.

Підключіть мовний сервер

Інструменти аналізу коду можуть підключатися до вибраного мовного сервера за протоколом LSP через TCP або TLS. Укажіть сервер і порт, надайте доступ до локальної папки проєкту та зіставте її URI, якщо сервер використовує інший шлях. Застосунок не встановлює й не запускає сервер замість вас.

Підключення може надсилати текст документа та шляхи до цього сервера, коли ви запитуєте мовні дії. Поясніть налаштування сервера, підтримувану мову, способи транспортування та конфіденційності. Використовуйте індекс локального проєкту, коли вам потрібен лише офлайн-пошук символів.

Упакуйте та поділіться своєю роботою

Опублікуйте чітко названий ресурс із README, автором, версією, ліцензією, підтримуваними версіями програми, кроками встановлення та невеликим прикладом. Додайте знімок екрана для теми та очікуваний вхід/вихід для макросів або правил аналізатора.

Переконайтеся, що маєте право поширювати всі включені матеріали сторонніх авторів. Видаліть особисті шляхи, облікові дані та приватні документи. Цей сайт пропонує документацію й початкові ресурси для завантаження, а не галерею користувацьких завантажень: поділіться власним репозиторієм або URL для завантаження чи надішліть посилання на ресурс до підтримки електронною поштою.

1. Перевірте імпорт, виберіть ресурс і перевірте його вплив на наданий зразок.
2. Тест з акцентованим текстом і порожнім файлом; перевірте довгі назви та контраст світло/темно.
3. Експортуйте остаточний ресурс із програми, задокументуйте будь-які обмеження та додайте журнал змін.
4. Поділіться URL, ліцензією та типом ресурсу, щоб інші користувачі знали, що вони встановлюють.