Wikis, Proyectos y Releases

Forgejo incluye herramientas de colaboracion integradas que evitan depender de servicios externos para documentacion, gestion de tareas y distribucion de artefactos.

Wiki integrada

La wiki es un repositorio git independiente, asociado al repositorio principal, que almacena paginas en formato Markdown.

Habilitar la wiki

Ve a Configuracion del repositorio > Funciones y activa la opcion Wiki. Desde ese momento aparece la pestana Wiki en el repositorio.

Crear paginas

En la pestana Wiki, haz clic en Nueva pagina. El editor acepta Markdown estandar con preview en tiempo real.

Cada pagina tiene:

• Titulo: se convierte en el nombre del archivo y en la URL (/wiki/Titulo-de-la-pagina).
• Contenido: Markdown completo con soporte para tablas, bloques de codigo, imagenes y enlaces.
• Mensaje de commit: obligatorio, igual que en un repositorio git normal.

Sintaxis Markdown en wikis

La wiki soporta enlaces internos entre paginas con doble corchete:

[[Otra pagina]]
[[Texto visible|Nombre-de-pagina]]

Para imagenes subidas a la wiki:

![descripcion](imagen.png)

Sidebar personalizado

Crea una pagina llamada exactamente _Sidebar. Su contenido aparecera como menu lateral en todas las paginas de la wiki. Ejemplo:

## Indice

- [[Inicio]]
- [[Arquitectura]]
- [[API Reference]]
- [[Guia de contribucion]]

Clonar la wiki como repositorio git

La wiki es un repositorio git separado. Puedes clonarlo, editarlo localmente y hacer push:

git clone https://forgejo.ejemplo.com/usuario/repo.wiki.git
cd repo.wiki
# edita archivos .md
git add .
git commit -m "docs: actualizar guia de instalacion"
git push

Los cambios aparecen inmediatamente en la interfaz web.

Projects (tableros Kanban)

Los proyectos permiten organizar issues y pull requests en tableros visuales de tipo Kanban.

Crear un proyecto

Los proyectos pueden vivir en dos niveles:

• A nivel de repositorio: en la pestana Proyectos del repositorio.
• A nivel de organizacion: en el perfil de la organizacion, pestana Proyectos.

Para crear uno, haz clic en Nuevo proyecto y completa:

• Nombre: identificador del proyecto.
• Descripcion: contexto del objetivo.
• Plantilla: puedes empezar en blanco o con columnas predefinidas (Basic Kanban, Bug Triage).

Columnas personalizadas

Una vez creado el proyecto, agrega columnas con el boton Agregar columna. Nombres tipicos:

• Backlog
• To Do
• In Progress
• In Review
• Done

Cada columna puede tener un color de etiqueta para identificacion visual rapida.

Agregar issues como cards

Dentro de una columna, haz clic en Agregar elemento y busca el issue o PR por numero o titulo. El card muestra:

• Titulo del issue o PR
• Numero de referencia
• Etiquetas asignadas
• Usuario asignado

Tambien puedes asignar un issue a un proyecto desde el propio issue, en el panel lateral derecho bajo la seccion Proyectos.

Mover cards entre columnas

Arrastra el card de una columna a otra. El cambio se registra en el historial del issue. No hay automatizacion nativa de mover cards al cerrar un issue (a diferencia de GitHub), pero puedes moverlo manualmente al cerrarlo.

Releases

Las releases permiten publicar versiones estables del software, adjuntar binarios y generar changelogs estructurados.

Crear una release desde un tag

Ve a la pestana Releases del repositorio y haz clic en Nueva release.

El formulario solicita:

• Tag: escribe un tag existente o crea uno nuevo directamente (por ejemplo v1.2.0). Si creas uno nuevo, elige la rama o commit base.
• Titulo de la release: nombre legible para la version (por ejemplo Version 1.2.0 - Mejoras de rendimiento).
• Notas de la release: editor Markdown donde escribes el changelog. Puedes usar listas, secciones y menciones.

Subir assets binarios

En la seccion Archivos adjuntos puedes subir cualquier archivo: binarios compilados, instaladores, checksums, documentacion PDF.

Los assets quedan disponibles para descarga directa desde la pagina de la release y via URL predecible:

https://forgejo.ejemplo.com/usuario/repo/releases/download/v1.2.0/nombre-archivo

Marcar como pre-release

Activa la casilla Esta es una pre-release para indicar que la version no es estable para produccion. Las pre-releases aparecen listadas pero con una etiqueta visual diferenciadora.

Generar release notes automaticas

Forgejo puede generar notas automaticas basadas en los commits y PRs mergeados desde la release anterior. En el formulario de nueva release, haz clic en Generar notas de release.

El resultado incluye una lista de los PRs mergeados con sus titulos y autores, agrupados automaticamente. Puedes editar el texto generado antes de publicar.

El formato generado sigue esta estructura:

## Novedades

* feat: descripcion del cambio by @usuario in #42
* fix: correccion de bug by @usuario in #38

## Nuevos contribuidores

* @nuevo-usuario hizo su primera contribucion en #38

---

Siguiente: Capitulo 13: Notificaciones y Busqueda —>