Alojar docs.diasantos.com

Esta documentação é gerada com MkDocs (tema Material). O resultado estático fica em apps/docs/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 apps/docs/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/apps/docs/site — root nginx

Build após git pull

Manualmente ou via script / CI:

cd /var/www/coaching/apps/docs
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 apps/docs/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 apps/docs/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 npm run build --workspace @coach-studio/web também executa apps/docs/build-from-deploy.sh. Esse script cria/actualiza apps/docs/.venv e depois corre mkdocs build. Vê Permissões do utilizador (deploy) para o que o utilizador Unix coaching tem de poder fazer.