Digamos que eu tenha um manual para um programa de computador escrito no formato markdown/org-mode. O manual foi escrito como um livro com capítulos, seções e subseções.
Eu sei que o Pandoc pode converter este arquivo Markdown para HTML. Mas e se eu quiser converter cada capítulo (digamos) em sua própria página HTML e vincular ao capítulo ou seção seguinte e anterior?
Por exemplo, considere o site que documenta o SWIG.http://swig.org/Doc3.0/Sections.htmlEsta é precisamente a estrutura que eu gostaria que a saída do Pandoc tivesse no meu arquivo markdown.
Eu sei que latex2html pode fazer isso, para arquivos Latex, e que Pandoc pode converter markdown em latex, mas não gosto da saída resultante. Eu preferiria uma solução pandoc pura que não envolvesse nenhum programa externo.
Responder1
Isto não é totalmente trivial. Uma boa abordagem seria escrever um modelo HTML personalizado para ser usado pelo pandoc.
% pandoc -D html > my-page-template.html
# edit my-page-template.html to your liking
Esse modelo pode incluir links para a página anterior e a próxima, se houver.
$if(next-page)$<a href="$next-page$">next</a>$endif$
Os respectivos nomes de arquivos seriam passados através da linha de comando, para que o pandoc possa inserir os valores corretos.
pandoc -M next-page=introduction.html --template=my-page-template.html …
Um script wrapper escrito em shell ou alguma outra linguagem de script provavelmente seria útil.
Como você pode ver, isso pode se tornar um pouco trabalhoso. Felizmente, alguém já fez tudo isso e empacotou em um pacote R:livro de registro. Ele produz resultados de excelente aparência e eu o recomendo fortemente.