symfony-docs-pt-BR icon indicating copy to clipboard operation
symfony-docs-pt-BR copied to clipboard

Sphinx, conf.py, compartilhar

Open rogeriopradoj opened this issue 10 years ago • 3 comments

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 avatar Mar 03 '14 23:03 rogeriopradoj

Minha renderização: documentao_do_symfony2__symfony_docs_pt-br_2_4_documentation

Renderização @andreia: fundamentos_de_symfony_e_http__symfony2_documentation_2_documentation

rogeriopradoj avatar Mar 03 '14 23:03 rogeriopradoj

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

andreia avatar Mar 04 '14 18:03 andreia

Legal, @andreia, valeu!

Estou tentando seguir o PR https://github.com/symfony/symfony-docs/pull/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!

rogeriopradoj avatar Mar 04 '14 18:03 rogeriopradoj