迴瀾打狗人扎記

Gerbil 文件基本元素 書的結構 對應 Gerbil 元素 章 chapter 節 section <% # parameters for the HTML format $title = "rails 行車手冊" $authors = { 'fhopecc & wind' => 'http://fhopecc.blogspot.com' } %> <% chapter "MVC 模式" do %> <% section "簡介" do %> MVC 模式是 rails 框架所使用的模式。 <% end %> <% end %> Gerbil 是利用 ruby 的區塊(block)語法及 ERB 來模擬標籤語言， chapter 表示 block 中內容是一個章，我們知道章可以包含多個節，故 chapter 的區塊中可包含多個 section ，上述有一個 chapter 其標題為 MVC 模式，而其包含一個 section 簡介。

一個良好合作寫書的架構， 必須滿足下列條件： *精簡表達書的結構，讓作者專注於內容 精簡表達書的結構 寫一本書最重要的是 精簡 表達書的結構， 而這個表達方式首先必須能表達出書的結構， 通用來說， 書的結構基本上包括了章、節、段落、 圖、表、參考文獻、目次、索引等等元素。 這些元素也包括了基本的階層關係， 像是章這個元素，可能由許多節組合而成， 而節又可以包含許多段落， 最後段落由字元組成。 而節又可包含子節這種遞迴關系。 表達書的結構，是基本要求。 第二個要求是上述的表達語言必須是 最簡單的 。 最簡單 表示我只須要寫出必要的結構， 至於電腦可以幫妳作的， 如下面常見的元素通常可由電腦幫忙產出： 自動編號 章、節、圖、表出現的順序自動為其產出編號。 目次 電腦可以依據章、節的階層結構及章、節、圖、表出現的順序自動產出目次。 交互參照 平常妳看的「請見圖1」之類的交互參照， 則必須給參照的名字，讓電腦為妳產出「請見圖1」之類的文字。 索引 作者只要給定索引字清單， 電腦會搜尋整份文件， 並依照索引字清單製作成索引。 排版 可由文件中的參照在排版之後製作出來， 排版可由元素的階層關係及前後關係推理元素要如何呈現出來， 就讓電腦去作。 當電腦能為妳自動產出更多內容時， 我或妳，身為一個作者， 只需要專注寫出書的內容。 表達書結構的語言 至於精簡表達書結構的語言： 傳統上有 Docbook， 及現正研究的 Gerbil。 轉換 當用上述表達書結構的語言寫完原始內容後， 則通常會經過原始內容轉換呈現或排版內容。 例如 docbook 就會經過以下程序來產出可見的 html 檔。 用 vim(或妳不學，用其它的純文字編輯器)製作 yourbook.xml 檔（這個檔只描述書本的結構） 將 yourbook.xml -轉換-> yourbook.html 用 IE 看 yourbook.html 是否符合呈現的需要 再回到第1步，作修改

Gerbil 一個相當輕巧且排版工具，100% 純 ruby 寫成。 A.安裝 1. 妳要先裝 ruby 2. 打開命令視窗，用下列指令安裝這三個 gem gem install RedCloth coderay gem install gerbil 3.再輸入下列指令，測試是否安裝成功： gerbil -v 若安裝成功會出現 Gerbil 3.1.0 (2008-06-22) http://gerbil.rubyforge.org /home/sun/src/gerbil

安裝、Hello World(妹妹) HTTP協定(me) MVC架構(me) 連接資料庫的範例(妹妹) ActiveController ActiveRecord ActivePack 上傳檔案 Migration介紹

採取 Docbook 來合作寫一本書， 有幾個工具要學習。 1.vim 編輯器 vim 只是一個單純的文字編輯器，但是它可是寫 Docbook 文件的好工具。 Docbook 格式為一個 xml 檔(基本上是個文字檔)，設計給專業書籍用的， 所以參考結構，目錄的自動產生，都相當完整， 但相對而言，xml檔要打很多標記(tag)，而且只要語法錯， 就沒辦法轉換成 html 檔，而 vim 可藉由其語法 hilighting 的功能， 讓我們在編輯時，就知道有沒有寫錯語法。 基本 vim 的使用，可看李果正兄這篇 大家來學 Vim 一個歷久彌新的編輯器。 還有家裡還有 Or'eilly 出的「UNIX 超級工具」上下兩本書， 也有介紹基本的 vim 使用。 關於 vim 的學習，最好的方法就是 強迫自已多用。 想當初我只要是純文字的東西，一律使用 VIM 來編輯。 用越久，越是發現它的強大。 另外 坐而言不如起而行 ， 若妳還沒有把 vim 安裝在家裡， 或是公司電腦， 一切都是白作的。 2.轉換 Docbook 至 HTML 當妳把要寫的書製作成一個 yourbook.xml 檔時， 要經過一個轉換器，把 yourbook.xml -轉換-> yourbook.html， 這樣就可以用IE or Firefox看 yourbook.html， 去了解妳書本大致的模樣。 而轉換目前滿複雜的，要安裝很多工具， 有一篇文章是簡體的， 但還算完整可用，照著作希望妳應該可以完成吧！ DocBook文檔轉換環境設定 。 再 summary 一下寫書的步驟： 用 vim(或妳不學，用其它的純文字編輯器)製作 yourbook.xml 檔 將 yourbook.xml -轉換-> yourbook.html 用 IE 看 yourbook.html 是否符合呈現的需要 再回到第1步，作修改