2

Скажем, у меня есть руководство для компьютерной программы, написанное в формате markdown/org-mode. Руководство написано в виде книги с главами, разделами и подразделами.

Я знаю, что Pandoc может конвертировать этот файл Markdown в HTML. Но что, если я хочу преобразовать каждую главу (скажем) в свою собственную страницу HTML и указать ссылку на следующую и предыдущую главу или раздел?

Например, рассмотрим сайт, документирующий SWIG. http://swig.org/Doc3.0/Sections.html Это именно та структура, которую я хотел бы, чтобы вывод Pandoc был в моем файле уценки.

Я знаю, что latex2html может сделать это для латексных файлов, и что Pandoc может конвертировать уценку в латекс, но мне не нравится полученный результат. Я бы предпочел чистое решение pandoc без каких-либо внешних программ.

|источник

1 ответ1

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. Он производит великолепно выглядящий результат, и я очень рекомендую его.

|источник

Всё ещё ищете ответ? Посмотрите другие вопросы с метками .