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

各位版上大家好,這篇是小弟於 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

回到顶部