Como Compilar o Material com o Sphinx¶
Instalar o Python¶
- Usar preferencialmente a versão 3.
- Ambientes Unix provavelmente já possuem ele instalado.
- Pode ser encontrado em https://www.python.org/downloads/.
- No Windows, durante a instalação marcar para instalar o “pip” também.
Instalar as Dependências¶
Dentro do diretório do código do material executar:
pip install -r requirements.txt
Compilar o Material¶
Para listar as opções de compilação execute:
make help
Alguns exemplos:
- HTML
make html
make latexpdf
Nota
É necessário que o LaTeX esteja instalado no sistema para gerar o PDF.
- ePub
make epub
Nota
Após a execução do comando, o material compilado, junto com alguns outros arquivos, podem ser encontrados dentro do diretório _build
na raíz do projeto.