GitHub Vita Lite - Wolff's Store
Code / README | Releases | Issues
WolffsRoom/WolffsRoomSite

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)

  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

---
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.