Fabroku Docs
Documentação do Fabroku, publicada em https://docs.fabroku.fabricadesoftware.ifc.edu.br.
Feita com VitePress. Cada página é um arquivo Markdown; o menu lateral fica em .vitepress/config.mts.
Rodar localmente
bash
npm install
npm run dev # http://localhost:5173
npm run build # gera .vitepress/distEscrever
- Uma página por assunto, em pt-BR.
- Comandos e variáveis entre crases (
fabroku deploy,DATABASE_URL). - Caixas de aviso (
::: warning,::: danger) só para perda de dados, segurança ou algo que trava o deploy. - Página nova: crie o
.mdna pasta certa e adicione emsidebarno.vitepress/config.mts.
Deploy
Automático: cada push na main dispara o workflow .github/workflows/deploy.yml, que envia o código para o app fabroku-docs no Fabroku (app3). O static.json faz o Fabroku compilar o site e servir só a pasta .vitepress/dist com Nginx.
Para publicar de novo sem mudar nada: aba Actions → deploy → Run workflow.