Text 使用项目的源代码创建文档

Text 使用项目的源代码创建文档,text,documentation,Text,Documentation,我有一个有很多源代码的项目。出于文档目的,我必须将所有源代码合并到一个文件中,例如,PDF、HTML或DOCX。最好是,每个合并的文件内容都应该有一个带有相对原点的标题。良好的格式是需要的,但不是强制性的 有人做过这个任务吗?是否有任何简单的代码片段可以自动完成任务?奇怪的是,我四处搜索,没有找到任何关于这项挑战的提示。如果是UNIXish,那么将大量源文件打印到postscript上的工作非常出色,然后通过例如将其转换为PDF非常简单。比如: a2ps *.c -o foo.ps ps2pdf

我有一个有很多源代码的项目。出于文档目的,我必须将所有源代码合并到一个文件中,例如,PDF、HTML或DOCX。最好是,每个合并的文件内容都应该有一个带有相对原点的标题。良好的格式是需要的,但不是强制性的

有人做过这个任务吗?是否有任何简单的代码片段可以自动完成任务?奇怪的是,我四处搜索,没有找到任何关于这项挑战的提示。

如果是UNIXish,那么将大量源文件打印到postscript上的工作非常出色,然后通过例如将其转换为PDF非常简单。比如:

a2ps *.c -o foo.ps
ps2pdf foo.ps foo.pdf

这将转储您在命令行上指定的所有源(您可以使用find和xargs或类似的组合进行递归)。如果您不需要一个完整的源代码转储,那么最好阅读您的语言的原生源代码文档(比如doxygen或javadoc或类似工具)。大多数源文档管理器系统都可以在ime中以多种格式输出。

谢谢您的建议。我实际上使用的是Windows,但运行任何unix的东西都不会有问题。我怀疑unix更适合这种类型的任务。我将尝试一下并更新结果。我使用了a2ps()的windows端口,它工作得非常好。在类似的情况下,我绝对推荐它。再次感谢!不客气,先生!