Wiki-Yan (wiki.yanbraga.com)

Resumo

Wiki pública do DM Yan em wiki.yanbraga.com, gerada pelo Quartz a partir do vault Obsidian (Obsidian). É a vitrine para jogadores: cenários, guias e perfis de NPCs player-safe. Todo o prep do Mestre (aventuras, encontros, segredos, sessões) fica fora da publicação.

Por que é relevante para Yan

• Ponto público que os jogadores consultam (cenários Lhodos/Thylea, guias, personagens).
• Exige disciplina de segredos: a publicação é por padrão “tudo que não for bloqueado” — o que não deve sair precisa ser explicitamente ocultado.
• Feedbacks da rotina de divulgação: páginas de campanha e badges dependem do que está (ou não) publicado.

Como funciona

• Repo local: C:\Users\Yanbd\dev\Wiki-Yan (branch v4; remoto GitLab YBraga35/Wiki-Yan).
• Conteúdo em content/ (vault Obsidian) + configuração do Quartz na raiz.
• Deploy: VM Oracle (hostname foundry) → docker compose build && up -d --force-recreate quartz-wiki; conteúdo enviado via tar-pipe/scp (Syncthing da VM nem sempre confiável).
• Acesso: Cloudflare Tunnel apontando para o container.

Política de conteúdo (público vs. privado)

• Público: índices, RPG/Guias, cenários publicáveis (2-Thylea/Personagens-Jogadores/, Lhodos), área Dev - Computação (notas de tecnologia/projetos).
• Privado (prep do Mestre): RPG/1-Aventuras, RPG/1-DM Toolkit, RPG/3-Sessions, RPG/2-Thylea/Personagens (notas de DM), 2-Thylea/Encontros, Raiders of the Serpent Sea, .claude.
• Mecanismos: ignorePatterns no quartz.config.ts + draft: true (RemoveDrafts) + plugin custom RemoveSecrets (callouts [!secret]/[!dm]/[!private]).
• Guia operacional completo: RPG/1-DM Toolkit/Guia Secrets da Wiki.md.

Relações no vault

• Quartz — engine de geração do site.
• [Obsidian] — fonte do conteúdo (vault).
• Obsidian Syncthing — sincronização de conteúdo (com riscos de conflito).
• Hermes Obsidian Knowledge Capture — gera/atualiza notas do vault a partir de conversas (sujeitas à mesma política de secrets).

Limitações e cuidados

• Deploy manual: o push no GitLab não dispara rebuild do site.
• Build local no Windows quebra em alias inválido de nota antiga — buildar na VM.
• Verificação de publicação sempre por conteúdo do HTML (SPA fallback devolve HTTP 200 para rotas inexistentes).

Questões em aberto

• Automação do deploy (CI/script único após push).
• Migração completa para Quartz v5.

Fontes

• Site: https://wiki.yanbraga.com (Confirmado — verificação por conteúdo em 2026-08-21/22)
• Evidência local: repo Wiki-Yan, container quartz-wiki na VM, Guia Secrets da Wiki.md (Confirmado)