Chapter 20. 撰寫這本書

我們參照PostgreSQL社群無私提供的技術來撰寫這本書。原始手冊有詳細介紹。本章是「三分鐘學會DocBook」教材。

請按下列步驟撰寫新章：
1. cd到~/en目錄。
2. 複製documentation.sgml檔案到my-chapter.sgml。
3. 編輯my-chapter.sgml檔案，並把id="chapter-doc"改成id="chapter-my-chapter"。
4. 編輯filelist.sgml檔案，並複製含有documentation的那一列。把新列裏的documentation換成my-chapter。
5. 編輯posterp.sgml檔案，並緊跟在&documentation;這列下方加入&my-chapter;這一列。
6. 下指令：
  SP_ENCODING=UTF-8 make
  用瀏覽器打開index.html檔案。這時，你就可以注意到你的新章已經出現在這本新書中。
現在假設您要翻譯這本中文書成為英文版。
1. 複製~/tw/目錄下全部檔案成為~/en/。
2. cd到~/en/目錄。翻譯全部內容成為英文。
3. 編輯language.sgml檔案，並找出含有use-en以及use-tw的那兩列，然後把該兩列裏的IGNORE和INCLUDE二者對換。
4. 編輯system-develop.sgml檔案，並複製含use-tw的那列。然後把新列的use-tw換成use-en。
5. 用你的英文版圖檔mzf3.png換掉原來置於~/images/目錄下的原中文圖檔。
6. 下指令：
  make

翻譯這本繁體中文書成為簡體中文版。

複製~/tw/目錄下全部檔案成為~/cn/。
cd到~/cn/目錄。
編輯language.sgml檔案，並找出含有use-tw以及use-cn的那兩列，然後把該兩列裏的IGNORE和INCLUDE二者對換。
編輯system-develop.sgml檔案，並複製含use-tw的那列。然後把新列的use-tw換成use-cn。
用你的簡體中文版圖檔mzf3.png換掉原來置於~/images/目錄下的原繁體中文圖檔。
下指令：
SP_ENCODE=UTF-8 make

這時候，這個目錄已經有完整的.html一本繁體中文版書籍。下一步是把UNICODE的繁體字轉成UNICODE的簡體字。

準備好一個Unix的shell檔案，取名utf_tw-to-utf_cn.sh：

#!/bin/sh
sed \
	-e 's/∕/tmp_slash/g' \
	-e 's/∼/～/g' \
	-e 's/–/tmp_dash/g' \
	-e 's/記憶體/內存/g' \
	-e 's/雲端/雲/g' \
	-e 's/頻寬/帶寬/g' \
	-e 's/寫程式/編程/g' \
	-e 's/設計程式/編程/g' \
	-e 's/程式設計/編程/g' \
	-e 's/軟體/軟件/g' \
	-e 's/硬體/硬件/g' \
	-e 's/雷射/激光/g' \
	-e 's/光碟片/光盤/g' \
	-e 's/硬碟/硬盤/g' \
	-e 's/資料庫/數據庫/g' \
	-e 's/資訊/信息/g' \
	-e 's/訊息/信息/g' \
	-e 's/游標/鼠標/g' \
	-e 's/網際網路/互聯網/g' \
	-e 's/聯絡/聯系/g' \
	-e 's/區域網路/局網/g' \
	-e 's/支援/支持/g' \
	-e 's/線上/在線/g' \
	-e 's/在在線/在線/g' \
	-e 's/俟服器/俟服機/g' \
	-e 's/駭客/黑客/g' \
	-e 's/當機/死機/g' \
	-e 's/當過機/死過機/g' \
	-e 's/列印/打印/g' \
	-e 's/行銷/營銷/g' \
	-e 's/登入/登錄/g' \
	-e 's/傳票/憑證/g' \
	-e 's/變數/變量/g' \
	-e 's/點選/點擊/g' \
	-e 's/程式/程序/g' \
	-e 's/執行/運行/g' \
	-e 's/跑/運行/g' \
	-e 's/出報表/打印報表/g' \
	-e 's/列印/打印/g' \
	-e 's/作業系統/操作系統/g' \
	-e 's/原始碼/原代碼/g' \
	-e 's/網路/網絡/g' \
	-e 's/螢幕/螢屏/g' \
	-e 's/欄位/字段/g' \
	-e 's/畫面樣品/截圖/g' \
	-e 's/畫面/屏幕/g' \
	-e 's/模組/模塊/g' \
	-e 's/銷貨科目/主營業務收入科目/g' \
	-e 's/銷貨成本/主營業務成本/g' \
	-e 's/存貨盤盈科目/待處理財產損益科目/g' \
	-e 's/製程/工序/g' \
	-e 's/拋轉/生成/g' \
	-e 's/檔案/文檔/g' \
	-e 's/副檔名/檔名後綴/g' \
	-e 's/職員/文員/g' \
	-e 's/專案/項目/g' \
	-e 's/手冊/文檔/g' \
	-e 's/脫節/脫勾/g' \
	-e 's/套件/包/g' \
$1 | iconv -f utf8 -t big5 | iconv -f big5 -t gb2312 |
sed \
	-e 's/tmp_slash/\xA3\xAF/g' \
	-e 's/tmp_dash/\xA3\xAD/g' |
iconv -f gb2312 -t utf8

準備好一個Unix的shell檔案，取名batch-utf_tw-to-utf_cn.sh：

#!/bin/sh
export LANG=C
for i in `ls *html`
do
  echo $i;
  utf_tw-to-utf_cn.sh $i > $$_$i;
  mv $$_$i $i
done

令這2個shell檔案可以執行。下指令：

chmod u+x utf_tw-to-utf_cn.sh batch-utf_tw-to-utf_cn.sh

一口氣轉換全部的*.html。下指令：

./batch-utf_tw-to-utf_cn.sh

要出版這本書時，複製這些檔案到你的最終目錄下面：*.html、*.css、以及~/images/*。


呼叫PostgreSQL function或procedure		附錄