diff --git a/zh_TW.Big5/books/fdp-primer/the-website/chapter.sgml b/zh_TW.Big5/books/fdp-primer/the-website/chapter.sgml index 49ba991dcf..c741bed2fa 100644 --- a/zh_TW.Big5/books/fdp-primer/the-website/chapter.sgml +++ b/zh_TW.Big5/books/fdp-primer/the-website/chapter.sgml @@ -1,208 +1,202 @@ - The Website + 建構 Website - Preparation + 事前準備 - Get 200MB free disk space. You will need the disk space for the - SGML tools, a subset of the CVS tree, temporary build space and the - installed web pages. If you already have installed the SGML tools and - the CVS tree, you need only ~100MB free disk space. + 請先準備約 200MB 空間,這些是要用來放 SGML 工具程式、CVS tree、 + 臨時編譯用的空間,以及編譯好的網頁存放空間。若事先已有裝 SGML 工具程式、 + CVS tree 的話,那麼只需頂多約 100MB 空間即可。 - Make sure your documentation ports are up to date! When in - doubt, remove the old ports using &man.pkg.delete.1; command before - installing the port. For example, we currently depend on - jade-1.2 and if you have installed jade-1.1, please do: + 請確認一下你的相關文件製作所會用到的 ports 都是最新版! + 若不清楚所裝的版本為何,那麼就先以 &man.pkg.delete.1; 指令來移除舊版, + 接著才去裝 port。 舉例來說,若已裝的是 jade-1.1, + 但是我們目前需要的卻是 jade-1.2,那麼先用下列方式來移除舊版: &prompt.root; pkg_delete jade-1.1 - Set up a CVS repository. You need the directories www, doc and - ports in the CVS tree (plus the CVSROOT of course). Please read the - CVSup introduction - on how to mirror a CVS tree or parts of a CVS tree. + 接著,就是設定 CVS repository。需要至少 www, doc, ports 這三樣 + CVS tree(當然還要加上 CVSROOT)。 請參閱 + CVSup 簡介 + 以瞭解如何來 mirror a CVS tree 或部分 CVS tree。 - The essential cvsup collections are: www, - doc-all, cvs-base, and - ports-base. + 最低需求的 cvsup collections 為:www, + doc-all, cvs-base 以及 + ports-base - These collections require ~105MB free disk space. + 剛講的這些需要約 105MB 空間。 - A full CVS tree - including src, - doc, www, and - ports - is currently 940MB. + 而完整的 CVS tree - 包括 src, + doc, www 以及 + ports - 目前約為 940MB。 Build the web pages from scratch - Create and change directory into a build directory with at least 60MB of free - space. + 先建立要編譯的目錄(至少要有 60MB 空間),並切換到該目錄。 &prompt.root; mkdir /var/tmp/webbuild &prompt.root; cd /var/tmp/webbuild - Checkout the SGML files from the CVS tree. + 從 CVS tree 內 checkout 相關的 SGML 檔。 &prompt.root; cvs -R co www doc - Change into the www/en directory, and run - the &man.make.1; all target, to create - the web pages. + 切到 www/en 目錄,然後打 + &man.make.1; all 來產生網頁。 &prompt.root; cd en &prompt.root; make all - Install the web pages into your web server + 在你的網頁伺服器上安裝網頁 - If you have moved out of the en - directory, change back to it. + 如果你已經離開 en + 這個目錄,請切換回這個目錄中。 &prompt.root; cd path/www/en - Run the &man.make.1; install target, - setting the DESTDIR variable to the name of the - directory you want to install the files to. + 執行 &man.make.1; install , + 並將 DESTDIR 設定為你想安裝檔案的目錄名稱。 &prompt.root; make DESTDIR=/usr/local/www install - If you have previously installed the web pages into the same - directory the install process will not have deleted any old or - outdated pages. For example, if you build and install a new copy - of the site every day, this command will find and delete all - files that have not been updated in three days. + 如果你之前已經在相同的目錄中安裝了這些網頁, + 安裝過程並不會刪除任何既有或過期的網頁。 + 舉例來說,如果你每日建構和安裝新的網頁副本, + 這個指令將會搜尋並刪除在三天內沒有更新的檔案。 &prompt.root; find /usr/local/www -ctime 3 -print0 | xargs -0 rm - Environment variables + 環境變數 CVSROOT - Location of the CVS tree. Essential. + 設定 CVS tree 的位置,此為必備條件。 &prompt.root; CVSROOT=/home/ncvs; export CVSROOT ENGLISH_ONLY - If set and not empty, the makefiles will build and - install only the English documents. All translations will be - ignored. E.g.: + 如果設定這個環境變數,而且值不為空白, + makefiles 將只會建構和安裝英文文件。 + 所以將會略過其他的各國翻譯。例如: &prompt.root; make ENGLISH_ONLY=YES all install - If you want to unset the variable - ENGLISH_ONLY and build all pages, including - translations, set the variable ENGLISH_ONLY - to an empty value: + 如果你想要取消變數 ENGLISH_ONLY + 以及建構所有的頁面並包括翻譯,只要將變數 ENGLISH_ONLY + 的值設定成空白即可。 &prompt.root; make ENGLISH_ONLY="" all install clean WEB_ONLY - If set and not empty, the makefiles will build and install - only the HTML pages from the www directory. All documents from - the doc directory (Handbook, FAQ, Tutorials) will be ignored. - E.g.: + 如果有設定這個變數的話, + makefiles 將只會從 www 目錄建構及安裝 HTML 頁面。 + 所有從 doc 目錄下的文件全部都會被忽略 (Handbook, FAQ, Tutorials)。 + 例如: &prompt.root; make WEB_ONLY=YES all install NOPORTSCVS - If set, the makefiles will not checkout files from the ports - cvs repository. Instead, it will copy the files from - /usr/ports (or where the variable - PORTSBASE points to). + 如果設了這個變數,makefiles 就不會從 ports cvs repository + 取出檔案。 取而代之會從 + /usr/ports (或是 PORTSBASE + 所設定的值) 內複製檔案。 - CVSROOT is an environment variable. You must set it - on the command line or in your dot files (e.g., ~/.profile). + CVSROOT 是環境變數。 + 你必須直接使用指令或是在 dot files (如: ~/.profile) 中 + 設定這個環境變數。 - WEB_ONLY, ENGLISH_ONLY and - NOPORTSCVS are makefile variables. You can set the - variables in /etc/make.conf, - Makefile.inc, as environment variables on the - command line, or in your dot files. + WEB_ONLYENGLISH_ONLY 及 + NOPORTSCVS 都是 makefile 變數。 + 你可以在 /etc/make.confMakefile.inc + 中設定這些變數,作法就像是用命令列或使用 dot files 來設定環境變數一般。