Ferramentas para Markdown e restructuredText

Na minha cruzada para encontrar um jeito de renderizar automaticamente minhas documentações escritas em Markdown e restructuredText, encontrei algumas ferramentas muito úteis. Markdown é a minha linguagem de marcação leve favorita. Este blog é escrito principalmente em Markdown, graças ao Markdown on Save Worpress Plugin. Eu ainda utilizo para escrever tutoriais simples, notas de instalação passo-a-passo, ou para guardar algumas dicas de RegEx, por exemplo. E restructuredText pode ser utilizado com a mesma função, e graças a algumas ferramentas poderosas, é um excelente para escrever documentações longas, ou mesmo um livro (Symfony2 docs e seus livros são escritos em restructuredText). Mas… é […]

Documentação Symfony2 local em HTML , ePub e (yes!) PDF

Muitos ainda estão procurando no site da documentação do Symfony2 como baixar uma versão em PDF com existe na versão 1.4, mas infelizmente não está disponível. Particularmente eu prefiro navegar em HTML,  mas no site evidentemente não é a forma mais ágil. Tentando baixar a documentação manualmente (trabalho de índio) encontrei a referência ao formato utilizado, o reStrucuturedText: Symfony – Documentation Format E lá a orientação para utilizar o Sphinx (não o indexador, mas o gerador de documentação em Python) para gerar a documentação em HTML, Latex, ePub e em PDF. Sem PDF até o momento (atualizado) Mas, até o […]