Description

############################# CodeIgniter 3.0 Dev 使用手冊 ############################# 目前CodeIgniter 3.0正處於開發階段，故在翻譯使用手冊過程中，版本會隨之增刪，直到穩定版釋出。 ********* 安裝教學 ********* CodeIgniter使用手冊是利用Sphinx管理文件輸出成不同格式， 內文是以人們容易理解的 `ReStructured Text <http://sphinx.pocoo.org/rest.html>`_ 格式撰寫。 必要條件 ========= Sphinx需要安裝Python(如果是OS X，預設是已安裝)，可以在終端機執行 ``python`` 指令確認顯示安裝版本， 若尚未安裝2.7+ , 可從http://python.org/download/releases/2.7.2/ 下載安裝 2.7.2版本。 安裝 ===== 1. Install `easy_install <http://peak.telecommunity.com/DevCenter/EasyInstall#installing-easy-install>`_ 2. ``easy_install sphinx`` 3. ``easy_install sphinxcontrib-phpdomain`` 4. Install the CI Lexer which allows PHP, HTML, CSS, and JavaScript syntax highlighting in code examples (see *cilexer/README*) 5. ``cd user_guide_src`` 6. ``make html`` 編輯及建立文件 =============== 文件原始檔案全放至 *source/* 下，可以新增或修改文件， 建議先新增分支，然後在PR至 *develop* 分支。 HTML在哪? ==================== 很明顯地HTML是我們最關心的，因為它是與使用者接觸的主要文件。 由於修改建置檔案是無益的，故不在原始碼管控下， 如果你想 "預灠" 成果，可以重新產生，產生HTML非常容易， 在Repo的根目錄，指令就是像安裝說明最後一行:: make html 你會看到多彩多姿編譯，此時使用手冊及圖片放置 *build/html*， HTML建置完成後，每次編譯只會重新編譯有異動過檔案，以節省時間。 如果想 "重設" 編譯檔案，只需刪除 *build* 資料夾在重新編譯。 ********* 風格指南 ********* 請考照 source/documentation/index.rst 作為使用Sphinx產生CodeIgniter文件的一般指南。