輸出格式化文本（包括源代碼）作為LaTeX，PDF和HTML

Question

我正在使用代碼清單編輯乳膠中的許多文檔，目前輸出為pdf。

由於我在這些文檔的團隊中工作，我經常需要手動將組成員所做的更改集成到latex源中。

大多數小組成員都不知道乳膠，所以我想有辦法讓他們以類似於降價的方式進行文件格式化。

由於乳膠文檔由數字組成，有引用並使用lslisting包，我想知道是否可以將這些特定區域映射到簡單的markdown樣式語法。

工作流程示例：

• 在Markdown（或類似）中編輯文件
  • 標簽部分
  • 標記代碼區域
  • 標簽數字
  • 標簽引用
• 轉換為乳膠
  • 自動轉換標簽
• 產量
  • PDF格式
  • HTML

它能以某種方式實現這樣的工作流程嗎？ 也許我的特定工作流程已有解決方案？

Answer 1

這是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

或者到LaTeX：

rst2latex example.rst example.tex

然后編譯生成的LaTeX文檔：

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

用於從多個來源生成文檔的更全面的框架是Sphinx ，它基於Docutils並專注於技術文檔。

Answer 2

你應該看看pandoc （至少如果我理解你的問題）。 它可以在多種格式（tex，pdf，word，reStructuredText）之間進行轉換，並且還支持markdown語法的擴展版本，以處理更復雜的問題（例如，在html中插入標題信息）。

有了它你可以混合markdown和LaTeX，然后編譯為html，tex和pdf。 您還可以包含外部文件中的bibtex引用。

一些例子（從markdown到latex和html）：

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

要添加自己的LaTex模板，從markdown到pdf，以及參考書目：

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

它真的是一個靈活而精彩的程序，而且我自己也在使用它。

Answer 3

你看過Docutils嗎？

Answer 4

如果您是Emacs用戶，您可以根據自己的喜好找到org-mode的標記。 它對表格有很好的支持，可以很好地與電子表格等其他Emacs模式進行協調，並且可以很好地將圖像導出為HTML。 參看 精細手冊的HTML導出部分 。

對於不使用它的團隊成員，可以在Emacs外部編輯org-mode文件，盡管其他Emacs模式的預覽和嵌入當然只能通過Emacs完成。