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.
Para trabajar en las pautas de contribución, puedes editar o agregar archivos al directorio
docs
, disponible aquí. 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 directoriodocs
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
Alternatively, if you have installed freeCodeCamp locally (see the local setup guide), we bundled the CLI with the development tools so you can run any of the below commands as needed from the root of the 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