用該項目的源代碼創建一個文檔

Question

我有一個包含很多源代碼的項目。出於文檔目的，我必須將所有源代碼合併到一個文件中，例如PDF，HTML或DOCX。優選地，每個合併的文件內容應該具有與其相對來源的標題。不錯的格式是需要的，但不是強制性的。

有沒有人做過這個任務？有沒有簡單的代碼片段來自動執行任務？奇怪的是，我四處搜尋，沒有發現任何關於這個挑戰的提示。

Answer 1

如果在某種UNIXish上，a2ps做了一個非常好的工作，打印大量的源到postscript，這很容易通過例如轉換爲PDF。 ps2pdf。喜歡的東西：

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

這會甩了你在命令行上指定的所有源（你可以去用遞歸查找和xargs的或類似的一些組合）。如果您不需要全部源代碼轉儲，那麼您可能最好閱讀您的語言本地源文檔（如doxygen或javadoc或類似文檔）。大多數源文件記錄系統可以輸出到一攬子格式ime。