Преобразование файла уценки в серию файлов HTML
Скажем, у меня есть руководство для компьютерной программы, написанное в формате markdown / org-mode. Руководство написано в виде книги с главами, разделами и подразделами.
Я знаю, что Pandoc может конвертировать этот файл Markdown в HTML. Но что, если я хочу преобразовать каждую главу (скажем) в свою собственную страницу HTML и указать ссылку на следующую и предыдущую главу или раздел?
Например, рассмотрим сайт, документирующий SWIG. http://swig.org/Doc3.0/Sections.html Это именно та структура, которую я хотел бы, чтобы вывод Pandoc был в моем файле уценки.
Я знаю, что latex2html может сделать это для латексных файлов, и что Pandoc может конвертировать уценку в латекс, но мне не нравится полученный результат. Я бы предпочел чистое решение pandoc без каких-либо внешних программ.
1 ответ
Это не совсем тривиально. Хорошим подходом было бы написать собственный HTML-шаблон, который будет использоваться pandoc.
% pandoc -D html > my-page-template.html
# edit my-page-template.html to your liking
Этот шаблон может включать ссылки на предыдущую и следующую страницу, если таковые имеются.
$if(next-page)$<a href="$next-page$">next</a>$endif$
Соответствующие имена файлов будут передаваться через командную строку, поэтому pandoc может вставить правильные значения.
pandoc -M next-page=introduction.html --template=my-page-template.html …
Сценарий-обертка, написанный на shell или другом скриптовом языке, вероятно, будет полезен.
Как видите, это может стать довольно трудоемким делом. К счастью, кто-то уже сделал все это и упаковал его в пакет R: bookdown. Он производит великолепно выглядящий результат, и я очень рекомендую его.