Digamos que tengo un manual para un programa de computadora escrito en formato markdown/modo org. El manual está escrito como un libro con capítulos, secciones y subsecciones.
Sé que Pandoc puede convertir este archivo Markdown a HTML. Pero, ¿qué pasa si quiero convertir cada capítulo (digamos) en su propia página HTML y vincularla al capítulo o sección siguiente y anterior?
Por ejemplo, considere el sitio web que documenta SWIG.http://swig.org/Doc3.0/Sections.htmlEsta es precisamente la estructura que me gustaría que tuviera el resultado de Pandoc en mi archivo de rebajas.
Sé que latex2html puede hacer esto, para archivos Latex, y que Pandoc puede convertir Markdown a látex, pero no me gusta el resultado resultante. Preferiría una solución pandoc pura que no involucre ningún programa externo.
Respuesta1
Esto no es del todo trivial. Un buen enfoque sería escribir una plantilla HTML personalizada para que pandoc la utilice.
% pandoc -D html > my-page-template.html
# edit my-page-template.html to your liking
Esa plantilla podría incluir enlaces a la página anterior y siguiente, si corresponde.
$if(next-page)$<a href="$next-page$">next</a>$endif$
Los nombres de archivo respectivos se pasarían a través de la línea de comando, para que pandoc pueda insertar los valores correctos.
pandoc -M next-page=introduction.html --template=my-page-template.html …
Probablemente sería útil un script contenedor escrito en shell o algún otro lenguaje de scripting.
Como puede ver, esto puede resultar bastante trabajoso. Afortunadamente, alguien ya hizo todo esto y lo empaquetó en un paquete R:reserva. Produce resultados de gran apariencia y lo recomiendo ampliamente.