我在维基百科页面(文档生成器的比较)中看到 pandoc 可以用作文档生成器(就像 doxygen 一样)。
但是我没有在 pandoc 的文档或它的站点中找到一种从源代码注释中提取文档的方法,就像其他文档生成器那样。
那么我该如何使用 pandoc 来做到这一点呢?有没有办法从代码注释中提取 pandoc 的标记语言并从中创建 PDF 或 HTML 文档?还是维基百科的比较列表有误?
我在维基百科页面(文档生成器的比较)中看到 pandoc 可以用作文档生成器(就像 doxygen 一样)。
但是我没有在 pandoc 的文档或它的站点中找到一种从源代码注释中提取文档的方法,就像其他文档生成器那样。
那么我该如何使用 pandoc 来做到这一点呢?有没有办法从代码注释中提取 pandoc 的标记语言并从中创建 PDF 或 HTML 文档?还是维基百科的比较列表有误?
采用http://www.ucalgary.ca/rzach/blog/2014/05/simple-way-to-document-code-with-markdown-grep-and-pandoc.html中描述的方法作为 mb21 提到了一个 bash 脚本像下面的那样做这项工作
"makedoc"
#!/bin/bash
grep -e "^%" -e "^$$" $1.tex | cut --bytes=3-| pandoc -f markdown -o $1.pdf