Publicar artículos en GitLab

Conecta GitLab una vez y podrás publicar cualquier artículo de Clevera en un proyecto de GitLab como un archivo Markdown, listo para un sitio de documentación, una docs/ carpeta o un manual de proyecto. Este artículo cubre cómo conectar, elegir el proyecto y la carpeta, cómo se ve el archivo y cómo funcionan las actualizaciones.

Antes de empezar#

• Plan: publicar en GitLab es parte de los planes Pro y Custom. En los planes Free y Starter, la pestaña Publicar muestra "La publicación en tus herramientas está incluida en Pro". Consulta Elegir un plan.
• Rol en Clevera: solo el propietario del espacio de trabajo o un administrador puede conectar o desconectar GitLab. Una vez conectado, cualquier persona que pueda editar un artículo puede publicarlo.
• Solo GitLab.com: Clevera se conecta a GitLab.com. No se admiten servidores de GitLab autogestionados.
• Rol en GitLab: Clevera enumera los proyectos donde la cuenta conectada tiene el rol de desarrollador o superior. Para realizar confirmaciones (commits) en una rama predeterminada protegida, esa cuenta generalmente necesita el rol de mantenedor (consulta Ramas protegidas).
• Un artículo: publicas el artículo que pertenece a un video o grabación. Generalo primero; consulta Convertir una grabación en un artículo.

La publicación no consume créditos.

Conectar GitLab#

1. Abrir Integraciones#

   En la barra lateral, abre el menú del espacio de trabajo y elige Integraciones. Busca GitLab en Integraciones disponibles (o en la pestaña Desarrollo) y haz clic en Conectar.

2. Iniciar sesión en GitLab y autorizar#

   Inicia sesión en GitLab.com si aún no lo has hecho. GitLab te pedirá que autorices a Clevera con estos alcances:

   Alcance de GitLab	Por qué
   api	La API de archivos de GitLab lo necesita para crear y actualizar archivos
   read_user	Para mostrar tu nombre de usuario de GitLab en Clevera
   read_repository	Para comprobar si un archivo ya existe
   write_repository	Para realizar la confirmación (commit) del archivo Markdown y sus imágenes

   Haz clic en Autorizar.

3. Comprobar la conexión#

   Volverás a Integraciones con el mensaje "GitLab conectado correctamente a" seguido de tu nombre de usuario de GitLab. GitLab se moverá a la lista Conectado con una insignia de Conectado. Antes de publicar algo, dirá "Aún no se ha publicado nada".

Publicar un artículo#

1. Abrir la pestaña Publicar#

   En el editor, haz clic en Compartir y abre la pestaña Publicar. En Publicar el artículo, haz clic en el mosaico de GitLab en Listo para publicar.

   El artículo se publica en el idioma que tienes abierto en el editor. Cambia el idioma en la barra superior primero para publicar una traducción.

2. Elegir el proyecto y la carpeta#

   En Dónde se guarda, elige:

   Campo	Qué elegir	Notas
   Repositorio	El proyecto de GitLab para el archivo	Proyectos donde eres desarrollador o superior, ordenados por los más recientes. El primero está seleccionado por defecto
   Carpeta	Una ruta como docs o articles/guides	"El archivo Markdown se crea aquí. Déjalo vacío para la raíz del repositorio." Empieza como docs. Las carpetas que aún no existen se crean automáticamente

   Clevera recuerda lo que elegiste para la próxima vez.

   

3. Publicar#

   Haz clic en Publicar en GitLab. Verás "Buscando una copia existente en GitLab", luego Escribiendo la página. Cuando termine, verás "Publicado en GitLab". Haz clic en Abrir en GitLab para ver el archivo.

   Puedes cerrar la ventana Compartir mientras se procesa; una notificación te avisará cuando termine.

Dónde va el archivo#

• Rama: la rama predeterminada del proyecto (normalmente main). Clevera realiza la confirmación directamente en ella; no abre una solicitud de fusión (merge request) y no puedes elegir otra rama.
• Nombre del archivo: el título en minúsculas, con espacios convertidos en guiones, terminando en .md. "Create your first invoice" se convierte en create-your-first-invoice.md. Los títulos en otros alfabetos o con acentos se escriben primero en letras latinas ("Créer une facture" se convierte en creer-une-facture.md). Un título sin caracteres latinos, como uno hecho solo de emojis, obtiene un código fijo corto en su lugar (article- más 8 caracteres). Los nombres se cortan a 80 caracteres.
• Imágenes: las capturas de pantalla del artículo van en assets/<file name>/ dentro de la misma carpeta, en la misma confirmación.
• Mensaje de confirmación: Add article: <title>, o Update article: <title> cuando actualizas un archivo existente.
• Autor de la confirmación: la cuenta de GitLab que conectó la integración.

Ramas protegidas#

GitLab protege la rama predeterminada por defecto, y normalmente solo los mantenedores pueden enviar cambios (push) a ella. Si la cuenta conectada es desarrollador, la confirmación se rechaza con "GitLab rechazó la confirmación: necesitas acceso de desarrollador o superior, y la rama no debe estar protegida." O bien otorga a esa cuenta el rol de mantenedor, o permite que los desarrolladores envíen cambios en Ajustes → Repositorio → Ramas protegidas en el proyecto.

Cómo se ve el archivo#

Clevera escribe Markdown que GitLab renderiza, con un bloque de metadatos (front matter) corto en la parte superior:

---
title: "Create your first invoice"
created_at: "2026-10-12T09:30:00+00:00"
updated_at: "2026-10-12T10:05:00+00:00"
source: "Clevera"
---

El video del que proviene el artículo no se añade al archivo. Un video de Clevera colocado dentro del artículo se convierte en un enlace a su reproductor, solo cuando el enlace para compartir de ese video está activado. Consulta Mostrar un video en un artículo.

Imágenes#

Las capturas de pantalla se confirman en tu proyecto junto al archivo, y el Markdown enlaza a ellas mediante una ruta relativa (assets/<file name>/…). Siguen funcionando sin Clevera, y en un proyecto privado permanecen tan privadas como el resto del mismo.

Un archivo de video que subiste al artículo no se confirma. Sigue siendo un enlace a Clevera que caduca después de un tiempo; publica de nuevo para renovarlo.

Usarlo con un sitio de documentación#

Si GitLab Pages u otro generador de sitios estáticos (como MkDocs, Docusaurus o Hugo) construye tu documentación desde el proyecto, apunta Carpeta a la carpeta que lee. Cada publicación es una confirmación normal, por lo que tu pipeline se ejecuta como de costumbre. La mayoría de los generadores leen title de los metadatos e ignoran los campos que no conocen.

Actualizar un artículo que ya publicaste#

La publicación solo funciona en una dirección. Las ediciones que haces en Clevera permanecen en Clevera hasta que publicas de nuevo, y los cambios realizados en el archivo en GitLab nunca vuelven a Clevera.

Cuando publicas en el mismo proyecto y carpeta, Clevera encuentra el archivo con el mismo nombre y muestra "Este artículo ya está en GitLab." Haz clic en Verlo para abrir el archivo existente, luego elige:

Si el título cambió en Clevera, el nombre del archivo también cambia, por lo que la publicación crea un nuevo archivo junto al antiguo. Elimina o renombra el archivo antiguo en GitLab tú mismo. Nada en Clevera elimina archivos de tu proyecto.

Desconectar GitLab#

1. Abre Integraciones, haz clic en el menú ⋯ en la fila de GitLab y elige Desconectar (o haz clic en GitLab y luego en Desconectar).
2. Confirma. "Ya no podrás publicar en él desde el editor. El contenido que ya publicaste permanece en GitLab."

Desconectar elimina los tokens de Clevera. Para revocar el acceso de Clevera en GitLab también, abre el menú de tu avatar de GitLab → Editar perfil → Aplicaciones, busca Clevera en Aplicaciones autorizadas y haz clic en Revocar.

Solución de problemas#

Relacionado#