Sphinx, conf.py, compartilhar

[rogeriopradoj]

Olá @andreia, será que você poderia compartilhar o conf.py que você está usando para renderizar a documentação nas urls http://andreiabohner.org/symfony2docs/index.html e http://andreiabohner.org/symfony2docs/2.0/index.html?

Segui a orientação oficial, http://symfony.com/doc/current/contributing/documentation/format.html, mas acho que não ficou 100%. Pelo menos o tema está bem diferente das urls que você renderiza.

O conf.py que usei (gerado pelo sphinx-quickstart versão 1.2.2) está nesse gist aqui: https://gist.github.com/rogeriopradoj/9336640

Valeu

P.S.: Se houver mais arquivos necessários e talvez algum tutorial que você aconselha para renderizar bem o projeto, ia ser muito útil também!!!

[rogeriopradoj]

Minha renderização:

Renderização @andreia:

[andreia]

Olá Rogério,

Personalizei vários arquivos, não lembro agora todos que foram, mas vou verificar e escrever um tutorial :)

Caso precisar, renderizei as versões atuais em:

2.4 - http://andreiabohner.org/symfony2docs/2.4/index.html
2.3 - http://andreiabohner.org/symfony2docs/2.3/index.html
2.2 - http://andreiabohner.org/symfony2docs/2.2/index.html
2.1 - http://andreiabohner.org/symfony2docs/2.1/index.html
2.0 - http://andreiabohner.org/symfony2docs/2.0/index.html

Estou escrevendo um script também para automatizar esta parte, então aplicarei os PRs existentes todo sábado no repositório e já serão atualizados os endereços acima também.

Abraços,
Andréia

[rogeriopradoj]

Legal, @andreia, valeu!

Estou tentando seguir o PR symfony/symfony-docs#3328, eles já estão se preparando para deixar isso mais automatizado (pelo menos no branch master acredito) para rodar no Travis.

Fico esperando as novidades daqui!

Até mais!