Вывод форматированного текста (включая исходный код) в формате LaTeX, PDF и HTML - PullRequest
Новая
       12

Вывод форматированного текста (включая исходный код) в формате LaTeX, PDF и HTML

7 голосов
/ 19 января 2011

Я редактирую много документов в латексе, которые состоят из списков кодов и в настоящее время выводятся в формате PDF.

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

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

Поскольку латексные документы состоят из рисунков, имеют ссылки и используют пакет lslisting , мне интересно, можно ли было бы отобразить эти конкретные области в простой синтаксис стиля уценки.

Пример рабочего процесса:

  • Редактировать файл в Markdown (или аналогичный)
    • разделы тегов
    • области кода тегов * тег 1018 *
    • цифры
    • ссылки на теги
  • преобразование в латекс
    • автоматическое преобразование тегов
  • вывод
    • pdf
    • html

Возможно ли как-то достичь такого рабочего процесса?Может быть, уже есть решения для моего конкретного рабочего процесса?

Ответы [ 4 ]

2 голосов
/ 20 января 2011

Вот пример для Docutils. 

Title
=====

Section
-------

.. _code:

Code area::

  #include <iostream>
  int main() {
    std::cout << "Hello World!" << std::endl;
  }

.. figure:: image.png

   Caption for figure

A reference to the code_


Another section
---------------

- Itemize
- lists

#. Enumerated
#. lists

+-----+-----+
|Table|Table|
+-----+-----+
|Table|Table|
+-----+-----+

Сохранить как example.rst. Затем вы можете скомпилировать в HTML: 

rst2html example.rst example.html

или в латекс: 

rst2latex example.rst example.tex

затем скомпилируйте получившийся документ LaTeX: 

pdflatex example.tex
pdflatex example.tex  # twice to get the reference right

Более всеобъемлющей структурой для создания документов из нескольких источников является Sphinx , которая основана на Docutils и фокусируется на технической документации.

1 голос
/ 14 июня 2013

Вы должны посмотреть на pandoc (по крайней мере, если я правильно понимаю ваш вопрос). Он может конвертировать между несколькими форматами (tex, pdf, word, reStructuredText), а также поддерживает расширенные версии синтаксиса уценки для обработки более сложных проблем (например, вставка информации заголовка в html).

С его помощью вы можете смешать markdown и LaTeX, а затем скомпилировать в html, tex и pdf. Вы также можете включить ссылки на bibtex из внешнего файла.

Некоторые примеры (от уценки до латекса и HTML): 

pandoc -f markdown -t latex infile.txt -o outfile.tex
pandoc -f markdown -t html infile.txt -o outfile.html

Чтобы добавить собственный шаблон LaTex, переходящий от уценки к pdf, и библиографию: 

 pandoc input.text --template=FILE --bibliography refs.bib -o outfile.pdf

Это действительно гибкая и потрясающая программа, и я сам ею пользуюсь.

1 голос
/ 19 января 2011

Вы смотрели на Документы ?

0 голосов
/ 20 января 2011

Если вы пользователь Emacs, вам может понравиться разметка org-mode.Он имеет очень хорошую поддержку таблиц, хорошо координирует работу с другими режимами Emacs, такими как электронная таблица, и имеет хороший экспорт изображений в HTML.Ср раздел HTML-экспорта тонкого руководства .

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

...