# 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) 1. Abra **Issues → New issue → Novo post**: https://github.com/WolffsRoom/WolffsRoomSite/issues/new?template=novo-post.yml 2. Preencha os campos. Para imagens, **arraste os arquivos** para dentro dos campos *Capa* e *Capturas de tela*. 3. 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` ```markdown --- 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. ```markdown --- 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: ```yaml 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//` (para cada TitleID). Diz se o plugin rePatch não estiver instalado. O zip pode ter os arquivos soltos ou dentro de `rePatch//` ou `/`. | | `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` e um arquivo `WolffsStore-*.vpk`. Ao abrir, se houver versão mais nova, ele baixa e se reinstala. Para lançar uma versão: ```powershell 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 ```powershell 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.