COMO-POSTAR.md
9266 bytes · Original / download
Como cadastrar e editar posts
Há dois jeitos. Os dois publicam o site sozinhos em cerca de 1 minuto.
1. Pelo formulário (mais fácil, funciona até no celular)
- Abra Issues → New issue → Novo post: https://github.com/WolffsRoom/WolffsRoomSite/issues/new?template=novo-post.yml
- Preencha os campos. Para imagens, arraste os arquivos para dentro dos campos Capa e Capturas de tela.
- Clique em Submit new issue.
A automação cria a pasta do post, publica o site e fecha a issue com o link do post. Se algo estiver errado (por exemplo, faltou a capa), ela comenta na issue explicando o problema e a issue continua aberta.
Só issues abertas por você (dono ou colaboradores do repositório) viram post.
2. Pelo arquivo (para editar posts ou criar com mais controle)
Cada post é uma pasta em content/posts/ com um post.md e as imagens ao lado:
content/posts/pizza/
├── post.md
├── capa.png
├── captura-1.jpg
└── captura-2.jpg
O nome da pasta é o endereço do post (…/WolffsRoomSite/#pizza). Use só letras minúsculas, números e hífen.
Para editar pelo navegador: abra o post.md no GitHub, clique no lápis, altere e clique em Commit changes. Para trocar ou adicionar imagens: Add file → Upload files dentro da pasta do post.
Modelo de post.md
---
titulo: Nome do projeto
categoria: ports # ports | ferramentas | traducoes | reviews
grupo: Em andamento # Em andamento | Finalizado | Próximos | Outras equipes
data: 2026-11-13 21:30 # define a ordem; o mais recente vira o destaque da página inicial e do app (hora opcional)
tag: Port · PS Vita # linha pequena acima do título no card
status: Em andamento # texto de status no card
resumo: Uma frase curta para o card.
progresso: 60 # opcional, 0 a 100
capa: capa.png # arquivo na mesma pasta
capturas: # opcional
- captura-1.jpg
- captura-2.jpg
video: https://www.youtube.com/watch?v=XXXXXXXXXXX # opcional
video_legenda: Trailer # opcional
barras: # opcional
Scripts: 90
Gráficos: 40
ficha: # opcional
Versão do jogo: PCSE00000
Senha do arquivo: wolffsroom
links: # opcional; o primeiro vira o botão principal
Ver no GitHub: https://github.com/WolffsRoom/...
Google Drive: https://drive.google.com/...
---
Primeiro parágrafo: apresentação do projeto.
## Destaques
- Item
- Item com [link](https://exemplo.com)
## Instalação
- Passo 1
- Passo 2
Versão em inglês (post.en.md)
O site abre em inglês (o visitante pode trocar para português no botão EN/PT, acima do botão de som). Para cada post, um arquivo post.en.md na mesma pasta traz os textos em inglês. Tudo nele é opcional: o que faltar aparece em português.
---
titulo: Pizza Tower — SAGE 2019 Demo # só se mudar
tag: Port · PS Vita
status: In progress
resumo: Port of the SAGE 2019 demo to PS Vita.
chamada: Text for the home page highlight.
video_legenda: Trailer
titulo_barras: Progress
barras: # mesmos números, nomes em inglês
Scripts: 90
Graphics: 40
ficha:
Game version: PCSE00000
links:
View on GitHub: https://github.com/WolffsRoom/...
---
First paragraph: the project in English.
## Highlights
- Item
Pelo formulário, preencha os campos "(inglês)" e o post.en.md é criado junto.
Campos extras
| Campo | Para que serve |
|---|---|
chamada: |
Texto do destaque na página inicial (se faltar, usa o resumo). O destaque é sempre o post mais recente (data). |
pixelado: true |
Mantém a capa nítida, sem suavização (bom para pixel art). |
capa_estilo: logo |
Mostra a capa inteira centralizada em fundo preto (para logos). |
fontes: |
Caixa Source (abaixo de Downloads): links de código, wiki etc., no mesmo formato de links:. |
clock: |
Caixa Clock recomendado, ex.: CPU / GPU: 500 MHz / 222 MHz e Desempenho: 60 FPS estáveis. |
video_arquivo: |
Um .mp4 na pasta do post (ex.: trailer.mp4) ou um link. Toca no próprio site e dentro do app do Vita (use H.264 + AAC, até 960×544). Tem prioridade sobre video: (YouTube). |
- Para ports de terceiros, use autor: NomeDoDev e autor_url: https://github.com/NomeDoDev no cabeçalho do post. Isso gera a etiqueta by: NomeDoDev no site e na Wolff's Store. Posts antigos ficam sem etiqueta. |
| trofeus: true | O jogo tem troféus nativos (NoTrpDrm): mostra o troféu em pixel art no card e no post. |
| titulo_barras: | Título da caixa de barras (padrão: "Progresso"). |
| barras com texto | Nota final: 89 (192/216) mostra a barra em 89% com o texto "192/216". |
Downloads no app Wolff's Store (PS Vita)
O app do Vita lê o store.json que o site gera. Para um post ter botão de download no app, adicione
downloads: no cabeçalho do post.md. Cada item é um arquivo:
downloads:
- tipo: vpk # vpk | traducao | plugin | arquivo
repo: WolffsRoom/PizzaTowerSage2019Vita # pega o arquivo da última release do repo...
arquivo: "*.vpk" # ...que casa com este padrão (padrão: *.vpk)
titleid: PZTW00001 # opcional: o app mostra "Atualizar" se já estiver instalado
precisa_dados: true # mostra o aviso de arquivos de dados do jogo
instrucoes: https://github.com/WolffsRoom/PizzaTowerSage2019Vita#instalação # opcional
- tipo: traducao
url: https://exemplo.com/traducao.zip # ou link direto, com a versão escrita à mão
versao: "1.2"
titleid: [PCSE00584, PCSB00726] # obrigatório: pastas em ux0:rePatch/
- tipo: plugin
repo: WolffsRoom/MeuPlugin
arquivo: "*.suprx"
| Tipo | O que o app faz |
|---|---|
vpk |
Baixa em segundo plano e instala. Com precisa_dados: true mostra "Esse jogo precisa dos arquivos de dados do jogo, confira as instruções no GitHub" e um botão para as instruções. |
traducao |
Baixa o .zip e extrai em ux0:rePatch/<TITLEID>/ (para cada TitleID). Diz se o plugin rePatch não estiver instalado. O zip pode ter os arquivos soltos ou dentro de rePatch/<TITLEID>/ ou <TITLEID>/. |
plugin |
Baixa para ux0:Downloads/ e mostra as instruções (link do GitHub do post, ou instrucoes:). |
arquivo |
Baixa para ux0:Downloads/. |
dados |
Baixa o .zip e extrai em ux0:data/ (dados do jogo). |
Links de arquivo do Google Drive (drive.google.com/file/d/...) viram download direto, no site e no app.
Campos: repo: + arquivo: (e tag: para uma release específica) ou url: (+ versao:);
nome: muda o texto do botão; instrucoes: troca o link de instruções (padrão: link do GitHub do post).
O site é gerado de novo a cada 6 horas e a cada release deste repo, então releases novas dos projetos
aparecem no app sozinhas.
Atualização do próprio app
O app procura releases deste repo com tag store-v<versão> e um arquivo WolffsStore-*.vpk. Ao abrir,
se houver versão mais nova, ele baixa e se reinstala. Para lançar uma versão:
gh release create store-v0.2 artifacts\current\WolffsStore-v0.2.vpk -R WolffsRoom/WolffsRoomSite -t "Wolff's Store v0.2" -n "O que mudou"
Pré-visualizar no computador
pip install pyyaml pillow
python tools/build.py
python -m http.server -d _site
Depois abra http://localhost:8000. Se algum post.md tiver erro, o build.py diz qual arquivo e o que corrigir.
Traduções com senha e espelhos (v1.0 do app)
No campo downloads, use um único item do tipo traducao, com URL principal, alternativas (espelhos de fallback), senha do ZIP e titleid do jogo. A página web lista os provedores separadamente no campo links. O app futuro terá somente um botão para a instalação.
Segurança: mantenha app_pendente: true até a nova release da Store no Vita. Enquanto estiver ativo, o site e o app antigo exibem os links manuais, mas não disponibilizam a instalação automatizada incompatível com ZIP AES. Remova o campo ao publicar a versão do aplicativo que conhece esse fluxo.
Tipo de noticia (etiqueta amarela)
No cabecalho do post.md use novidade: Release para o primeiro lancamento publico de um projeto, ou novidade: Update para uma atualizacao. A etiqueta pixelada e inclinada aparece no site e no VPK. Omita o campo para posts sem lancamento.
Compatibilidade do instalador da Wolff's Store v1.0
Para pacotes que a v0.99.x não sabia instalar (ZIP com VPK, ZIP/RAR de rePatch), inclua o campo app_min no item de download:
app_min: "1.0"
O site continua gerando store.json para as lojas antigas, SEM esses novos pacotes. A v1.0 sincroniza store-v1.json e recebe os sete pacotes de tradução habilitados para o fluxo automático. Downloads com app_pendente: true continuam ocultos nos dois catálogos (ex.: WipEout 2048, que ainda distribui só um torrent).
Os links dentro de links: continuam visíveis e separados no site, mesmo quando o app tem apenas um botão de instalação e fallbacks configurados em alternativas:. Datas de publicação não devem ser substituídas pela data de revisão do post.