Referência de configuração: avisos do terminal e leitor somente leitura

$ publicado 2026-11-13 | | atualizado 2026-11-14
Contexto: Tipos, padrões reais, marcadores, fallback de valores vazios e estado dos textos do terminal, incluindo readerTitle sem uso atual.

Os dezesseis textos do terminal virtual de About, seus marcadores e limites de configuração.


Saída
palavras 1.2k tokens 1.6k

Veja o arquivo de configuração em instalação e informações do site, os textos e ferramentas na referência de About e outros módulos no índice geral.

Nas páginas padrão, About contém o terminal virtual interativo. Estes campos alteram avisos, erros e nomes acessíveis do leitor somente leitura; não executam shell local nem do servidor. O terminal largo da página inicial usa messages.home.transmission, na referência inicial, não este conjunto.

Os dezesseis campos de messages.terminal

O prefixo completo é i18n.locales.<locale>.messages.terminal. Todos são substituições string opcionais, usando as mensagens internas do idioma atual e seu fallback comum por padrão. A tabela mostra apenas os valores reais em chinês simplificado/inglês; exemplos representam o valor do campo. About precisa estar habilitado, o terminal deve inicializar e o comando ou modo correspondente precisa ser acionado.

Campo Padrão em chinês simplificado / inglês Estado, efeito e limites Valor de exemplo
commandInput 终端命令 / Terminal command Condicional: nome acessível da entrada, sem alterar o caminho do prompt nem o título visível. "Entrada do terminal"
hint 输入 help 开始探索。Tab 补全唯一路径,↑/↓ 查看历史命令。 / Type help to explore. Tab completes a unique path; ↑/↓ recalls commands. Condicional: aviso inicial de About; a inicialização também executa pwd virtual. Vazio limpa o aviso, sem fechar o terminal. "Digite help para ver os comandos."
help 只读虚拟文件,不会在服务器执行命令。 / Read-only virtual files. No commands run on a server. Condicional: explicação exibida por help, seguida da ajuda fixa de comandos. Vazio não oculta toda a lista. "Consulte artigos públicos em modo de leitura; comandos do sistema não são executados."
syntax 引号或转义未结束。 / Unclosed quote or escape. Condicional: aspas ou escape não concluídos. Vazio usa a chave syntax. "Aspas ou escape não foram fechados."
usage 用法:{value} / Usage: {value} Condicional: quantidade incorreta de argumentos; {value} recebe o uso do comando. Vazio usa a chave usage. "Uso: {value}"
unknown 不支持此命令:{value} / Command not supported: {value} Condicional: comando não suportado; {value} é seu nome. Trocar o texto não adiciona comandos. "Comando incompatível: {value}"
notFound 文件或目录不存在:{value} / No such file or directory: {value} Condicional: arquivo/diretório virtual ausente; {value} é o caminho, não um status HTTP remoto. "Não encontrado: {value}"
notDirectory 不是目录:{value} / Not a directory: {value} Condicional: destino de cd não é diretório; {value} é o caminho. "Não é um diretório: {value}"
isDirectory 这是目录:{value} / Is a directory: {value} Condicional: destino de cat/vi/vim/view não é arquivo; {value} é o caminho. "O destino não é um arquivo: {value}"
failed 无法读取:{value} / Unable to read: {value} Condicional: falha genérica de leitura; {value} é o caminho, sem anexar detalhes brutos do erro. "Não foi possível ler: {value}"
tooLarge 文件超过阅读大小限制:{value} / File exceeds the reading limit: {value} Condicional: arquivo excede o limite de leitura; {value} é o caminho. Muda só a mensagem, não o limite. "Arquivo muito grande: {value}"
empty (空目录) / (empty directory) Condicional: ls sem entradas; não é uma mensagem para conteúdo vazio de um arquivo. "O diretório está vazio."
loading 正在读取… / Loading… Condicional: aviso na posição de entrada do Canvas enquanto um comando aguarda. Vazio usa …, sem mudar o carregamento. "Lendo…"
readerTitle 文章阅读器 / Article reader Sem uso atual: tipo e texto interno permanecem, mas o leitor usa title ou path do arquivo. Não muda seu título. "Leitor de artigos"
readerHint 只读 · 输入 :q 并回车退出 · Esc 关闭 / Read only · :q + Enter to exit · Esc to close Condicional: instrução do leitor somente leitura; vazio usa :q. O texto não altera atalhos nem comandos de saída. "Somente leitura · :q e Enter para sair · Esc para fechar"
readerCommand 阅读器命令 / Reader command Condicional: nome acessível da entrada do leitor; vazio usa o nome da entrada original do terminal. "Entrada de comandos do leitor"

O marcador {value} e strings vazias

usage, unknown, notFound, notDirectory, isDirectory, failed e tooLarge usam o marcador literal {value}. O script substitui apenas a primeira ocorrência. Preserve uma ocorrência para mostrar comando ou caminho; {path}, {command} e outros nomes não são suportados. O valor é mostrado como texto, sem execução.

Não existe uma regra única de “string vazia desliga o recurso”. Os erros acima e syntax usam o nome da chave quando vazios; loading usa …, readerHint usa :q e readerCommand usa o nome acessível da entrada original. hint, help e empty podem limpar seu texto sem remover o terminal, a ajuda fixa ou o diretório.

readerTitle não é usado atualmente. Mesmo com uma string padrão no pacote de idioma, não controla o título exibido no leitor.

Exemplo mesclável em português brasileiro

Mescle no defineThemeConfig({…}) existente em src/site.config.ts. Preserve outras opções e não crie outro i18n. Alterar apenas português brasileiro não muda os demais idiomas; veja fallback de idiomas.

i18n: {
  locales: {
    'pt-br': {
      messages: {
        terminal: {
          commandInput: 'Entrada do terminal',
          hint: 'Digite help para ver os comandos.',
          help: 'Consulte artigos públicos em modo de leitura; comandos do sistema não são executados.',
          usage: 'Uso: {value}',
          notFound: 'Não encontrado: {value}',
          failed: 'Não foi possível ler: {value}',
          tooLarge: 'Arquivo muito grande: {value}',
          readerHint: 'Somente leitura · :q e Enter para sair · Esc para fechar',
          readerCommand: 'Entrada de comandos do leitor',
        },
      },
    },
  },
},

Que outras configurações o terminal usa?

Configuração Efeito no terminal Referência principal
theme.enableAboutPage boolean, padrão true; desligar remove About padrão e, portanto, seu terminal. Opção About
i18n.locales.<locale>.about.scriptsPath string, padrão /root/bash/scripts; prefixo virtual e diretório inicial, não um caminho de disco do servidor. Ferramentas About
i18n.locales.<locale>.about.sections A apresentação pública participa do about.md virtual; não são mensagens de erro do terminal. Corpo de About
Artigos do idioma atual Entram automaticamente no diretório virtual; JSON de artigo é lido sob demanda, sem registrar cada artigo em site.config. Escrever artigos

sidebar.allScripts e modals.allScripts.title de About alteram só a entrada da ferramenta e o popup de diretório, sem renomear comandos. effects.backgroundLines não substitui o aviso inicial na sessão interativa atual; seu uso de fallback está em efeitos de About.

Capacidades e limites fixos, não campos site.config

  • Os comandos virtuais incluem help, clear, pwd, ls, cd, cat, vi, vim e view. About também conecta open, close, minimize, maximize e restore aos controles de janela. A implementação define a lista: alterar help ou unknown não adiciona comandos de sistema.
  • vi/vim/view abre um leitor somente leitura, não um editor. Digite :q, :q! ou q e Enter para sair; Esc também fecha a leitura. readerHint só altera a instrução, não o comando ou os atalhos.
  • A entrada aceita por padrão até 512 unidades de código JavaScript UTF-16; o histórico guarda até 50 comandos. Arquivos têm limite padrão de leitura de 262.144 unidades, excedido com aviso tooLarge. Há outra proteção para leitura de respostas de rede: não interprete esse número como tamanho de upload permitido.
  • Artigos são lidos sob demanda em JSON de mesma origem. Não é um baixador de URLs arbitrárias nem leitor de diretórios locais. Arquivos virtuais de texto e diretórios podem funcionar sem solicitar rede.
  • Tamanho, cores, fonte, limites de entrada, histórico e leitura são parâmetros internos de componentes ou funções, sem caminhos públicos site.config correspondentes. Não há API key configurada nem conexão SSH, shell real ou IA remota.

Recarregue a configuração de desenvolvimento depois de salvar e reconstrua/publique o site real. Para conferir textos, acione os comandos ou o modo de leitura, em vez de olhar só o título estático; readerTitle especialmente não muda a interface. Volte ao índice geral para outros módulos.