Referencia de configuración: terminal

$ publicado 2026-11-13 | | actualizado 2026-11-14
Contexto: Tipos, valores, marcadores y límites de los textos de terminal, incluidos los campos sin uso.

Terminal virtual y lector de solo lectura de About


Salida
palabras 1.1k tokens 1.4k

Consulta el archivo en instalación e identidad y contenido/herramientas en About. Otros módulos están en el índice.

About aloja la terminal virtual interactiva del sitio estándar. Estos campos personalizan avisos, errores y nombres accesibles del lector de solo lectura; no ejecutan una shell local o de servidor. El texto del autor de la terminal ancha de inicio usa messages.home.transmission, documentado en inicio, no este grupo.

Los dieciséis campos messages.terminal

Prefijo completo: i18n.locales.<locale>.messages.terminal. Todos son sustituciones string opcionales; usan los textos integrados y la cadena normal de respaldo. La tabla muestra valores predeterminados en chino simplificado / inglés y ejemplos. Requieren About activo, terminal inicializada y el resultado de comando o modo de lectura correspondiente.

Campo Predeterminado chino simplificado / inglés Estado, función y límites Ejemplo
commandInput 终端命令 / Terminal command Condicional: nombre accesible de entrada; no ruta del prompt ni título visible. "Entrada del terminal"
hint 输入 help 开始探索。Tab 补全唯一路径,↑/↓ 查看历史命令。 / Type help to explore. Tab completes a unique path; ↑/↓ recalls commands. Condicional: aviso inicial. También se ejecuta pwd virtual. Vacío quita el aviso sin desactivar terminal. "Escribe help para ver los comandos."
help 只读虚拟文件,不会在服务器执行命令。 / Read-only virtual files. No commands run on a server. Condicional: explicación en help; después va ayuda fija de comandos. Vacío no quita la lista completa. "Consulta entradas públicas en modo lectura; no ejecuta comandos del sistema."
syntax 引号或转义未结束。 / Unclosed quote or escape. Condicional: comilla/escape sin terminar. Vacío usa la clave syntax. "Comillas o escape sin cerrar."
usage 用法:{value} / Usage: {value} Condicional: número de argumentos incorrecto. {value} es la sintaxis de uso; vacío usa usage. "Uso: {value}"
unknown 不支持此命令:{value} / Command not supported: {value} Condicional: comando no admitido; {value} es el nombre. El texto no añade comandos. "Comando no compatible: {value}"
notFound 文件或目录不存在:{value} / No such file or directory: {value} Condicional: ruta virtual ausente. {value} es la ruta solicitada, no estado HTTP. "No se encontró: {value}"
notDirectory 不是目录:{value} / Not a directory: {value} Condicional: cd apunta a algo que no es directorio; {value} es la ruta. "No es un directorio: {value}"
isDirectory 这是目录:{value} / Is a directory: {value} Condicional: cat/vi/vim/view no apunta a archivo; {value} es la ruta. "El destino no es un archivo: {value}"
failed 无法读取:{value} / Unable to read: {value} Condicional: fallo general de lectura; {value} es la ruta, sin añadir detalles originales automáticamente. "No se pudo leer: {value}"
tooLarge 文件超过阅读大小限制:{value} / File exceeds the reading limit: {value} Condicional: archivo sobre el límite. {value} es la ruta; cambiar texto no aumenta límite. "Archivo demasiado grande: {value}"
empty (空目录) / (empty directory) Condicional: ls sin elementos; no aviso de cuerpo de archivo vacío. "El directorio está vacío."
loading 正在读取… / Loading… Condicional: mensaje en la entrada Canvas mientras hay comando pendiente; vacío usa …, sin cambiar red. "Leyendo…"
readerTitle 文章阅读器 / Article reader Sin uso actual: conserva tipos/textos, pero el lector titula con el archivo o su ruta. No permite sustituirlo. "Lector de entradas"
readerHint 只读 · 输入 :q 并回车退出 · Esc 关闭 / Read only · :q + Enter to exit · Esc to close Condicional: ayuda del lector. Vacío usa :q; no cambia atajos ni comandos de salida. "Solo lectura · :q y Enter para salir · Esc para cerrar"
readerCommand 阅读器命令 / Reader command Condicional: nombre accesible de entrada del lector; vacío usa el nombre de entrada de terminal. "Entrada de comandos del lector"

Marcadores {value} y strings vacías

usage, unknown, notFound, notDirectory, isDirectory, failed y tooLarge usan el marcador literal {value}. Solo se sustituye la primera aparición. Consérvalo una vez para mostrar comando/ruta; {path}/{command} no funcionan. Se muestran como texto, no código ejecutable.

No hay regla universal de string vacía para desactivar funciones. Esos errores y syntax usan sus claves si están vacíos. loading usa …, readerHint :q y readerCommand la etiqueta original. hint/help/empty vacíos quitan su texto sin eliminar terminal, ayuda fija ni directorios.

readerTitle no se consume: no controla título. Que su string siga en los paquetes no demuestra efecto renderizado.

Ejemplo en español para combinar

Combina en defineThemeConfig({…}) de src/site.config.ts, conservando otros ajustes y sin duplicar i18n. Las sustituciones en español no cambian otros idiomas automáticamente; consulta respaldo de idiomas.

i18n: {
  locales: {
    es: {
      messages: {
        terminal: {
          commandInput: 'Entrada del terminal',
          hint: 'Escribe help para ver los comandos.',
          help: 'Consulta entradas públicas en modo lectura; no ejecuta comandos del sistema.',
          usage: 'Uso: {value}',
          notFound: 'No se encontró: {value}',
          failed: 'No se pudo leer: {value}',
          tooLarge: 'Archivo demasiado grande: {value}',
          readerHint: 'Solo lectura · :q y Enter para salir · Esc para cerrar',
          readerCommand: 'Entrada de comandos del lector',
        },
      },
    },
  },
},

Otra configuración utilizada por la terminal

Configuración Relación con terminal Referencia principal
theme.enableAboutPage boolean, true por defecto. Desactivar About estándar elimina también su terminal. Control About
i18n.locales.<locale>.about.scriptsPath string, /root/bash/scripts por defecto. Prefijo/directorio virtual inicial, no almacenamiento del servidor. Herramientas About
i18n.locales.<locale>.about.sections La biografía pública contribuye a about.md virtual, no a errores de comandos. Cuerpo About
Entradas del idioma actual Rellenan el sistema virtual; JSON de artículos bajo demanda, sin registro manual en site.config. Escribir entradas

sidebar.allScripts y modals.allScripts.title de About renombrarán entradas de herramienta/diálogos, no comandos. effects.backgroundLines no sustituye realmente la ayuda inicial interactiva; consulta su estado de solo respaldo en efectos About.

Capacidades y límites fijos, no campos site.config

  • Los comandos virtuales incluyen help, clear, pwd, ls, cd, cat, vi, vim y view. About también maneja open, close, minimize, maximize y restore de ventana. La implementación decide comandos; cambiar help/unknown no añade comandos del sistema.
  • vi/vim/view abren un lector de solo lectura, no editor. Escribe :q, :q! o q y Enter para salir; Esc cierra. readerHint solo cambia ayuda.
  • Entrada limitada por defecto a 512 unidades UTF-16 JavaScript, con 50 comandos de historial. Lectura a 262.144 unidades; exceso muestra tooLarge. Las respuestas de red tienen protección separada de lectura; no es permiso de tamaño de subida.
  • Las entradas cargan bajo demanda desde JSON de misma origen. No descarga URLs arbitrarias ni lee directorios locales. Archivos y directorios virtuales pueden no necesitar red.
  • Fuente, colores y límites de entrada/historial/lectura pueden ser parámetros internos, sin rutas públicas site.config. No hay API key, SSH, shell real ni IA remota.

Recarga la configuración de desarrollo al guardar y recompila/despliega producción. Activa comando/modo de lectura correspondiente para comprobar el texto, no solo un título estático. En especial, readerTitle no cambia nada actualmente. Vuelve al índice.