2014年12月4日

GitBook + PlantUML 以 Markdown 快速製作 UML 教材


GitBook 是使用 Markdown 編寫電子書的工具及平台。

Markdown 寫書在技術圈已經風行多年,而 GitBook 完美整合了 Git 版本控制,甚至直接串接 GitHub,讓寫作技術書籍更加方便。最近火紅的柯P的市政白皮書也是利用 GitBook 發行。

最近應邀到彰化某科大擔任「系統分析與設計」課程的業師,教材的準備我想拋棄去年的 Slide 作法,直接改用最近長時間投入使用的 GitBook。

使用 Markdown 格式編寫教材講義,最方便之處就是文字和程式很容易修改。所以上課過程還可以隨時增刪講義內容,即時更新發佈給學生。GitBook 平台幫了很大的忙,基本需要的功能它都能做到了(過去為做到自動化的 publish 我們甚至自己開發了 ContPub 平台XDDD)。

GitBook 本身的 off-line editor 用起來效率不佳,我還是習慣用 Vim 或 Sublime Text 編寫文字。

Markdown 的即時 Preview 是很多人在意的功能,GitBook editor 有提供 preview,但是經常遇到 crash 問題,所以我改用 console 下的 gitbook command-line 工具,這是利用 Node.js 開發的 client tool,用來將 Markdown 原始檔轉成電子書格式。

編寫軟工、系統分析的教材,最麻煩的地方就是一些 UML 繪製,每次的修改都需要找到原始檔,做完再匯出成圖片。

我找到一個 PlantUML for GitBook Plugin,這個延伸工具很棒,自動將 Markdown 裡面的 UML code block 自動轉成 SVG 的圖片。

UML code block 看起來像這樣:


轉換出來的結果(利用 gitbook serve 搭配瀏覽器 livereload 即時預覽電子書呈現效果):


原始的 PlantUML Plugin 不好用,而且 commit 到 GitBook 的 source 也無法正常轉檔,所以我 fork 一份 plugin 自己修改成堪用的版本。

GitBook PlantUML Plugin
https://github.com/lyhcode/gitbook-plugin-plantuml

這個版本修正一些問題,讓生成的圖片可以依照 section file name 放置在 .md 的相同路徑下。重要的是重新以「gitbook-plugin-plantuml」發佈到 NPM,讓 GitBook 遠端轉檔也能順利 pass(但真正的轉檔工作只能在 local 進行)。

花了幾個小時才搞定整個流暢的 UML 教材編寫流程,但做好之後真的讓教材開發效率提高不少 : ) 感謝 GitBook 讓我可以吃自己的狗食(Eat my own dog food),自己的教材自己寫,自己的教材開發工具也能自己擴充 : )


2014年11月20日

生產履歷掛保證,來自雲林的新鮮柳丁,由雲端農場產地現採新鮮直送



2014 年的新鮮柳丁開始採收囉,跟大家分享一個採買柳丁的好管道,只要上網訂購就能宅配到府,而且是產地新鮮現採,還有生產履歷掛保證。

雲端農場

在食安疑雲籠罩的台灣,連以前認為吃了很健康的水果,都可能有危險農藥殘留或是為了搶收保鮮而添加防腐或催熟藥劑。雲端農場的柳丁每箱都有附生產履歷,可以讓消費者上網輸入批號就能查詢栽種記錄,透明化的 E 化農場管理流程,更能保障消費者的健康。

----

在食品與農產品安全問題叢生之際,雲科大工管系雲端農業實驗室,多年來嘗試將製造業管理經驗與系統導入田間,開發食品足跡管理系統並上線應用。 實驗室在今年創業成立創毅資訊公司,正式投入農業服務,專職全年追蹤管理農場的進、產、銷、存及檢驗,建立可徵信的農產品足跡。我們的使命在讓消費者以平價購買到安全優質的農產品、讓農民以企業化經營農場得到合理收入、並讓雲科大投入新一代雲端農業的創新創業。

  1. 提升農民收入,協助農民維持生計。
  2. 農場管理電子e化,真實反映農產品原物料使用、栽種過程、農藥檢驗結果。
  3. 推廣農產品生產履歷,提供民眾品質優良且安全有保障的農產品。
  4. 培訓農業管理人才,提供社會創新就業機會。
  5. 擴展工業工程與管理系在農業的藍海應用領域,培養訓練學生解決相關問題的能力。

2014年專用訂購單

讓柳丁活出柳丁的樣子

2014年11月6日

台中・Meet30・點一杯果汁享用WIFI空間・精誠路

Meet30 隱身在精誠路商圈,乍看之下像是一間外帶飲料店,價位是在20~60元的果汁茶飲,也有提供點心。但是和一般飲料店不同的是,Meet30在二、三樓提供舒適的空間,可以坐下來歇腳,也有免費WIFI網路可以上網,而且不像很多連鎖店那樣嘈雜,很適合出差或旅行途中,想找個地方坐下來喝杯果汁、用電腦。

地址:台中市西區精誠路105-3號(接近公益路口)
lyhcode by lyhcode
歡迎轉載,請務必註明出處!