🤝 Como Contribuir

Esta wiki só se mantém útil porque os membros da aliança a mantêm atualizada. As tuas atualizações, novos guias e capturas de ecrã ajudam toda a gente.

Como o site é feito

A wiki é escrita em ficheiros Markdown simples (o mesmo formato destas páginas).

Uma ferramenta chamada MkDocs (com o tema Material) transforma estes ficheiros Markdown no bonito site que vês.

Todos os ficheiros fonte vivem neste repositório Git.

Quando as alterações são aceites na branch main, um sistema automático (Forgejo Actions) constrói o site e publica-o em ffz.codeberg.page dentro de um ou dois minutos. Nunca tens de carregar ficheiros HTML manualmente.

O que é Git?

Git é um sistema que regista o histórico completo de todas as alterações feitas aos ficheiros do projeto. Pensa nele como o "histórico de versões" de toda a wiki (quem alterou o quê, quando e porquê).

Não precisas de compreender o Git em profundidade para contribuir.

Para trabalho maior (especialmente adicionar ou modificar fotos, criar novas páginas ou reestruturações grandes), clonar o repositório e trabalhar localmente dá-te controlo total e uma experiência muito melhor.

O resto deste guia explica o caminho "Git completo". Para edições de texto simples, podes usar o editor web diretamente no Codeberg (não precisas de clonar nada).

Como obter material (fotos, logos, etc.) do repositório

Todas as imagens são guardadas na pasta docs/assets/images/:

Retratos de heróis → docs/assets/images/hero/
Logos e outros gráficos → docs/assets/images/logo/
Diagramas (como os contadores de facção) → docs/assets/images/

Para ver ou descarregar imagens existentes:

Vai ao repositório no Codeberg
Navega para docs → assets → images
Clica na imagem que queres
Clica no botão Raw — isto dá-te a imagem direta. Clique direito → "Guardar imagem como..."

Também podes clonar o repositório inteiro para o teu computador (ver a secção "Trabalhar com o repositório completo") se quiseres todos os ficheiros localmente.

Usar a interface web

Se tens (ou crias) uma conta Codeberg gratuita, podes contribuir com alterações — incluindo adicionar novas fotos ou capturas de ecrã — diretamente através do site do Codeberg sem precisares de clonar o repositório ou usar comandos Git no teu computador. Este é muitas vezes o caminho mais fácil para contribuintes ocasionais.

Inicia sessão na tua conta Codeberg em https://codeberg.org.
Vai ao repositório: https://codeberg.org/FFz/pages
Navega até ao ficheiro Markdown que queres editar (ou à pasta onde queres criar um novo ficheiro).
Clica no botão Edit (ou "Edit file") para esse ficheiro. Isto abre o editor online do Codeberg com pré-visualização ao vivo.
Faz as tuas alterações de texto no editor.
Para adicionar uma nova foto ou captura de ecrã:
Na área de commit na parte inferior do editor (ou ao criar a PR), procura a opção para upload files ou anexar novos ficheiros.
Carrega a tua imagem (será colocada na localização correta em relação à alteração).
Escreve uma mensagem de commit clara que descreva a tua alteração.
Clica em Commit changes.
Se tens acesso de escrita (por exemplo, fazes parte da equipa de desenvolvimento), a alteração é committada diretamente.
Caso contrário, o Codeberg criará automaticamente uma Pull Request a partir de um fork na tua conta para revisão.

Este fluxo web suporta o carregamento direto de imagens e é suficiente para a maioria das contribuições (atualizações de texto + novos visuais).

Juntar-te à equipa de desenvolvimento (para contribuintes regulares)

Se planeias contribuir frequentemente (adicionando muitos guias, imagens ou ajudando a manter a wiki), é muito mais conveniente tornar-te membro da equipa de desenvolvimento:

Cria uma conta gratuita em https://codeberg.org (se não tiveres uma).
Contacta um R5 (ou R4) na aliança — via mail in-game, chat da aliança ou Discord — e pede para seres adicionado à equipa de desenvolvimento FFz no Codeberg.
Depois de aprovado e adicionado à organização:

Permissões que vais obter: - Acesso de escrita direta ao repositório (as alterações podem ser committadas sem passar por Pull Requests). - Podes editar ficheiros através da interface web e aplicá-los diretamente (ou push a partir de clone local sem forks). - Fluxo de trabalho mais rápido para trabalho frequente. - Se te derem direitos de maintainer, também poderás rever e fundir as Pull Requests de outras pessoas.

Este nível de acesso é reservado para membros confiáveis e ativos da aliança que ajudam regularmente com a wiki. Não é necessário para contribuições ocasionais — podes sempre usar a interface web ou a rota de Pull Request descrita acima.

Trabalhar com o repositório completo (forma Git)

Para alterações mais complexas ou quando preferes trabalhar localmente com as tuas próprias ferramentas e pré-visualização:

Cria uma conta gratuita em https://codeberg.org (se não tiveres uma) e pede a um R5 para te adicionar à equipa de desenvolvimento (ver a secção "Juntar-te à equipa de desenvolvimento" para detalhes sobre permissões).

Clona o repo:

git clone https://codeberg.org/FFz/pages.git
cd pages

Cria um novo branch para as tuas alterações:
```
git checkout -b my-new-guide
```
Edita ficheiros Markdown. Se adicionares novas imagens, coloca os ficheiros na subpasta apropriada sob docs/assets/images/ (ver a secção "Como obter material" acima para a estrutura de pastas, ex. hero/ para retratos). Referencia-os em Markdown usando caminhos relativos (olha para ficheiros existentes como a Galeria de Heróis para exemplos da sintaxe relativa correta).
Pré-visualização local (altamente recomendado):
```
pip install -r requirements.txt
mkdocs serve
```
Depois abre http://127.0.0.1:8000 no teu navegador. As alterações aparecem em tempo real.

Quando estiveres satisfeito, faz commit e push:

git add .
git commit -m "Adicionar novo guia sobre X e foto de herói"
git push origin my-new-guide

No Codeberg, abre uma Pull Request do teu branch para main.

Um maintainer irá revê-lo, possivelmente sugerir pequenas alterações e fundi-lo. O site atualizar-se-á automaticamente.

Orientações

O inglês (en/) é a língua principal. Atualiza-o primeiro, depois podemos traduzir para as outras línguas.
Mantém o tom amigável e prático das páginas existentes.
Adiciona "Última atualização" no fundo dos novos guias quando relevante.
Para grandes alterações estruturais, discute primeiro com um R4 ou R5.
Respeita os emojis existentes e o estilo de formatação.

Ainda não tens a certeza?

Envia simplesmente o texto, a foto ou a ideia via mail in-game ou chat da aliança para um officer. Nós tratamos da parte técnica se necessário.

Obrigado — cada pequena melhoria ajuda toda a aliança a jogar melhor em conjunto.

Unidos sob a Espada. ⚔️