🤝 Cómo Contribuir

Esta wiki solo sigue siendo útil porque los miembros de la alianza la mantienen actualizada. Tus actualizaciones, nuevas guías y capturas de pantalla ayudan a todos.

Cómo está hecho el sitio

La wiki está escrita en archivos Markdown simples (el mismo formato que estas páginas).

Una herramienta llamada MkDocs (con el tema Material) convierte estos archivos Markdown en el bonito sitio web que ves.

Todos los archivos fuente viven en este repositorio Git.

Cuando los cambios se aceptan en la rama main, un sistema automático (Forgejo Actions) construye el sitio y lo publica en ffz.codeberg.page en un minuto o dos. Nunca tienes que subir archivos HTML manualmente.

¿Qué es Git?

Git es un sistema que registra el historial completo de cada cambio realizado en los archivos del proyecto. Piensa en ello como el "historial de versiones" de toda la wiki (quién cambió qué, cuándo y por qué).

No necesitas entender Git en profundidad para contribuir.

Para trabajos más grandes (especialmente añadir o modificar fotos, crear nuevas páginas o reestructuraciones grandes), clonar el repositorio y trabajar localmente te da control total y una experiencia mucho mejor.

El resto de esta guía explica la ruta "Git completo". Para ediciones de texto simples, puedes usar el editor web directamente en Codeberg (no es necesario clonar nada).

Cómo obtener material (fotos, logos, etc.) del repositorio

Todas las imágenes se almacenan en la carpeta docs/assets/images/:

Retratos de héroes → docs/assets/images/hero/
Logos y otros gráficos → docs/assets/images/logo/
Diagramas (como los contadores de facción) → docs/assets/images/

Para ver o descargar imágenes existentes:

Ve al repositorio en Codeberg
Navega a docs → assets → images
Haz clic en la imagen que quieras
Haz clic en el botón Raw — esto te da la imagen directa. Clic derecho → "Guardar imagen como..."

También puedes clonar todo el repositorio a tu ordenador (ver la sección "Trabajar con el repositorio completo") si quieres todos los archivos localmente.

Usar la interfaz web

Si tienes (o creas) una cuenta gratuita de Codeberg, puedes contribuir con cambios — incluyendo añadir nuevas fotos o capturas de pantalla — directamente a través del sitio de Codeberg sin necesidad de clonar el repositorio ni usar comandos Git en tu ordenador. Este es a menudo el camino más fácil para contribuyentes ocasionales.

Inicia sesión en tu cuenta de Codeberg en https://codeberg.org.
Ve al repositorio: https://codeberg.org/FFz/pages
Navega hasta el archivo Markdown que quieres editar (o la carpeta donde quieres crear un nuevo archivo).
Haz clic en el botón Edit (o "Edit file") para ese archivo. Esto abre el editor online de Codeberg con vista previa en vivo.
Realiza tus cambios de texto en el editor.
Para añadir una nueva foto o captura de pantalla:
En el área de commit en la parte inferior del editor (o al crear la PR), busca la opción para subir archivos o adjuntar nuevos archivos.
Sube tu imagen (se colocará en la ubicación correcta relativa al cambio).
Escribe un mensaje de commit claro que describa tu cambio.
Haz clic en Commit changes.
Si tienes acceso de escritura (por ejemplo, eres parte del equipo de desarrollo), el cambio se comitea directamente.
Si no, Codeberg creará automáticamente una Pull Request desde un fork en tu cuenta para revisión.

Este flujo web soporta la subida directa de imágenes y es suficiente para la mayoría de las contribuciones (actualizaciones de texto + nuevos visuales).

Unirse al equipo de desarrollo (para contribuyentes regulares)

Si planeas contribuir frecuentemente (añadiendo muchas guías, imágenes o ayudando a mantener la wiki), es mucho más conveniente convertirte en miembro del equipo de desarrollo:

Crea una cuenta gratuita en https://codeberg.org (si no tienes una).
Contacta a un R5 (o R4) en la alianza — vía correo in-game, chat de alianza o Discord — y pide que te añadan al equipo de desarrollo FFz en Codeberg.
Una vez aprobado y añadido a la organización:

Permisos que obtendrás: - Acceso de escritura directa al repositorio (los cambios se pueden commitear sin pasar por Pull Requests). - Puedes editar archivos a través de la interfaz web y aplicarlos directamente (o push desde clone local sin forks). - Flujo de trabajo más rápido para trabajo frecuente. - Si se te dan derechos de maintainer, también podrás revisar y fusionar las Pull Requests de otras personas.

Este nivel de acceso está reservado para miembros confiables y activos de la alianza que ayudan regularmente con la wiki. No es necesario para contribuciones ocasionales — siempre puedes usar la interfaz web o la ruta de Pull Request descrita arriba.

Trabajar con el repositorio completo (forma Git)

Para cambios más complejos o cuando prefieres trabajar localmente con tus propias herramientas y vista previa:

Crea una cuenta gratuita en https://codeberg.org (si no tienes una) y pide a un R5 que te añada al equipo de desarrollo (ver la sección "Unirse al equipo de desarrollo" para detalles sobre permisos).

Clona el repo:

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

Crea una nueva rama para tus cambios:
```
git checkout -b my-new-guide
```
Edita archivos Markdown. Si añades nuevas imágenes, coloca los archivos en la subcarpeta apropiada bajo docs/assets/images/ (ver la sección "Cómo obtener material" arriba para la estructura de carpetas, ej. hero/ para retratos). Refiérecelos en Markdown usando rutas relativas (mira archivos existentes como la Galería de Héroes para ejemplos de la sintaxis relativa correcta).
Vista previa local (altamente recomendado):
```
pip install -r requirements.txt
mkdocs serve
```
Luego abre http://127.0.0.1:8000 en tu navegador. Los cambios aparecen en vivo.

Cuando estés contento, haz commit y push:

git add .
git commit -m "Añadir nueva guía sobre X y foto de héroe"
git push origin my-new-guide

En Codeberg, abre una Pull Request desde tu rama a main.

Un maintainer la revisará, posiblemente sugerirá pequeños cambios y la fusionará. El sitio se actualizará automáticamente.

Directrices

El inglés (en/) es el idioma principal. Actualízalo primero, luego podemos traducir a los otros idiomas.
Mantén el tono amigable y práctico de las páginas existentes.
Añade "Última actualización" al final de las nuevas guías cuando sea relevante.
Para grandes cambios estructurales, discútelo primero con un R4 o R5.
Respeta los emojis existentes y el estilo de formato.

¿Aún no estás seguro?

Simplemente envía el texto, la foto o la idea por correo in-game o chat de la alianza a un oficial. Nosotros nos encargaremos de la parte técnica si es necesario.

Gracias — cada pequeña mejora ayuda a toda la alianza a jugar mejor juntos.

Unidos bajo la Espada. ⚔️