Инструментарий публикации с вводом asciidoc/markdown, выводом html/pdf

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

Один отличный пример, который я нашел, — это этот проект от akosma.

Авди Гримм поделился своей работой с org-mode в этом проекте

Я знаю, что есть (должны быть) многие другие.

То, что я ищу, это набор инструментов для публикации с

  • asciidoc/markdown/textile/org-mode или ввод в латексе. Я не хочу вводить xml
  • Вывод в формате pdf И html, вывод в формате epub для меня не обязателен.

Что я могу

  • авторские шаблоны в латексе/html/css/js. опять нет xml.
  • читать и писать скрипты ruby ​​и shell

person Alper Karapınar    schedule 10.07.2012    source источник
comment
Используйте pandoc. Но это не Руби.   -  person Martin Schröder    schedule 11.07.2012
comment
Да, pandoc — отличный конвертер, или dblatex.. но то, что я ищу, более готово к использованию шаблонов скриптов + css + латекса (если есть), берет ваш markdown/asciidoc и конвертирует их в блестящие документы в pdf/html. Я точно знаю, что использую шаблон Адриана. Но спрашивал, есть ли подобные.   -  person Alper Karapınar    schedule 11.07.2012
comment
Pandoc включает шаблоны по умолчанию для всех типов вывода. Кстати, есть привязки ruby: rdoc.info/github/alphabetum/pandoc-ruby github.com/alphabetum/pandoc-ruby   -  person applicative    schedule 12.07.2012


Ответы (1)


Взгляните на asciidoc, это то, что O'Reilly начал использовать, и это освежающий перерыв от DocBook. Я использую asciidoc, инструменты и поддержка оставляют желать лучшего, но есть люди, работающие над созданием лучших альтернатив (которые не включают Python и существующий конвейер Docbook).

Проверьте это: https://github.com/runemadsen/asciidoc

EDIT 06.01.13: Вам также действительно нужно проверить AsciiDoctor. Дэн Аллен из RedHat потратил много времени на этот конкретный пакет и Райана Уолдрона. Я ожидаю больших успехов от AsciiDoctor, поскольку он начинает появляться в качестве основы для множества важных усилий по документированию AsciiDoc.

person Tim O'Brien    schedule 29.11.2012
comment
Большое спасибо, я видел этот репозиторий, когда задавал этот вопрос, но никогда не пробовал. Приятно видеть, что люди активно работают над этим, и есть конечный продукт, созданный с их помощью. Я обязательно попробую это как можно скорее. - person Alper Karapınar; 29.11.2012
comment
Спасибо, что указали мне на asciidoctor. Мне очень нравится нативный рубин, к сожалению документации пока не хватает. - person DavidG; 06.03.2013
comment
Поработав некоторое время с Asciidoctor, я нашел его настолько замечательным, что представил его нашей команде технических специалистов и помог им перенести в него нашу документацию. Спасибо! огромная экономия времени из этого небольшого поста. - person DavidG; 01.09.2014
comment
Тоже некоторое время пользуюсь asciidoctor. Они добились большого прогресса с тех пор, как я задал вопрос. Эта ссылка и эта ссылка особенно полезна для всех, кто заинтересован. - person Alper Karapınar; 23.02.2015