Referência de configuração: página inicial
Consulte título, apresentação, recentes, avisos, terminal de telas largas e passagem ao navegar.
Nesta página
Voltar ao índice da referência. Este artigo descreve os campos realmente usados na página inicial, sem alterar o tema nem tratar configurações pessoais do demo como padrões.
Substitua <locale> por um código habilitado no projeto. Os exemplos usam pt-br e só alteram português brasileiro; não mudam inglês nem habilitam idiomas automaticamente. Mescle os trechos no defineThemeConfig existente de src/site.config.ts e preserve os demais campos de theme, i18n e site.
1. Título principal, apresentação e metadescrição
i18n.locales.<locale>.site.homeTitle
- Tipo:
stringopcional. - Padrão do tema: não definido. Idiomas internos não têm homeTitle específico; usam o nome global, My Blog por padrão.
- Efeito: título principal visível da página inicial.
- Estado e limites: condicional. Procura títulos não vazios após trim no idioma atual e seus fallbacks, usando o nome global se nenhum servir.
''ou espaços não ocultam o título. Não altera o nome global no título do navegador, navegação, rodapé, RSS ou SEO.
i18n.locales.<locale>.site.hero
- Tipo:
stringopcional. - Padrão do tema: cada idioma interno tem sua apresentação. Em chinês simplificado: “在这里写一段站点简介,并告诉读者你将发布什么类型的内容。”; em inglês: “Write a short introduction for your site and what readers can expect from your posts.”. Outros idiomas usam seus valores internos.
- Efeito: apresentação visível abaixo do título principal.
- Estado e limites: condicional. Procura valores definidos na cadeia.
''limpa explicitamente e interrompe o fallback. É texto, sem interpretar Markdown/HTML nem alterar a metadescrição.
i18n.locales.<locale>.messages.siteDescription
- Tipo: substituição opcional
string. - Padrão do tema: texto interno do idioma atual. Chinês simplificado: “电影感网页界面与 AI 时代工程实践文章。”; inglês: “Cinematic web interfaces and AI-era engineering essays.”.
- Efeito: descrição enviada ao head da página inicial, não a apresentação visível.
- Estado e limites: condicional. Resolve mensagens e fallbacks primeiro; só um resultado vazio usa a description global. String vazia não desliga todas as descrições. Espaços não são convertidos automaticamente por trim em ausência de descrição.
Os três campos têm funções distintas e podem ser configurados juntos:
i18n: {
locales: {
'pt-br': {
site: {
homeTitle: 'Meu jardim digital',
hero: 'Anotações sobre desenvolvimento, leituras e vida cotidiana.',
},
messages: { siteDescription: 'Projetos e anotações pessoais.' },
},
},
},
Campos globais relacionados: site.title e site.description
Aqui tratamos apenas da relação com a página inicial: site.title é o último fallback sem homeTitle válido, e site.description é o recurso quando a metadescrição localizada está vazia. Não são campos exclusivos da página inicial. Tipos, padrões, variáveis de ambiente e exemplos completos estão na referência de identidade do site.
2. Quantidade de artigos recentes
theme.homeLatestCount
- Tipo:
number. - Padrão do tema:
3. - Efeito: pega os primeiros N artigos do idioma atual ordenados por pubDate decrescente. Se houver menos, mostra apenas os disponíveis. A contagem ao lado é quantidade real/total do idioma.
- Estado e limites: em uso. Atualmente usa slice diretamente, sem validação específica de inteiro positivo. Use inteiros positivos razoáveis, sem negativos, frações, NaN ou Infinity.
0cria uma lista vazia e mostra o aviso de ausência de artigos mesmo que existam; não oculta a área inteira. - Independência: não muda a quantidade por página do Blog List nem a prévia fixa de até três Fragments.
theme: { homeLatestCount: 5 },
Título, data e resumo vêm do conteúdo do artigo, não de subcampos desta opção. Não há preenchimento automático com artigos de outros idiomas para completar a quantidade.
3. Avisos iniciais e estado inferior
Os três campos abaixo são boolean, padrão true, e estão em uso. false oculta só a parte correspondente; omitir preserva o padrão.
| Caminho completo | Efeito | Limites |
|---|---|---|
theme.home.showInitialize |
Trecho inicial Initialize/done. | Controla só esse trecho, não o corpo nem o carregamento do fundo. |
theme.home.showFollow |
Aviso Wake Up/Follow The White Rabbit. | Independente do trecho anterior; não é requisito para navegar. |
theme.home.showTrace |
Área PIRATE SIGNAL/TRACE PROGRAM inferior. | Não controla o terminal de telas largas; os textos são decorativos, sem rastreamento ou estado real de rede. |
theme: {
home: {
showInitialize: false,
showFollow: true,
showTrace: false,
},
},
Desligar as duas primeiras opções remove seus componentes de texto inicial. Não há campos site.config para trocar essas frases fixas, os estados inferiores ou seus tempos; não invente nomes como startupText ou traceText.
4. Textos da interface inicial
Os campos ficam em i18n.locales.<locale>.messages.home e são substituições opcionais string. Campos comuns seguem o fallback de interface. A tabela lista padrões reais em chinês simplificado e inglês; outros idiomas internos têm seus textos.
| Campo final do caminho | Padrão em chinês simplificado / inglês | Efeito e limites |
|---|---|---|
latest |
最新 / Latest | Título da área de recentes; não muda a ordem ou a quantidade. |
viewAll |
全部 / All | Texto do acesso ao arquivo de artigos, também usado na descrição acessível do arquivo de Fragments; não muda o destino. |
noPosts |
该语言暂时没有文章。 / No posts available in this language yet. | Mensagem quando latestPosts está vazio; não controla rascunhos ou publicação. |
openDoor |
开门 / Open door | Nome acessível da fechadura do terminal e rótulo da prévia; normalmente não é um título permanentemente visível. |
São condicionais: a região correspondente precisa existir. Strings vazias limpam o texto, mas não removem contêineres nem desligam recursos; também podem deixar botões sem um nome acessível útil. Use as opções de recurso para controlar a exibição.
i18n: {
locales: {
'pt-br': {
messages: {
home: {
latest: 'Artigos recentes',
viewAll: 'Todos os artigos',
noPosts: 'Ainda não há artigos.',
openDoor: 'Abrir prévia do corredor',
},
},
},
},
},
i18n.locales.<locale>.messages.home.transmission
- Tipo: substituição opcional
string. - Padrão do tema:
'Knock, knock.', compartilhado sem personalização inclusive pelo chinês. - Efeito: texto selecionável e rolável no terminal de telas largas.
- Estado e limites: condicional. O terminal aparece a partir de 1440px de largura. A ordem própria é configuração pessoal atual → pessoal inglesa → frase padrão, não a cadeia completa de mensagens.
''limpa o texto, sem ocultar o terminal ou desligar o corredor.
Por exemplo, para uma mensagem em português brasileiro:
i18n: {
locales: {
'pt-br': { messages: { home: { transmission: 'Deixe uma pequena pista aqui.' } } },
},
},
Preencher o mesmo campo em pt-br altera apenas português brasileiro. Trocar o texto não consulta sinal de rede real nem muda a fechadura que abre o corredor.
i18n.locales.<locale>.messages.home.hero
- Tipo: substituição opcional
string. - Padrão do tema: apresentação interna do idioma, com os mesmos valores de site.hero mostrados acima para chinês e inglês.
- Efeito: alternativa usada apenas quando getSiteHero não encontra valor definido no idioma atual nem em seus fallbacks.
- Estado e limites: condicional, não obsoleto. Todos os idiomas internos já têm site.hero, então alterar só este campo geralmente não muda a página. Definir site.hero como
''também não ativa a alternativa. Normalmente, edite site.hero diretamente.
i18n: {
locales: {
'pt-br': { messages: { home: { hero: 'Apresentação usada quando site.hero não tem um valor disponível.' } } },
},
},
O exemplo mostra caminho e tipo, sem ultrapassar a prioridade de site.hero. Não apague padrões nem altere dependências para editar a apresentação inicial.
5. Passagem Matrix ao clicar em artigos
theme.effects.enableHomePassage
- Tipo:
boolean. - Padrão do tema:
false. - Efeito: em cliques comuns nos títulos de recentes e entradas de blog marcadas da navegação inicial, executa a passagem Matrix antes de navegar. A sequência normal dura cerca de 8 segundos e tem navegação alternativa após conclusão ou falha.
- Estado e limites: condicional, exige JavaScript. Redução de movimento, teclas modificadoras, botões que não sejam o esquerdo, downloads, links externos ou de nova janela preservam a ação nativa. Não atrasa o corpo inicial nem controla Oracle de About ou a prévia do terminal largo.
theme: { effects: { enableHomePassage: true } },
Quando desligado, os links navegam diretamente. Essa opção booleana não configura duração, cores ou destino; não acrescente homePassageDuration ou outros campos não publicados.
6. Opções compartilhadas usadas na página inicial
Estes campos não são exclusivos do início. A tabela explica a relação; suas definições completas ficam nos módulos principais.
| Caminho completo | Uso na página inicial | Referência principal |
|---|---|---|
theme.fragments.enabled |
Mostra o avatar se há Fragments no idioma atual e também controla a lista completa; no máximo três na prévia. | Opção Fragments |
i18n.locales.<locale>.messages.blog.allPosts |
Descrição acessível da contagem de recentes e do link do arquivo. | Textos compartilhados da lista |
i18n.locales.<locale>.messages.fragments.title |
Nome acessível do avatar, sem título ao lado dele. | Textos de Fragments |
i18n.locales.<locale>.messages.fragments.close |
Nome acessível do botão de fechar a prévia, sem mudar o ícone. | Textos de Fragments |
Se habilitou sem aparecer avatar, confira conteúdo no idioma atual. Não copie IDs existentes só para mostrar o avatar. Imagens, código e alturas estão na referência de Fragments, e a publicação em publicar um Fragment.
7. Configurações iniciais ainda não disponíveis
messages.siteTitle não muda a página inicial padrão nem o nome global. Não o use no lugar de homeTitle ou site.title. Tipo, padrão e exemplo estão em campo de título sem uso atual.
Densidade/cor da chuva de código, botão espelhado, avatar, quantidade de Fragments, frases iniciais e duração da passagem não têm campos site.config próprios. São implementação de layout, estilo ou script. Acrescentar um nome num exemplo TypeScript não cria o recurso. Reduced Motion afeta a exibição, mas não é uma opção nova desta referência.
A relação entre / e as páginas de idioma é controlada por i18n.defaultLocale e i18n.routing.defaultLocalePrefix; veja idiomas e endereços. Navegação pública, rodapé, música e estatísticas também não são opções exclusivas do início.
Como conferir as alterações?
Abra a página inicial do idioma em dev e confirme se alterou título, apresentação, metadescrição ou nome acessível. Confira o terminal com largura mínima de 1440px; metadescrição está no head, e nomes de botões são verificados pelo nome acessível ou title, não apenas pelo texto grande na tela.
Reinicie dev após mudanças de variáveis de ambiente. Reconstrua e publique o site real. Antes de publicar, pare dev, execute npm run doctor e depois npm run preview; doctor já inclui build, sem repetir check/build imediatamente. Veja instalação e publicação.