跳到主要內容

為新手撰寫技術文章的方法

觀察 "XYZ" for Dummies這類書籍中使用的撰寫方式：

  • 每章開頭有漫畫
  • 將要描述的觀念、步驟，條列式、分點
  • 配合圖示來標注要強調的段落
  • 採用較大的標題，標題用特別的字型
  • 儘量使用圖片說明想法
  • 另闢一區特別解釋專有名詞

其他作法：
  • 從讀者的角度去訂標題
  • 只提供一種不容易出錯的操作步驟
  • 去除非必要的程式碼與技術細節
標籤：

留言

張貼留言

這個網誌中的熱門文章

iframe DOM 被移動造成重新載入

如果用 javascript 去搬動 iframe DOM 的位置, 瀏覽器會將其內容重新載入，這是現有 HTML 規格 > When an iframe element is inserted into a document that has a browsing context, the user agent must create a nested browsing context, and then process the iframe attributes for the "first time". 範例： http://jsfiddle.net/pZ23B/ 測試結果： * Safari 3.1 / Win: reload * Opera 9.5 / Win: reload * IE10: reload * IE7 / IE8: not reload (部份摘自 https://bugzilla.mozilla.org/show_bug.cgi?id=254144 ) 參考： * https://bugzilla.mozilla.org/show_bug.cgi?id=254144
張貼留言
閱讀完整內容

XMind使用心得

使用FreeMind有好一段時間，不過畫面單調一直是我不滿意之處。 XMind在畫面上好看很多，節點形狀樣式、分支線樣式有多樣選擇，也可以匯入FreeMind的檔案。 類似Excel般，工作頁活頁的概念也很不錯，可以將多個相關的心智圖存在一起。 可以某個分支為中心來檢視的功能也很令人激賞，完全符合心智圖那種可見樹、可見林的特性。 不過使用上有幾項缺點: 1.不能設定節點的預設文字大小。 預設應該是10點字，太小了，但是「喜好設定」內沒有地方可以修改，需要每次自己加大字型，很麻煩。 2.沒有加大字型的動作可以設定快速鍵。 我喜歡不只是用顏色，還有用字型的大小來凸顯主幹、分支的差別，不能快速的增大、縮小字型很不便。
2 則留言
閱讀完整內容

ZK 教學 - 使用 MVC 或 MVVM?

不管是現在剛開始接觸 ZK 或是用過一陣子的人都可能會遇到的問題是到底要用 MVC 或 MVVM 的方式開發。從 ZK 8 之後又把 MVVM 的能力更佳的擴展，所以 MVVM 會是一個功能更強的開發方式。但 MVC 在使用上比較直覺，仍有其優勢，所以我想決定性的因素會比較是 開發者的偏好 及 專案的特性 。你可參考下面的比較來決定哪種方式比較適合你。 優勢比較 MVVM ViewModel 較不易受畫面變動影響。 因為 ViewModel 沒有變數直接指向 ZK 元件，因此若是畫面上有元件更改，ViewModel 一般不需要修改 ViewModel 較易於在不同頁面中重用。 因為 ViewModel 只包含資料跟業務邏輯，若是不同頁面需要的資料跟業務邏輯相同，就可以重用同一個 ViewModel 例如 A 頁面按按鈕執行搜尋，B 頁面點選單執行同樣的搜尋，則可以重用同一個 ViewModel 中的 command，只是兩個頁面 data binding 寫在不同的元件上。 畫面較易於重用（易於模組化）。 透過 shadow component 跟 template 機制，可以將一段頁面的片段做成可以接受傳入參數 套用 Responsive Design 的成本較低。 通常需要針對不同裝置設計不同版面，但是顯示的資料內容大同小異，因此 ViewModel 多半可以重用 易於套用美工所設計的畫面，或是網路上現成的元件。 易於整合第三方 javascript library 或 widget。 因為 ZK 8 提供了一個可以讓你透過 javascript 去呼叫 ViewModel 中的 command (client side binding) 的方式來跟後端溝通 ViewModel 的可測試性較好。 因為 ViewModel 不需要繼承特定類別跟實作特定介面，可以輕易地執行單元測試 MVC 操控元件方式直覺好學、易懂。 MVVM 控制元件較不直接，需要了解 zk framework data binding 的行為 可以完全使用元件所提供的所有 API。 仍有極少部分 ZK 元件行為沒辦法用 MVVM 控制。例如產生 Messagebox , Listbox.renderAll() , Popup.o...
張貼留言
閱讀完整內容