Começando

Este guia ajuda você a iniciar o Xingluo para desenvolvimento local e compilações de produção a partir do zero.

Requisitos

Dica: gerencie versões do Node com fnm ou nvm.

Instalação

Após clonar o repositório, instale as dependências:

bash
pnpm install

Após a instalação das dependências, os projetos de referência em references/ são automaticamente excluídos da compilação TypeScript e das builds (veja exclude em tsconfig.json).

Desenvolvimento local

Inicie o servidor de desenvolvimento (padrão http://localhost:4321/):

bash
pnpm dev

No modo de desenvolvimento:

• Rascunhos e postagens programadas são todas visíveis (para pré-visualização); eles são filtrados apenas durante as builds de produção
• Alterações nas coleções de conteúdo acionam recarga automática
• Comportamentos do lado do cliente (alternância de tema, View Transitions, etc.) correspondem à produção

Sincronização de tipos

Após modificar esquemas ou tipos das coleções de conteúdo, execute sync para atualizar .astro/types.d.ts:

bash
pnpm sync

Compilação

A build de produção tem três etapas (veja o script build em package.json):

bash
pnpm build

1. astro check: verificação de tipos TypeScript e modelos Astro; qualquer erro interrompe a build
2. astro build: gera estaticamente todo o site em dist/ (incluindo imagens OG dinâmicas, RSS, sitemap, robots.txt)
3. node scripts/generateSearchIndex.mjs: escaneia dist/ para gerar o índice de busca de texto completo em dist/search/

Nota: O índice de busca é gerado por um script Node após a compilação.

Pré-visualização da compilação

Visualize o resultado da build em dist/ localmente:

bash
pnpm preview

Qualidade do código

Próximos passos

• Leia o Guia de configuração para personalizar informações do site e recursos
• Leia Criação de conteúdo para começar a escrever
• Leia Implantação para publicar seu site