一個合作寫書的架構

一個良好合作寫書的架構,
必須滿足下列條件:
*精簡表達書的結構,讓作者專注於內容

精簡表達書的結構
寫一本書最重要的是精簡表達書的結構,
而這個表達方式首先必須能表達出書的結構,
通用來說,
書的結構基本上包括了章、節、段落、
圖、表、參考文獻、目次、索引等等元素。

這些元素也包括了基本的階層關係,
像是章這個元素,可能由許多節組合而成,
而節又可以包含許多段落,
最後段落由字元組成。

而節又可包含子節這種遞迴關系。

表達書的結構,是基本要求。

第二個要求是上述的表達語言必須是最簡單的
最簡單表示我只須要寫出必要的結構,
至於電腦可以幫妳作的,
如下面常見的元素通常可由電腦幫忙產出:
自動編號
章、節、圖、表出現的順序自動為其產出編號。
目次
電腦可以依據章、節的階層結構及章、節、圖、表出現的順序自動產出目次。
交互參照
平常妳看的「請見圖1」之類的交互參照,
則必須給參照的名字,讓電腦為妳產出「請見圖1」之類的文字。
索引
作者只要給定索引字清單,
電腦會搜尋整份文件,
並依照索引字清單製作成索引。
排版
可由文件中的參照在排版之後製作出來,
排版可由元素的階層關係及前後關係推理元素要如何呈現出來,
就讓電腦去作。

當電腦能為妳自動產出更多內容時,
我或妳,身為一個作者,
只需要專注寫出書的內容。

表達書結構的語言
至於精簡表達書結構的語言:
傳統上有 Docbook,
及現正研究的 Gerbil。

轉換
當用上述表達書結構的語言寫完原始內容後,
則通常會經過原始內容轉換呈現或排版內容。
例如
docbook 就會經過以下程序來產出可見的 html 檔。
  1. 用 vim(或妳不學,用其它的純文字編輯器)製作 yourbook.xml 檔(這個檔只描述書本的結構)
  2. 將 yourbook.xml -轉換-> yourbook.html
  3. 用 IE 看 yourbook.html 是否符合呈現的需要
  4. 再回到第1步,作修改

留言

這個網誌中的熱門文章

浴室水龍頭切換拉桿維修

【麵】的倉頡碼

投資現況