本文簡述 xcin-2.5 安裝步驟與準備工作:

---------------------------------
A. 建立您的 locale 環境:

由於 xcin-2.5 以後全部採用 Xi18n 與 locale 而設計，因此在使用本程式前，
您必須在您的系統中準備好 zh_TW.Big5 locale 的環境。至於 GB locale 的環
境建立，方法類同。

有關建立您的 locale (zh_TW.Big5 or zh_CN.GB2312) 環境的詳細步驟與所需套
件，請見

	ftp://xcin.linux.org.tw/pub/xcin/i18n/i18n_tool.tar.gz

與其 README 的說明。


---------------------------------
B. 安裝 xcin-2.5:

1. 如果您安裝 xcin-2.5 時想要安裝 bimsphone 模組，則您需要 Berkeley DB2，
   否則的話不需要。請注意若您不想安裝 bimsphone，您必須在 configure xcin 
   時加入 --disable-bimsphone 選項 (詳見後述)，如此當 xcin 在 configure
   時才不會去檢查 Berkeley DB2。

   如果您用的是 Linux glibc-2.1.X 的話，系統中已內含了 Berkeley DB2, 故您
   可直接進行 xcin-2.5 的安裝。若您的系統沒有 Berkeley DB2, 您可以到以下
   這幾個地方找到它:

	http://www.sleepycat.com
	ftp://xcin.linux.org.tw/pub/xcin/misc/db-2.7.4.tar.gz

2. 自 xcin-2.5.1 及以後的版本， libtabe 已自 xcin 套件中分離並獨立維護，
   若您安裝 xcin-2.5 時想要安裝 bimsphone 模組，則您還需要 libtabe，否則
   的話不需要。請注意若您不想安裝 bimsphone，您必須在 configure xcin 時
   加入  --disable-bimsphone 選項 (詳見後述)，如此當 xcin 在 configure 時
   才不會去檢查 libtabe。

   您可以在這裏找到 libtabe 套件:

	ftp://xcin.linux.org.tw/pub/xcin/libtabe/devel/libtabe-0.1.1.tar.gz

   若您的系統有 shared library 的支援，建議您將 libtabe compile 成 shared
   library, 以結省硬碟空間。以下是快速安裝指引 (詳見 libtabe 的文件說明):

	gzip -dc libtabe-<version>.tar.gz | tar -xvf -
	cd libtabe-<version>
	./configure --prefix=<path> --enable-shared
	make install

   請注意: 此 xcin 版本 (2.5.2-pre3) 必須搭配 libtabe-0.1-4.tar.gz 安裝使
	   用。您也許會在上述的 ftp 站中找到其他版本的 libtabe, 但請勿使用
	   更舊的版本，因為舊的版本可能會有 bug 或其他問題。

	   當然，您也可以嘗試使用更新的版本，然而，我們不能保證新版的可以正
	   確與 xcin-2.5.2-pre1 搭配。因此，如果您發現在安裝新版的 libtabe 
	   之後，卻無法 compile xcin, 或使用上有其他問題時，建議您還是換回 
	   libtabe-0.1-4。

	   若您堅持使用新版的 libtabe, 請您使用更新版的 (或尚在發展中的)
	   xcin 版本。

3. xcin 穩定版可以在這裏取得:

	ftp://xcin.linux.org.tw/pub/xcin/xcin/

   若您想試試最新的測試版，則您可以在這裏取得:

	ftp://xcin.linux.org.tw/pub/xcin/xcin/devel/

   xcin 的原始套件檔名通常為: xcin-<version>.tar.gz, 其中 <version> 為版
   本名，若您在其中見到 pre 的字眼，表示它是測試版，否則為穩定版。當您取
   得您所需的版本後，請用以下的方式將它解開:

	gzip -dc xcin-<version>.tar.gz | tar -xvf -

   完成後您會得到一個 xcin-2.5 的目錄。

4. 請到 xcin-2.5 目錄下，執行 configure 程式。一般說來，如果 xcin 所需的
   額外 library (如 Berkeley DB2, libtabe 等) 都放在相同的位置，您只要執行:

	./configure --prefix=<安裝路徑> \
		    --with-extra-prefix=<額外 library 的所在路徑>

   即可。除此之外， configure 還可以接受其他參數，您可以視需要加入。其各
   參數的意義如下:

	--help
	    列出使用說明。

	--prefix=PATH (預設值為 /usr/local)
	    設定安裝路徑為 PATH ，則 xcin 將安裝到以下的目錄中:

		執行檔:  $PATH/bin
		資料檔:  $PATH/lib/xcin
		設定檔:  $PATH/etc

	--binpath=PATH (預設值為 ${prefix}/bin)
	    設定 xcin 執行檔的安裝路徑為 $PATH

	--with-xcin-dir=PATH (預設值為 ${prefix}/lib/xcin)
	    設定 xcin 資料檔的安裝路徑為 $PATH

	--with-xcin-rcdir=PATH (預設值為 ${prefix}/etc)
	    設定 xcin 設定檔的安裝路徑為 $PATH

	--with-localedir=PATH (預設值為 ${prefix}/share/locale)
	    設定系統 locale 目錄路徑，用來安裝 xcin LC_MESSAGES 訊息檔。

	--with-extra-prefix=PATH (若有設定 prefix 的話，預設值等於 ${prefix})
	    設定額外 library 的所在路徑為 $PATH。由於安裝 xcin-2.5 您需要 
	    Berkeley DB2, libtabe .... 等額外的 lib, 您除了可以一一設定這
	    些 lib 的所在路徑以外 (見後頭的選項說明)，若這些 lib 都安裝在
	    相同位置，則您也可以在這裏直接設定它們的所在位置，如此一來就
	    不需要打一長串的 configure 參數了。

	    本選項值一旦決定之後，則 configure 便會自動設定以下兩個參數:

		extra_include=-I$extra_prefix/include
		extra_library=-L$extra_prefix/lib

	    而在 configure 與 compile 階段，所需的額外 lib 與 include 都
	    會依上述那兩個變數值來做搜尋。

	--with-extra-inc=PATH (預設值為 ${extra_prefix}/include)
	    設定額外的 library 的 include 位置。

	--with-extra-lib=PATH (預設值為 ${extra_prefix}/lib)
	    設定額外的 library 的 lib 位置。

	--disable-bimsphone (預設是 enable)
	    不安裝 bimsphone 模組。由於安裝 bimsphone 模組需要 Berkeley DB2
	    以及 libtabe，在預設情況下 xcin configure 程式會檢查這兩個套件
	    是否存在於您的系統中，若不存在則印出錯誤訊息並停止後續動作。若
	    您不想安裝 bimsphone 模組時，您必須在 configure 時加入此選項，
	    則 configure 程式將不會檢查 Berkeley DB2 以及 libtabe, 同時在編
	    譯時也不會去編譯 bimsphone。

	--with-dbinc=PATH (預設值為 ${extra_include})
	    設定您系統的 Berkeley DB2 include 路徑為 $PATH

	--with-dblib=PATH (預設值為 ${extra_library})
	    設定您系統的 Berkeley DB2 library 路徑為 $PATH

	--with-tabeinc=PATH (預設值為 ${extra_include})
	    設定您系統的 libtabe include 路徑為 $PATH

	--with-tabelib=PATH (預設值為 ${extra_library})
	    設定您系統的 libtabe library 路徑為 $PATH

	--with-intlinc=PATH (預設值為 ${extra_include})
	    設定您系統的 libintl include 路徑為 $PATH (for gettext)

	--with-intllib=PATH (預設值為 ${extra_library})
	    設定您系統的 libintl library 路徑為 $PATH (for gettext)

	--x-includes=PATH (沒有預設值)
	    設定您系統的 X Window include 檔的路徑為 $PATH

	--with-goinc=PATH

	--with-golib=PATH

	--x-libraries=PATH (沒有預設值)
	    設定您系統的 X Window library 的路徑為 $PATH

	--enable-debug
	    開啟 Debug 選項。

5. 執行
	make
	make install

6. 修改 $RCPATH/xcinrc 的內容，將它設定成您喜歡的組態 (有關 xcinrc 的設定
   說明請見 Usage 與 modules/* 的內容)

7. 若在 $XCINPATH/tab/ 底下找不到您慣用的輸入法表格，請參考 Cin 一文的說
   明來修改、編寫您的 .cin 檔。

8. 若您想要使用 bimsphone 模組時，您還需要 tsi.db 與 yin.db 兩個資料檔。
   這兩個資料檔屬於 libtabe 套件，一般是安裝在 <path>/share/tabe/tsiyin/
   目錄底下，其中 <path> 是 libtabe 的安裝路徑。這時，您只需要在 xcinrc
   中指明這兩個檔的絕對路徑 (見 xcin-2.5/doc/modules/bimsphone 的說明)，
   例如 (假設您的 libtabe 的安裝路徑為 /usr/local):

   (define bimsphone
        '((SETKEY       6)
          (MODULE       "bimsphone")
          (TSI_FNAME    "/usr/local/share/tabe/tsiyin/tsi.db")
          (YIN_FNAME    "/usr/local/share/tabe/tsiyin/yin.db")
          (KEYMAP       0)))

   即可，或者是做 symbolic link, 將那兩個檔 link 到 xcin 的安裝目錄下，
   例如:

	cd ${xcin_dir}/tab/zh_TW.Big5
	ln -s /usr/local/share/tabe/tsiyin/tsi.db .
	ln -s /usr/local/share/tabe/tsiyin/yin.db .

   亦可。


---------------------------------
C. 測試:

相關的測試與操作細節，請見 UserGuide 與 Usage 二文的說明。



T.H.Hsieh
