Wiki.js — sincronização da documentação
Relacionado: DOCS_SITE.md na raiz. Hierarquia actual em docs/index.md.
Publica a hierarquia Markdown de docs/ num Wiki.js 2.5 (Docker Compose 3.5 + Postgres 14).
Stack
Configuração em infra/wikijs/:
cd infra/wikijs
cp .env.example .env
docker compose -f compose.yaml --env-file .env up -d
UI: http://localhost:3080
Sync
- Crie API key em Administration → API Access
- Defina
WIKIJS_API_KEYeminfra/wikijs/.env - Na raiz do repo:
npm run docs:sync-wikijs
Dry-run:
node scripts/sync-docs-to-wikijs.mjs --dry-run
Relação com MkDocs / GitHub Pages
| Canal | Uso |
|---|---|
| MkDocs Material | Site estático / GitHub Pages (DOCS_SITE.md) |
| Wiki.js | Wiki editável em equipa + sync a partir de docs/ |
A fonte canónica de conteúdo continua a ser a pasta docs/ neste repositório.