📚 Como Contribuir

Colabore colocando seus RPGs e ajude a construir o maior acervo de RPG de mesa em português do Brasil! Compartilhe seus sistemas, fichas personalizadas e materiais traduzidos.

Opções de Contribuição

Existem várias formas de contribuir. Escolha a que for mais fácil para você:

Opção 1️⃣ - A Forma Mais Fácil (Sem Git)

Se você não quer mexer com Git ou GitHub, pode usar a interface web do GitHub diretamente!

1
Acesse o Repositório

Vá até o repositório no GitHub

2
Crie sua Conta no GitHub (se não tiver)

Caso você ainda não tenha uma conta no GitHub, clique aqui para criar uma conta gratuita. É rápido e gratuito!

Se você já tem uma conta, faça login e pule para o próximo passo.

3
Faça um Fork do Repositório

Clique no botão Fork no canto superior direito da página do repositório e depois em Create Fork. Isso criará uma cópia completa do repositório na sua conta do GitHub, onde você poderá fazer suas alterações livremente.

4
Navegue até a Pasta Correta

Abra a pasta livros e fichas pdf no seu fork (a cópia que você acabou de criar)

5
Crie uma Nova Pasta

Clique em Add file → Create new file

Na caixa de nome do arquivo, escreva: nome-do-rpg/descricao.txt (use nome em minúsculas, com hífens).

Quando você coloca uma barra (/) no nome, o GitHub cria a pasta nome-do-rpg automaticamente e coloca o arquivo dentro dela. Você pode manter esse arquivo ou trocá-lo depois pelos PDFs.

Depois de clicar no botão Commit changes, abrirá um pop-up. Clique no botão de commit abaixo e a pasta já estará criada dentro de livros e fichas pdf.

⚠️ Evite Caracteres Especiais: Use apenas letras simples (a-z), números (0-9), underscores (_) e hífens (-). Evite ç, á, é, í, ó, ú, ã, õ, ê, â e outros caracteres acentuados, pois podem causar problemas de compatibilidade.
6
Upload dos Arquivos do RPG

Clique em Add file, depois clique em Upload files na pasta que você criou e selecione os arquivos do seu RPG (PDFs, fichas, tokens, mapas, etc).

Você pode fazer upload de vários arquivos de uma vez. Selecione tudo que deseja compartilhar.

⚠️ Limite de Tamanho: A interface web do GitHub aceita arquivos de até 25 MB. Essa opção é ideal para fichas, sistemas pequenos, tokens e mapas. Se seus arquivos forem maiores, utilize a Opção 2 (via Git).
7
Confirme o Commit das Alterações

Após fazer o upload dos arquivos, escreva uma mensagem descrevendo sua contribuição onde está escrito add files via upload. Digite uma descrição clara (ex: "Adicionado o RPG X com fichas e mapas") e clique em Commit changes. Isso salva suas alterações no seu fork.

8
Faça uma Pull Request

Volte para seu fork e clique em Contribute → Open pull request

Descreva o RPG que você adicionou e clique em Create pull request! 🎉

9
Aguarde a Análise e Aceitação

Após enviar sua Pull Request, o mantenedor do repositório irá revisar sua contribuição. Este processo pode levar alguns dias, dependendo da disponibilidade.

Durante a revisão, pode ser solicitado que você faça algumas alterações ou correções. Fique atento às notificações do GitHub!

Assim que sua contribuição for aprovada, ela será mesclada ao repositório principal e seu RPG estará disponível para toda a comunidade! 🎊

✨ Vantagem: Você não precisa aprender Git nem instalar nada! Tudo funciona direto no navegador.

Opção 2️⃣ - Usando Git (Para Usuários Avançados)

Se você já conhece Git ou quer aprender, pode usar a linha de comando:

1
Faça um Fork

Vá até o repositório e clique em "Fork"

2
Clone o Repositório
git clone https://github.com/SEU-USUARIO/RPGs-PT-BR.git cd RPGs-PT-BR

Dica: Substitua SEU-USUARIO pelo seu nome de usuário do GitHub!

3
Organize Seus Arquivos

Dentro de "livros e fichas pdf", crie uma pasta com o nome do seu RPG e coloque os arquivos lá:

mkdir "livros e fichas pdf/meu-rpg" # Copie seus arquivos para essa pasta
4
Faça o Commit e Push
git add . git commit -m "Adiciona RPG [Nome]" git push origin main
5
Crie uma Pull Request

Seu fork pedirá para criar uma pull request. Clique e descreva o RPG adicionado!

Estrutura do Repositório

Entenda como os arquivos são organizados:

livros e fichas pdf/ ├── 3dt/ ├── chacal_rpg_lobsomen/ ├── d&d5e/ ├── jujutsu_versao_2.0/ ├── skyfall_final/ └── [nome do seu RPG]/ ├── arquivo-principal.pdf ├── ficha.pdf └── ficha_editavel.txt tokens e mapas/ ├── [materiais adicionais]

Regra importante: Crie uma pasta com o nome do RPG dentro de "livros e fichas pdf" e coloque os arquivos lá dentro.

Normalizando os Nomes das Pastas

Para manter o repositório organizado, use as seguintes convenções para nomes de pastas:

⚠️ Importante: Caracteres especiais podem causar problemas de compatibilidade entre sistemas operacionais e quebrar a visualização. Use apenas letras simples (a-z), números (0-9), underscores (_) e hífens (-).

Tipos de Arquivos Aceitos

⚠️ Importante: Respeite os direitos autorais! Apenas adicione materiais que você possui permissão para compartilhar ou que estejam sob licenças de compartilhamento.

Precisa de Ajuda?

Obrigado! 🎉

Agradeço imensamente a sua contribuição para este acervo de RPGs em português! Cada novo RPG adicionado enriquece nossa coleção e ajuda a comunidade a descobrir novos jogos incríveis.

← Voltar ao Índice