Pré-visualização Local para Autores de Conteúdo

Pré-visualize seus documentos localmente antes de enviar as alterações. Tudo o que você precisa é do Docker e de um diretório docs/.

Pré-requisitos

• Docker Desktop instalado e em execução
• Seu repositório de conteúdo clonado localmente com um diretório docs/ contendo pelo menos index.mdx

Iniciar o Servidor de Desenvolvimento

A partir da raiz do seu repositório de conteúdo, execute:

docker run --rm -it \
  -v "$(pwd)/docs:/content/docs" \
  -p 4321:4321 \
  -e MODE=dev \
  ghcr.io/f5-sales-demo/docs-builder:latest

Abra http://localhost:4321 assim que o servidor iniciar.

Nota

Alterações de arquivos no seu host requerem a reinicialização do container. Pare-o com Ctrl+C e execute o comando novamente para capturar as edições.

Imagens e Recursos Estáticos

Coloque as imagens em um subdiretório como docs/images/. O container detecta esses arquivos automaticamente — nenhuma montagem de volume extra é necessária.

Referencie-os no seu MDX com um caminho relativo à raiz:

![Diagrama de arquitetura](/images/architecture.png)

Solução de Problemas

Porta já em uso — Mapeie para uma porta diferente no host: -p 8080:4321, e então abra http://localhost:8080.

Conteúdo não aparece — Verifique se docs/index.mdx existe. Confira a saída do container para uma mensagem ERROR: No content found.

Imagem desatualizada — Baixe a versão mais recente:

docker pull ghcr.io/f5-sales-demo/docs-builder:latest

Leitura Adicional

• Docker Build — Detalhes da imagem, variáveis de ambiente e builds de produção
• Arquitetura — Modelo de injeção de conteúdo e design do sistema de temas