Alojar docs.diasantos.com

Esta documentação é gerada com MkDocs (tema Material). O resultado estático fica em documentation/site/ depois de mkdocs build. Com i18n, o inglês está na raiz / e o português em /pt/ no mesmo site/ — o root no nginx continua a ser documentation/site.

Mesmo servidor que a app

Disposição típica:

Caminho	Função
Clone app	p.ex. /var/www/coaching — Next.js + pm2
Build docs	p.ex. /var/www/coaching/documentation/site — root nginx

Build após git pull

Manualmente ou via script / CI:

cd /var/www/coaching/documentation
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
mkdocs build

Nginx

Usa o exemplo completo (HTTP→HTTPS, caminhos TLS, cache opcional de assets) em Nginx — app Coaching e documentação e copia o modelo documentation/examples/nginx/docs.diasantos.com.conf.example no servidor.

Obtém certificados com certbot (ou o teu fluxo ACME) para docs.diasantos.com.

Opcional: deploy separado

Podes fazer rsync apenas de documentation/site/ para um host estático ou CDN se não quiseres servir a documentação no mesmo servidor da aplicação.

Deploy administrativo (MkDocs)

A página Deploy que faz git pull e next build também executa documentation/build-from-deploy.sh (pip install … --break-system-packages, depois mkdocs build). Vê Permissões do utilizador (deploy) para o que o utilizador Unix coaching tem de poder fazer.