﻿---
title: "Referência de configuração: avisos do terminal e leitor somente leitura"
description: "Tipos, padrões reais, marcadores, fallback de valores vazios e estado dos textos do terminal, incluindo readerTitle sem uso atual."
url: "https://demo.anglefeint.com/pt-br/blog/config-terminal/"
language: "pt-br"
author: "Anglefeint"
published: "2026-11-13T00:00:00.000Z"
updated: "2026-11-14T00:00:00.000Z"
---

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

Veja o arquivo de configuração em [instalação e informações do site](https://demo.anglefeint.com/pt-br/blog/starter-guide-1-configure-your-site/), os textos e ferramentas na [referência de About](https://demo.anglefeint.com/pt-br/blog/config-about/) e outros módulos no [índice geral](https://demo.anglefeint.com/pt-br/blog/config-reference/).

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](https://demo.anglefeint.com/pt-br/blog/config-home/#home-transmission), 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](https://demo.anglefeint.com/pt-br/blog/config-languages/#fallback).

```ts
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](https://demo.anglefeint.com/pt-br/blog/config-about/#page-enabled) |
| `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](https://demo.anglefeint.com/pt-br/blog/config-about/#tool-fields) |
| `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](https://demo.anglefeint.com/pt-br/blog/config-about/#body-fields) |
| 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](https://demo.anglefeint.com/pt-br/blog/starter-guide-2-languages-and-routing/) |

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](https://demo.anglefeint.com/pt-br/blog/config-about/#effect-fields).

## 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](https://demo.anglefeint.com/pt-br/blog/config-reference/) para outros módulos.
