Guía de documentación en Docusaurus
Crear una nueva rama
-
Abrir la terminal: Accede a la terminal o línea de comandos en tu sistema.
-
Navegar al directorio del proyecto: Utiliza el comando
cd
para dirigirte al directorio raíz de tu proyecto Docusaurus. -
Crear y cambiar a la nueva rama: Ejecuta el siguiente comando para crear una nueva rama y cambiar a ella simultáneamente:
git checkout -b nombre-de-tu-rama
Reemplaza
nombre-de-tu-rama
con un nombre descriptivo para la nueva rama. -
Verificar la rama activa: Confirma que estás en la rama correcta con:
git branch
La rama activa estará precedida por un asterisco (*).
Crear un nuevo documento
-
Ubicación del archivo: Guarda tus documentos en la carpeta
docs
de tu proyecto Docusaurus. -
Nombre del archivo: Asigna un nombre descriptivo al archivo con la extensión
.md
o.mdx
(por ejemplo,mi-documento.md
). -
Contenido del archivo: Inicia el archivo con un encabezado de metadatos (front matter) para definir propiedades como el título y la posición en la barra lateral.
---
title: Título de mi documento
sidebar_position: 1
---
# Título de mi documento
**Última actualización:** día de mes de año
Contenido de mi documento.title
: Título que aparecerá en la interfaz.sidebar_position
: Posición del documento en la barra lateral.
Actualizar un documento existente
-
Editar el archivo: Localiza el archivo correspondiente en la carpeta
docs
y ábrelo con tu editor de texto preferido. -
Modificar contenido: Realiza los cambios necesarios en el contenido o en los metadatos del documento.
-
Actualizar la fecha de modificación: Actualiza la fecha de modificación del documento.
# Título de mi documento
**Última actualización:** [Fecha de Actualización del Documento](día de mes de año) -
Guardar cambios: Guarda el archivo después de realizar las modificaciones.
Ejecutar el servidor de desarrollo
Para visualizar los cambios en tiempo real:
-
Iniciar el servidor: Abre una terminal y navega hasta el directorio raíz de tu proyecto Docusaurus. Ejecuta el siguiente comando:
npm start
-
Acceder al sitio: Esto iniciará el servidor de desarrollo y podrás ver tus cambios en
http://localhost:3000/
.
Confirmar cambios
Después de realizar los cambios en el proyecto, es fundamental confirmar los cambios mediante un commit y, posteriormente, crear un pull request para que otro miembro del equipo pueda revisar y aceptar tus modificaciones.
-
Agregar archivos al staging: Añade los archivos modificados al área de preparación con:
git add .
-
Realizar un commit: Confirma los cambios con un mensaje descriptivo:
git commit -m "Descripción de los cambios realizados"
-
Subir la rama al repositorio remoto: Envía la nueva rama al repositorio remoto:
git push origin nombre-de-tu-rama
-
Crear un pull request: Accede a la plataforma de gestión de código (como GitHub) y crea un pull request desde tu rama hacia la rama principal del proyecto.
Siguiendo estos pasos y consultando las guías mencionadas, asegurarás una colaboración eficiente y una gestión clara de las modificaciones en el proyecto.
Historial de cambios
Tipo de versión | Descripción | Fecha | Colaborador |
---|---|---|---|
1.0 | Creación de la guía. | 16/02/2025 | Ángel Ramirez |
1.1 | Gestión de configuración. | 24/04/2025 | Diego Fuentes |