LINUX.ORG.RU

bgen-1.0 (BookGenerator) — генерация электронных книг (fb2, epub) из pandoc-markdown

 , , , ,


2

2

Вышел bgen 1.0 (BookGenerator) – свободная (GPLv3) программа на python+lua для генерации электронных книг (FB2, EPUB), а также DOCX и TXT. Представляет из себя набор обёрток вокруг pandoc для генерации целевых форматов.

FB2 является стандартом для русскоязычной прозы, но при этом ощущается нехватка инструментов, которые бы качественно поддерживали его генерацию.

Pandoc поддерживает FB2 очень ограниченно - путает порядок XML-элементов, не поддерживает множество тегов FB2.

Bgen:

  • Выполняет постобработку FB2 после генерации pandoc, а также через конфигурационный файл позволяет производить более тонкую настройку результата. После генерации и постобработки производится валидация FB2-файла по XSD.
  • Поддержана генерация EPUB. Здесь уже без постобработки – pandoc поддерживает формат на должном уровне.
  • Генерация DOCX может быть полезна для отправки рукописей редактору / корректору / издателю.
  • Генерация TXT (plain text) также поддержана с постобработкой (добавляется карточка книги, возможны и дальнейшие изменения).
  • Через фильтр pandoc реализована настраиваемая работа с русской типографикой. В текстовом файле описываются сокращения для типографских символов, используемые в исходниках на pandoc-markdown и в результирующей сборке вы получаете нужную типографию.

Подробное описание возможностей в readme проекта и в приложенном примере проекта книги.

>>> Репозиторий на github

★★★

Проверено: hobbit ()
Последнее исправление: hobbit (всего исправлений: 4)

Если

Pandoc поддерживает FB2 очень ограниченно

то почему бы его не дополнить вместо изобретения своего велосипеда?

Myau ★★★★★
()
Ответ на: комментарий от Myau

то почему бы его не дополнить вместо изобретения своего велосипеда?

Рассматривал и вариант запилить свой врайтер на основе пандоковского, но в итоге пришёл к текущему решению.

  • Поддержка fb2 в pandoc не развивается, патчи отклоняются, баги долго не чинятся. Можно, конечно встать в очередь, но проблему хотелось решить здесь и сейчас.
  • Форкать pandoc, если патчи долго не принимаются, тоже не мой путь. Это много лишнего кода.
  • Сейчас у меня максимальный контроль над решением.
  • Постобработка и свои fenced-div всё равно нужны. Так как pandoc в своём AST не имеет эпиграфов, например. И требуется сначала их разметить в md-исходниках, а потом правильно сформировать результат. Также AST не отслеживает схему FB2, а валит всё так, как подано в md. То есть тут доработка комплексная - с обеих сторон. Да и нужна внешняя валидация. И что-то я решил не соваться со всем этим в разработку pandoc.

Итого, доработать части pandoc можно, но не очень понятно, что с ними потом делать. И так или иначе для комфортной работы нужен какой-то обвес. По карйней мере, так я это сейчас вижу.

lv ★★★
() автор топика
Последнее исправление: lv (всего исправлений: 3)
Ответ на: комментарий от Myau

Я не автор, но тоже в своё время интересовался проблемой «как бы нам пропатчить pandoc».

И начать надо с того, что написан он на Хаскеле. Ну я, собственно, этим и закончил. Была бы Java, Rust, Go – ну хоть что-нибудь императивное или хотя бы смешанное – я бы ещё побрыкался. Но чистое ФП для меня слишком сильная ломка мозга.

hobbit ★★★★★
()
Последнее исправление: hobbit (всего исправлений: 1)

Посмотрел на гитхабовскую ссылку, добавил тег «от автора». ;)

hobbit ★★★★★
()
Ответ на: комментарий от hobbit

«Опа! А мотив?»

Не конкретно мои, я им патчи не слал. Но в приципе что-то такое нагугливалось. Но может и наИИшивалось, так что утверждать не буду. То, что сейчас сходу нашёл и что характеризует поддержку fb2 в pandoc:

lv ★★★
() автор топика
Ответ на: комментарий от kaldeon

Зато взгляните на другую половину - отборнейший маркдаун! :)

Считаю, что документация должна быть там, где она не разойдётся с действительностью и отыскивается в тот момент, когда нужна. В случае конфиги - конфига и есть то самое место. Городить отдельный файл с докой - зачем?

lv ★★★
() автор топика
Для того чтобы оставить комментарий войдите или зарегистрируйтесь.