Construindo uma pré-visualização local
Existem dois scripts de shell disponíveis em cada repositório existente (incluindo o repositório de modelo usado para criar novo conteúdo): build.sh e preview.sh.
Para pré-visualizar, execute o script build.sh; este é o que realmente constrói uma versão local do site (ou, mais precisamente, o subconjunto do site completo que reside em seu repositório atual). Em seguida, execute preview.sh, que inicia um servidor web e serve o site no http://localhost:8080/. Abrir esta URL em qualquer navegador da web mostrará a pré-visualização, que estará disponível até você encerrar o processo (Ctrl+C no terminal).
|
Para executar os scripts, você precisará instalar |
Previewing multiple repositories
If your work spans content in multiple repositories, e.g. because you link to another repository, you can extend the preview by adding more repositories to site.yml as follows:
content:
sources:
- url: .
branches: HEAD
- url: https://pagure.io/fedora-docs/another-repository.git
branches: main
Correct entries to use can be found from docs-fp-o site.yml.
Usando os scripts normais do Antora
Se você deseja usar o fluxo de trabalho regular de construção e pré-visualização do Antora, siga as instruções na Página de documentação do Antora.
Assim que você tiver Antora CLI e Antora Site Generator, você pode construir e pré-visualizar as páginas sem os scripts de contêiner.
Para construir as páginas no diretório do projeto, execute:
antora generate site.ymlIsso criará um novo diretório public que contém todos os arquivos necessários. Navegue até lá e execute um comando do servidor. Talvez você já tenha um servidor Python simples, nesse caso execute:
python3 -m http.serverou se você só tiver Python 2 em sua máquina:
python -m SimpleHTTPServerIsso abre uma pré-visualização local na porta 8000.
Se você tem cargo (o gerenciador de pacotes Rust), você também pode instalar e usar miniserve ou qualquer outro servidor simples de sua escolha para esse assunto.