Расширяемый легкий язык разметки

Question

Легкие языки разметки предлагают фиксированный набор функций.Этот набор функций растет, но каждый раз, когда я пишу более сложную статью, я должен понимать, что чего-то не хватает.Примеры включают в себя: правильные подписи к изображениям, таблицу рисунков, включение файлов, перекрестные ссылки и т. Д. Поэтому я в конечном итоге создаю цепочку инструментов вокруг нее с помощью команд Makefile и tricky sed.

Обычно я хочу вставитьспециальные маркеры в мой текст и обработать их позже.Они могут быть однострочными или более сложными - и в этом случае весь подход регулярных выражений терпит неудачу.Вот фрагмент воображаемой разметки.

I can generate an image from an external dot file [.myDot diag.dot The process],
and it will be included with a caption.
Or the dot source is right here [.myDotHere
  foo->bar->Done;
]

Я ищу инструмент разметки, который можно легко расширить для соответствия моим специальным потребностям.Опции, которые я нашел до сих пор

• Makefile, пре- и постобработка с помощью сценариев sed / perl
• Встроенная предварительная обработка регулярных выражений в txt2tags
• Pandoc анализирует уценку во внутренний AST , который может быть преобразован с помощью скриптов на Haskell

Итак, я ищу

• языкразработан с учетом настроек и расширяемости
• легкий вес;нет TeX / LaTeX, пожалуйста
• не то, что решает все мои специфические проблемы, но не расширяемое
• Мой вывод обычно просто html, поэтому он не должен поддерживать много целей

Answer 1

Я создал Глиф с учетом расширяемости. Вы можете создавать свои собственные макросы, используя либо сам Glyph, либо Ruby.

Glyph призван облегчить публикацию, предоставляя автору все возможные возможности управления, он может управлять метаданными книги, ToC, внутренними ссылками, фрагментами и т. Д. И т. Д.

Для получения документации по всем его функциям обратитесь к Книге глифов , которая была создана с использованием самого глифа.

Answer 2

Ваш подход "toolchain" хорош - вы не найдете в IMO ни одного проекта, который бы отвечал вашим конкретным потребностям, лучше всего следовали бы философии * nix и использовали лучший инструмент для работы, которая включается в вашу открытую цепочку инструментов.

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

ВыборРазметка должна быть IMO, основываясь на доступности инструментов трансформации для желаемого результата.IMO Pandoc, безусловно, является наиболее активно разработанным проектом в этой области, и очень гибким, особенно с его возможностью сценариев.Обратите внимание, что он также очень хорошо поддерживается в GoogleGroups - Джон, вероятно, будет быстро и быстро реагировать на любые проблемы, которые могут у вас возникнуть.

Обратите внимание, что гибкость Pandoc также означает, что ваш основной исходный текст не так «заблокирован», как вы.может легко конвертировать, например, из расширенного синтаксиса уценки в reST, если, скажем, вы хотите воспользоваться возможностями Sphinx или DocBook.(Кстати, также ознакомьтесь с AsciiDoc, который является последним выходом Pandoc - очевидно, читатель также находится в разработке)

Посетите вики-страницу Pandoc "extras", меня особенно порадовал сценарий фильтра ConTeXt;Я не уверен, что он вам подойдет, но он включает некоторые возможности макросов, и IMO ничего не даст вам лучшего типографского контроля.