{"id":14987361,"url":"https://github.com/monkenwu/codeigniter4-taiwan-user-guide","last_synced_at":"2025-04-12T00:02:02.458Z","repository":{"id":45277672,"uuid":"213742580","full_name":"monkenWu/codeIgniter4-taiwan-User-Guide","owner":"monkenWu","description":"CodeIgniter 4 Traditional Chinese(Taiwan) User Guide - codeigniter4 正體中文(台灣)使用手冊翻譯計畫","archived":false,"fork":false,"pushed_at":"2021-12-25T06:03:26.000Z","size":19456,"stargazers_count":15,"open_issues_count":1,"forks_count":9,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-12T00:01:57.102Z","etag":null,"topics":["codeigniter","codeigniter4","translation","userguide"],"latest_commit_sha":null,"homepage":"https://monkenwu.github.io/codeIgniter4-taiwan-User-Guide/","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/monkenWu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-08T20:06:33.000Z","updated_at":"2024-09-22T07:32:33.000Z","dependencies_parsed_at":"2022-09-22T18:50:24.341Z","dependency_job_id":null,"html_url":"https://github.com/monkenWu/codeIgniter4-taiwan-User-Guide","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monkenWu%2FcodeIgniter4-taiwan-User-Guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monkenWu%2FcodeIgniter4-taiwan-User-Guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monkenWu%2FcodeIgniter4-taiwan-User-Guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monkenWu%2FcodeIgniter4-taiwan-User-Guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/monkenWu","download_url":"https://codeload.github.com/monkenWu/codeIgniter4-taiwan-User-Guide/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248497805,"owners_count":21113984,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["codeigniter","codeigniter4","translation","userguide"],"created_at":"2024-09-24T14:14:30.301Z","updated_at":"2025-04-12T00:02:02.347Z","avatar_url":"https://github.com/monkenWu.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# codeIgniter4-taiwan-User-Guide\nCodeIgniter 4 Traditional Chinese(Taiwan) User Guide - codeigniter4 繁體中文(台灣)使用手冊翻譯計畫\n\n[Codeigniter台灣站](https://codeigniter.tw)\n\n[Codeigniter4 正式手冊](https://codeigniter.tw/user_guide/index.html)\n\n[查閱最新翻譯認領清單](https://github.com/monkenWu/codeIgniter4-taiwan-User-Guide/wiki/%E7%BF%BB%E8%AD%AF%E8%AA%8D%E9%A0%98%E6%B8%85%E5%96%AE)\n\n\n## 風格指南\n中文翻譯的文字排版請以 [中文文案排版指北](https://github.com/sparanoid/chinese-copywriting-guidelines) 為主。\n\n### 參考\n\n專業名詞與框架內用語的統一譯名請以 [翻譯詞彙對照表](https://hackmd.io/@monkenWu/rkdtL9f_8) 文件文主；若有新名詞未定義或是有爭議，則請發 issue 討論，我們將會持續更新內容。\n\n繁體中文翻譯請盡量遵守 [CodeIgniter3 使用手冊](https://codeigniter.org.tw/userguide3/) 的翻譯風格。\n\n簡體中文版本的 [CodeIgniter4 使用手冊](https://github.com/CodeIgniter-Chinese/codeigniter4-user-guide) 也正在翻譯中，可以參考其翻譯但不接受直接以簡體中文轉換為繁體中文。請注意，中國與台灣在程式開發專業詞彙上的譯名大不相同。\n\n### 提交規範\n\n#### 若你想替翻譯盡一份心力，可以怎麼做？\n1. fork 一份完整的程式碼。\n2. 至[翻譯認領串](https://github.com/monkenWu/codeIgniter4-taiwan-User-Guide/issues/1)認領欲翻譯的檔案。\n3. 在主線上產出一條屬於你的分支。\n4. 翻譯結束後編譯一次預覽翻譯效果，並且重複校稿。\n5. 在分支上 push 你所修改的檔案。\n6. 回到 github 發出 pull requests。\n\n#### 簽名\n所有的提交的內容都必須要留下你的簽名，比如說：``John Doe \u003cjohndoe@example.com\u003e``，其設定方式與你使用 git 的媒介有所不同，請務必設定完成後再進行提交。\n\n## 如何佈署\nCodeIgniter 使用手冊基於 Sphinx 進行撰寫，它可以管理文檔並且輸出成各種格式。頁面以人類可讀的 [eStructuredText](http://sphinx.pocoo.org/rest.html)\n格式進行撰寫。\n\n### 首要條件\n\n#### Python\n\nSphinx 需要 Python3.5+ ，如果你的作業系統是 MacOS 或是 Ubuntu ，則內建了 Python 。你可以透過 Terminal 確認你的版本：\n\n```\npython --version\nPython 2.7.17\n\npython3 --version\nPython 3.6.9\n```\n\n如果你使用的版本並非 3.5 以上，請透過 `Python.org \u003chttps://www.python.org/downloads/\u003e`_ 更新或重新安裝。Linux 應該使用作業系統內建的軟體管理器進行更新。\n\n#### pip\n\n現在，你已經擁有了 Python3.5+ ，你還必須擁有 \n`pip \u003chttps://pip.pypa.io/en/stable/\u003e`_ （python套件管理器）。\n\n你可以使用 ``pip`` 或是 ``pip3`` 檢查你是否安裝了 pip 。pip 遵循了與 python 相同的命名規則。請注意，他應該會在最後寫著 python 3.x 。\n\n```\npip --version\npip 9.0.1 from /usr/lib/python2.7/dist-packages (python 2.7)\n\npip3 --version\npip 9.0.1 from /usr/lib/python3/dist-packages (python 3.6)\n```\n\n如果你是從 `Python.org \u003chttps://www.python.org/downloads/\u003e`_ 下載了 Python3.5+ ，那麼 pip 已經自動安裝好了。\n\n### 安裝\n\n現在，我們需要安裝 Sphinx 和它所依賴的項目。根據作業系統的不同，選擇 pip 或 pip3 作為指令。\n\n```\npip install -r {project_root}/requirements.txt\n\npip3 install -r {project_root}/requirements.txt\n```\n\n在完成這一步驟後，你得重新啟動命令列視窗，因為需要重啟 Python 才可以找到我們安裝的應用程式。\n\n### 編譯\n\n現在，是時候產生整個說明文件了\n\n```\ncd {project_root}\nmake html\n```\n\n### 編輯與創建文檔\n所有原始檔案都存放在 ``source /`` 底下，你可以新增新的文檔或修改已有的文檔。就和修改程式碼一樣，我們建議新的內容都是以分支的方式新增，並且向此 Repository 發出  pull requests 。\n\n### HTML在哪裡呢？\nSphinx 透過 ``source /`` 底下的文件自動生成使用者最終看到的網頁。當然，對於自動生成的 HTML 進行版本控制是沒有意義的，所以它並不在版本控制之下。你如果想要預覽翻譯後的效果，可以重新透過 Sphinx 自動產生新的 HTML 文件。首先，你必須先 `` cd \u003c專案根目錄\u003e ``  進入專案的根目錄，再執行上節所敘述的最後一個步驟  ``make html`` 。\n\n執行步驟後，你將會看到編譯中的提示，待編譯成功後，自動產生的使用手冊以及圖片都會位於 ``build/html/`` 底下。 Sphinx 經過第一次編譯後，第二次再執行編譯將只針對修改的文件進行重新編譯，非常節省時間。但如果你想全部重新編譯的話，只需要刪除 ``build/`` 整個資料夾後重新編譯即可。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonkenwu%2Fcodeigniter4-taiwan-user-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmonkenwu%2Fcodeigniter4-taiwan-user-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonkenwu%2Fcodeigniter4-taiwan-user-guide/lists"}