基於 json/markdown 生成網頁及LaTeX pdf 格式的 document 生成器
发布于 7 年前 作者 kevinbird61 4157 次浏览 来自 分享

各位版上大家好，這篇是小弟於 CNode 上第一篇文章，還請大家多多包涵

我與我的夥伴最近開發一個主打 document generator 的專案 - docoGen。主要是透過 JSON 與 Markdown 編寫腳本，再將這些腳本生成出靜態網頁 docoGen-WebUI、LaTeX PDF 等說明文件，並且主要使用 nodejs 來做開發， 未來還會繼續擴充

目前是由 docoGen 這個專案內制定腳本格式，並且由多個模組讀取腳本格式後做輸出（Ex: LaTeX & static website），希望之後能夠支援多種模組

當初開發 docoGen 是希望團隊能快速的產生一個產品說明文件以及產品的介紹網站，另一方面也可以用於教材上面，可以生成上課用的講義以及對應的教學網站，提供學生以及有需求的其他人做檢視與閱讀

由於目前還是剛起步階段，如果有任何對於 docoGen 的想法，對我們來說都是一個學習以及改進、讓他更加完善的寶貴意見！ 如果對 docoGen 覺得不錯的話，也可以給 star 支持一下喔！

docoGen 中文簡易說明 docoGen （生成 LaTeX 模版）源碼 docoGen-WebUI（生成靜態網頁模版）源碼

關於如何編寫腳本格式與 docoGen 詳細規格 分別在下面兩個部份的 wiki 內做詳細說明 docoGen wiki docoGen-WebUI wiki

最後附上生成的文件與網站 (來自同份腳本)

以下文件部份由於 LaTeX 支援多種 document type，目前列出能夠不需要改動情況下直接做生成的格式

10 回复

Hi, would you show me a example what converting a markdown document to a LaTeX ( or a PDF) directily ? From https://github.com/toolbuddy/docoGen-script-example , I have seen json only. But I think that converting json to a document is useless.

@yszou In the testbed here

The folder named md-script contains the currently format of markdown script.

And using the method in test/convert-md2docoGen.js to convert this script and then generate LaTeX pdf.

More detail of markdown script format goes here.

Thanks for your reply!

挺好的项目，加油

@i5ting 感謝支持！

可以的，顶一个

@burning0xb 感謝支持！

能不能加个中文文档呢？感谢，英文看着有些吃力。繁体中文也没关系。

@JZLeung 哈哈 好的 這正是我們現在準備要做的部份 可能我們英文也是不是很正統 真不好意思 (；´ﾟωﾟ｀人) 未來會在更新的同時附上中文的翻譯 如果願意的話 也很歡迎大家來做中文文檔~

@kevinbird61 不不不，我的意思是，我的英文水平跟不上，看不懂大片的英文文档。/(ㄒoㄒ)/~~

@JZLeung

前幾天由於考試的關係 耽誤了一些時間 目前已經翻譯完大部份的中文文檔，附上連結

功能在前幾天支援了 graphviz 的繪圖，但目前只有 Linux 平台支援 window 的還在處理 cmd.exe 以及 powershell 運行 dot 的權限問題 應該會再幾天內完成並且 publish

還請各位多多支持了 d(`･∀･)b

回到顶部