Files
freeCodeCamp/docs/i18n/Portuguese/how-to-work-on-the-docs-theme.md
2020-10-02 00:28:40 +05:30

1.7 KiB

Como funcionar no tema de docs

[!NOTA] Um lembrete rápido de que você não precisa configurar nada para trabalhar no conteúdo do site de documentação.

Para trabalhar nas diretrizes de contribuição, você pode editar ou adicionar arquivos no diretório `` docs disponível aqui. Quando suas alterações são mescladas, elas serão disponibilizadas automaticamente no site de documentação.

Estrutura do site da documentação

O site é gerado usando docsify, e servido usando as páginas do GitHub.

Normalmente você não precisaria alterar nenhuma configuração ou construir o site localmente. Caso esteja interessado, aqui está como funciona:

  • A fonte da página inicial para este site está disponível em docs/index.html.
  • Servimos este arquivo como um SPA usando docsify e GitHub Pages.
  • O script docsify gera o conteúdo de arquivos markdown no diretório docs sob demanda.
  • A página inicial é gerada a partir do _coverpage.md.
  • a navegação na barra lateral é gerada a partir de _sidebar.md.

Servindo localmente o site de documentação

Clonar freeCodeCamp:

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

Instalar docsify:

npm install -g docsify

e serve o diretório /docs

docsify servir documentos

Como alternativa, se você tiver instalado o freeCodeCamp localmente (veja o guia de instalação local), nós empacotamos o CLI com as ferramentas de desenvolvimento para que você possa executar npm run docs:serve na raiz do repositório.