Облегченный язык разметки (вики) для документирования

Question

Когда я пишу статьи или документацию, это заставляет думать, что использование LaTeX или OpenOffice является излишним, поскольку мне обычно нужны только некоторые элементы разметки (полужирный, заголовки, списки, ...). Я хотел бы написать свои документы, используя разметку стиля вики, поскольку это очень эффективно.

Например:

= Introduction =
'''HTML''' is a markup language...

В конце я хотел бы просто преобразовать его в PDF. (Кроссплатформенность тоже была хороша.)

compiler.exe -pdf input.wiki output.pdf

Есть ли инструмент (или простая цепочка инструментов) для этой работы?

Лично я хотел бы, чтобы не использовал LaTeX в качестве шага преобразования. Есть инструменты, которые делают эту работу, преобразовывая легкий синтаксис в TeX, а затем в PDF / PS.

Answer 1

Возможно, вы обнаружите, что MarkDown приближается к тому, что вы хотите.

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

Основная цель дизайна для Синтаксис форматирования Markdown заключается в сделать его как можно более читабельным. Идея состоит в том, что в формате Markdown документ должен быть опубликован как есть, в виде простого текста, не выглядя как это было отмечено тегами или инструкции по форматированию.

PanDoc выглядит так, как будто это хороший инструмент для конвертации MarkDown прямо в PDF-файлы. Вполне могут быть и другие варианты - PanDoc - лучший инструмент, который я нашел с помощью быстрого поиска в Google.

Answer 2

ReStructuredText .

Вы можете использовать Sphinx для генерации HTML и LaTeX (и более поздних PDF с pdflatex).

Существует также rst2pdf , не знаю, зрел ли он.

Answer 3

Вы можете использовать Markdown ( пример ) и затем использовать Pandoc (который также работает с reStructuredText и несколькими другими вики-подобными синтаксисами) для преобразования в PDF .