Manual · 9

Temas e idiomas

Cada color de VCSIDE tiene un nombre y una función, así que un tema puede cambiar todo el programa, o solo una cosa, y se puede compartir como un archivo pequeño.

Los temas incluidos

Ver → Tema cambia entre Oscuro, Claro, Solarized Light y Solarized Dark, además de los tuyos.

VCSIDE con el tema Solarized Light y niveles de sangría sombreados — Solarized Light, con un sombreado por nivel de sangría.

El editor de gráficos con el tema Solarized Dark — Solarized Dark, en el editor de gráficos.

VCSIDE con el tema Oscuro — Oscuro, el tema por defecto.

Los colores del propio 2600, en la paleta del editor de gráficos, nunca cambian con el tema.

Papeles

Cada color es un papel con nombre, en grupos:

Grupo	Qué colorea
`ui.*`	La interfaz: fondo, paneles, texto, botones, bordes, el color de acento...
`editor.*`	El editor de código: fondo, línea actual, selección, números de línea, columna de ciclos, guías de sangría...
`syntax.*`	Instrucciones, opcodes ilegales, directivas, registros, etiquetas, números, cadenas, comentarios...
`messages.*`	Errores, avisos y notas.
`space.*`	Las barras del informe de espacio.
`graphics.*`	La cuadrícula, los fotogramas y el rayado del editor de gráficos.
`dialog.*`	Los diálogos: la banda del título con sus tres franjas, el borde, el botón principal y los demás.
`files.*`	El árbol del proyecto: filas, guías y un color para cada tipo de archivo.

El resto de los colores de la interfaz se calculan a partir de los papeles ui.*, y un tema puede fijar cualquiera de ellos por su nombre.

Editar temas

Ver → Tema → Editar temas... abre una ventana con todos los temas, la paleta, los papeles por grupos con un cuadro de búsqueda, los niveles de sangría y los problemas. Los cambios se ven al momento y se guardan solos en tu carpeta de temas.

La ventana Temas con los temas incluidos, la paleta y los grupos de papeles — La ventana Temas, con la paleta del tema Oscuro.

Los temas incluidos no se pueden cambiar. Nuevo, basado en este crea un tema vacío que lo sigue, y Duplicar hace una copia completa. Los dos piden antes el nombre del tema nuevo.

El archivo de tema

Un tema es un archivo .vcstheme, en JSON. Este es Solarized Dark completo:

{
  "vcstheme": 1,
  "name": "Solarized Dark",
  "base": "solarized-light",
  "palette": {
    "bg": "$base03",
    "bgHi": "$base02",
    "fg": "$base0",
    "fgEm": "$base1",
    "dim": "$base01"
  },
  "colours": {
    "ui.modalDim": "#00000060"
  },
  "indent": [ "$yellow/12", "$green/12", "$red/10", "$blue/10" ]
}

base: El tema del que toma todo lo demás. Un tema basado en otro guarda solo sus diferencias y sigue los cambios de su base.
palette: Colores con nombre.
colours: Los papeles.
indent: Un color para cada nivel de sangría en el editor. Una lista vacía significa sin sombreado.
imgui: Cualquier color suelto de la interfaz, por su nombre.

Un color se puede escribir como:

#RRGGBB o #RRGGBBAA;
$nombre, un color de la paleta;
@papel, el color de otro papel;
cualquiera de ellos seguido de /AA para fijar su alfa, como $blue/40.

Las referencias se resuelven después de combinar las bases, así que cambiar una entrada de la paleta, o ui.accent, cambia todo lo que se refiere a ella. Así es como el Solarized Dark de arriba es Solarized Light con cinco entradas cambiadas. Un problema, como un papel sin color, una referencia que no existe o un bucle, se muestra en magenta y aparece en la lista de la ventana Temas.

Compartir... exporta un tema a un archivo o lo copia como texto; al importar se lee un archivo o se pega un tema. Un tema exportado lleva dentro sus bases, salvo las incluidas, así que quien lo importe solo necesita VCSIDE. Importar nunca pisa un tema: si el nombre ya existe, el nuevo recibe otro.

Idiomas

La interfaz está en inglés y en español; elígelo en el menú Idioma (en el menú de la aplicación en macOS, en Ajustes en el resto). Un idioma es un archivo en data/i18n/, con el texto en inglés como clave. Un archivo puede ser parcial: lo que falte aparece en inglés. Añadir un idioma es añadir un archivo, y un script del código fuente lista lo que le falta a cada uno.