Pular para o conteúdo principal

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

  1. Crie API key em Administration → API Access
  2. Defina WIKIJS_API_KEY em infra/wikijs/.env
  3. 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

CanalUso
MkDocs MaterialSite estático / GitHub Pages (DOCS_SITE.md)
Wiki.jsWiki 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.