devjonatas/guia-gamedesign
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
14 commits 2 branches 0 tags 5.5 MiB
  • JavaScript 44.9%
  • CSS 32.6%
  • HTML 22.5%
Find a file
Exact
Jonatas Oliveira eb2e7117bb
All checks were successful
Deploy to Pages / build-and-deploy (push) Successful in 9s
Details
chore: remove o tema EasyDocs, que não era usado 
Havia 58 arquivos versionados em `themes/` — o EasyDocs extraído solto na
raiz do diretório, sem a pasta de nome próprio que o Zola espera. Nada os
usava:

- Este site não declara tema. A linha `theme = "github-dark"` do
  `config.toml` está sob `[markdown.highlighting]` e é o tema de
  destaque de sintaxe, não de site.
- Os templates são todos locais e nenhum referencia `themes/`.
- Nenhum arquivo de `themes/static` ou `themes/sass` chega ao `public/`.

Mesmo que o tema fosse declarado, o caminho estaria errado: o Zola
procuraria `themes/github-dark/`, que não existe.

`zola build` e `zola check` seguem limpos depois da remoção.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-30 06:24:15 +02:00
.forgejo/workflows ci: adicionar grep-gate para detectar links absolutos hardcoded 2026-07-17 16:20:57 +02:00
content feat(gamedesign): espinha didática, 18 shortcodes e o CSS que faltava 2026-07-29 07:18:10 +02:00
static fix(busca,mermaid): busca funcional e diagramas que renderizam 2026-07-29 17:29:10 +02:00
templates fix(busca,mermaid): busca funcional e diagramas que renderizam 2026-07-29 17:29:10 +02:00
.gitignore feat(gamedesign): initial scaffold + encyclopedic content 2026-07-16 07:49:13 +02:00
config.toml docs(indice): adiciona indice por tema e indice enciclopedico A-Z 2026-07-26 08:26:03 +02:00
README.md feat(gamedesign): initial scaffold + encyclopedic content 2026-07-16 07:49:13 +02:00

README.md

Enciclopédia Game Design

Guia completo sobre Game Design teórico em português (PT-BR).

Sobre

Esta enciclopédia contém:

  • Enciclopédia — MDA Framework, Bartle, Schell Lenses, definições de jogo, loops, balanceamento
  • Tutoriais — Como escrever GDD, paper prototyping, playtesting, design doc template
  • Exemplos — Análise de xadrez, Go, Tetris, Slay the Spire, Minecraft sob a ótica do design
  • Recursos — Glossário, FAQ, links GDC Vault

Foco teórico-first: referências a MDA (Hunicke/LeBlanc/Zubek), Bartle (1996), Schell (2008/2014), Costikyan (1994), GDC Vault.

URL Pública

https://pages.singularjourney.org/devjonatas/guia-gamedesign/

Pré-requisitos

  • Zola 0.22.1 ou superior

Como rodar localmente

cd gamedesign
zola serve

Acesse http://127.0.0.1:1111 no navegador.

Como buildar

cd gamedesign
zola build

O site compilado estará em gamedesign/public/.

Como verificar links

cd gamedesign
zola check

Estrutura de diretórios

gamedesign/
├── content/
│   ├── enciclopedia/    # Referência enciclopédica (MDA, Bartle, etc)
│   ├── tutoriais/       # Tutoriais práticos (GDD, prototyping)
│   ├── exemplos/        # Análise de jogos (xadrez, Go, Tetris, etc)
│   └── recursos/        # FAQ, glossário, links GDC
├── templates/           # Templates HTML (overrides do tema)
├── static/              # Arquivos estáticos (CSS, search)
├── themes/              # Tema easydocs
└── config.toml          # Configuração do site

Taxonomias

O site utiliza 4 taxonomias para organizar o conteúdo:

  • tipo — tipo de conteúdo (enciclopedia, tutorial, exemplo, recurso)
  • nivel — nível de dificuldade (iniciante, intermediario, avancado)
  • topico — tópico principal (mda, bartle, schell, loops, etc)
  • tags — tags livres para busca

Busca

A busca utiliza ElasticLunr. O stemmer de português tem limitações — busca por radicais pode não funcionar perfeitamente para todos os verbos.

Licença

Este guia está sob licença CC BY-SA 4.0 (Creative Commons Attribution-ShareAlike 4.0 International).

Veja o arquivo LICENSE para detalhes completos.

Contribuições

Contribuições são bem-vindas. Abra issues para reportar problemas ou sugerir melhorias.