freeCodeCamp/docs/i18n/espanol/how-to-work-on-the-docs-the...

1.9 KiB

Cómo trabajar en la documentación

[!NOTE] Recuerda que no necesitas configurar nada para trabajar en el contenido de la documentación.

To work on the contributing guidelines, you can edit or add files in the docs directory available here. Cuando tus cambios se fusionen, estarán disponibles automáticamente en la página web.

Estructura del sitio

El sitio es generado utilizando docsify, y servido por medio de GitHub Pages.

Normalmente, no necesitarías cambiar ninguna configuración o construir el sitio localmente. En caso de que te interese, así es cómo funciona:

  • El código de la página de inicio para este sitio está disponible en docs/index.html.
  • Servimos este archivo como SPA utilizando docsify y GitHub Pages.
  • El script docsify genera el contenido de los archivosmarkdown en el directorio docs en demanda.
  • La página de inicio se genera a partir del _coverpage.md.
  • La barra de navegación lateral es generada desde _sidebar.md.

Sirviendo el sitio de documentación localmente

Clona freeCodeCamp:

git clone https://github.com/freeCodeCamp/freeCodeCamp.git
docsify serve docs

Instala docsify:

npm install -g docsify

y sirve el directorio /docs

docsify serve docs

Alternativamente, si ha instalado freeCodeCamp localmente (vea la guía de configuración local), empaquetamos la CLI con las herramientas de desarrollo para que puedas ejecutar cualquiera de los siguientes comandos según sea necesario desde la raíz del repo:

Servir y lanzar el sitio de documentación solamente

npm run docs:serve

Servir el sitio de documentación junto a freeCodeCamp localmente:

npm run develop

El sitio de documentación debería estar disponible en http://localhost:3200