Documentação¶
Atualizar ou adicionar novas páginas¶
Os arquivos-fonte da documentação ficam em docs_src/source e usam o formato RST. As traduções ficam em docs_src/source/locale/<language>/LC_MESSAGES como arquivos gettext .po.
Nota
Se você adicionar uma nova página, inclua-a em docs_src/source/index.rst ou em um toctree filho, depois execute make docs para atualizar os catálogos de tradução.
Gerando a documentação¶
Gere a documentação HTML bilíngue localmente:
make docs
A documentação gerada é escrita em docs:
docs/index.htmlé o seletor de idioma.docs/en/contém a documentação em inglês.docs/pt-br/contém a documentação em português.docs/.nojekylledocs/.buildinfosão criados na raiz para o GitHub Pages.
Limpando a documentação gerada¶
make clean-docs