devjonatas/guia-gamedesign
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
25 commits 2 branches 0 tags 7.2 MiB
  • JavaScript 40.7%
  • CSS 29.6%
  • HTML 20.3%
  • Shell 9.4%
Find a file
Exact
Jonatas Oliveira c10dd04ff1
All checks were successful
Deploy to Pages / build-and-deploy (push) Successful in 14s
Details
fix(idioma): prosa estrangeira nas definições de Grinding e Hardcore 
"joga intensely, competitively. También" e "Necessary evil" misturavam
inglês e espanhol no meio do português — traduzidos para pt-BR, com note()
registrando a revisão. Detectado pela varredura EXTRANHOS (V7 = 0.000
arredondado, 1/3439).
2026-08-14 19:05:57 +02:00
.forgejo/workflows ci(fatos): gate validate-facts.sh no CI, falhando em V1-V6/V8 2026-08-14 12:59:39 +02:00
content fix(idioma): prosa estrangeira nas definições de Grinding e Hardcore 2026-08-14 19:05:57 +02:00
scripts ci(fatos): gate validate-facts.sh no CI, falhando em V1-V6/V8 2026-08-14 12:59:39 +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.