Desarrolladores y creadores

Crea un tema

Un tema es un documento XML con GlobalStyles y, opcionalmente, LexerStyles. Parte de un tema exportado si necesitas una cobertura amplia de lenguajes. El ejemplo Ocean es pequeño a propósito: define una paleta azul para el editor y algunos estilos de Python.

Los colores se escriben con seis dígitos hexadecimales y sin #. Las entradas WidgetStyle globales describen el fondo, el margen, el cursor, la selección y la línea actual. LexerType agrupa estilos de un lenguaje; los valores styleID pertenecen a ese analizador y no deben deducirse a partir de otro lenguaje. fontStyle es una máscara: 1 negrita, 2 cursiva, 4 subrayado; 0 es normal.

1. Descarga Elite-Ocean.xml y conserva una copia antes de editarlo.
2. En Ajustes, abre Importar ajustes y temas → Importar tema XML. Se activa una copia en la biblioteca de la app; el archivo original no cambia.
3. Abre ejemplos de Python y texto plano. Revisa el texto, la selección, el cursor, los márgenes y el contraste con entornos claros y oscuros.
4. Abre Temas → Editar estilos, usa Guardar copia para ajustar el resultado y Exportar XML para 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>

Define un lenguaje con UDL

Un archivo UDL XML describe extensiones, grupos de palabras clave, comentarios, delimitadores y estilos. Usa el editor de lenguajes personalizados para una definición más completa; este ejemplo solo resalta task, end, true y false en archivos .edemo.

Importa Elite-Demo.xml como lenguaje personalizado y abre elite-demo.edemo. Si hace falta, selecciona Elite Demo manualmente. Las extensiones se separan con espacios y se escriben sin el punto inicial. Exporta una copia después de probarlo.

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

Crea un diccionario de autocompletado

El XML de API de autocompletado enumera entradas KeyWord. Una función puede incluir elementos Overload y Param para mostrar información de la llamada. El archivo describe sugerencias; no implementa esas funciones.

El nombre del archivo importado selecciona el recurso del lenguaje. Conserva el nombre python.xml y elige Python al probarlo. Cambiar solo AutoComplete language no basta para asociarlo a otro lenguaje. Conserva tu diccionario actual antes de importar un reemplazo.

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

Añade reglas a la lista de funciones

Un analizador de funciones usa expresiones regulares para localizar declaraciones y extraer sus nombres. El ejemplo encuentra declaraciones task de Elite Demo. Importa elite-demo-functions.xml y overridemap.xml desde el importador de reglas de funciones.

El mapa asocia el nombre UDL Elite Demo con elite-demo-functions.xml. Si ya tienes un mapa, combina la asociación con las existentes para no perder otras vinculaciones. Pruébalo con el ejemplo .edemo y con un archivo sin declaraciones.

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

Comparte macros útiles

Graba una edición breve y repetible y pruébala con una copia. Ponle un nombre descriptivo y gestiónala desde la biblioteca de macros. La exportación nativa usa JSON versionado; la portable usa shortcuts.xml para el subconjunto de acciones compatibles.

Conserva el formato exportado por la app. No edites a mano identificadores internos ni supongas que todas las acciones pueden trasladarse entre perfiles. Incluye el modo de selección esperado, un ejemplo de entrada y salida y la versión de la app. Revisa las acciones importadas no ejecutables antes de anunciarlas como compatibles.

Publica un catálogo UDL

Un catálogo personalizado es JSON con schemaVersion 1 y una lista entries. Cada entrada incluye un id único, name, author, url HTTPS al XML sin procesar y license. El campo opcional sha256 contiene los 64 dígitos hexadecimales del SHA-256 del recurso.

El catálogo descargable de esta web apunta al XML real de Elite Demo e incluye su suma de verificación. Para publicar el tuyo, cambia la entrada y la URL por las de tu recurso, recalcula el resumen después de editar el XML, aloja ambos con HTTPS y prueba la previsualización e instalación en la 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"
    }
  ]
}

Comparte proyectos y sesiones

Un proyecto XML agrupa referencias a archivos y carpetas. Usa NotepadPlus como raíz y elementos Project, Folder y File con atributos name. Utiliza el panel de proyectos para crear, importar y exportar la estructura, evitando depender de rutas absolutas privadas.

El proyecto exportado contiene referencias, no copias de los documentos. Explica cómo vincular las rutas y autorizar una carpeta en otro dispositivo. Elimina rutas personales de las sesiones compartidas, incluye una carpeta de ejemplo y deja fuera los documentos privados.

Conecta un servidor de lenguaje

Las herramientas de código pueden conectarse al servidor de lenguaje que elijas mediante LSP sobre TCP o TLS. Configura el servidor y el puerto, autoriza la carpeta local del proyecto y vincula su URI si el servidor utiliza una ruta distinta. La app no instala ni inicia el servidor por ti.

La conexión puede enviar el texto y las rutas de documentos a ese servidor cuando solicitas acciones de lenguaje. Documenta la instalación del servidor, el lenguaje compatible, el transporte y sus prácticas de privacidad. Usa el índice local si solo necesitas buscar símbolos sin conexión.

Prepara y comparte tu recurso

Publica un recurso con nombre claro y un README, autoría, versión, licencia, versiones de app compatibles, instrucciones de instalación y un ejemplo pequeño. Añade una captura si es un tema y ejemplos de entrada y salida si es una macro o regla de análisis.

Comprueba que puedes redistribuir el material de terceros que incluyas. Elimina rutas personales, credenciales y documentos privados. Esta web ofrece documentación y ejemplos descargables, no una galería con subida de archivos: comparte tu repositorio o enlace de descarga, o envía el enlace del recurso por correo a soporte.

1. Prueba la importación, selecciona el recurso y comprueba su efecto sobre el ejemplo incluido.
2. Prueba texto con tildes y un archivo vacío; revisa los nombres largos y el contraste claro y oscuro.
3. Exporta el recurso final desde la app, documenta sus límites y añade un historial de cambios.
4. Comparte el enlace, la licencia y el tipo de recurso para que otras personas sepan qué instalan.