# CodeIgniter 4 中文手册翻译项目

**Repository Path**: BinHaiIT2/codeigniter4-user-guide

## Basic Information

- **Project Name**: CodeIgniter 4 中文手册翻译项目
- **Description**: PHP 框架 CodeIgniter 4 简体中文手册
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://codeigniter.org.cn/user_guide/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2020-07-24
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CodeIgniter 4 中文手册翻译项目

[![image](https://travis-ci.org/CodeIgniter-Chinese/codeigniter4-user-guide.svg?branch=master)](https://travis-ci.org/CodeIgniter-Chinese/codeigniter4-user-guide) <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
[![All Contributors](https://img.shields.io/badge/all_contributors-26-orange.svg?style=flat-square)](#contributors-)
<!-- ALL-CONTRIBUTORS-BADGE:END -->

## 翻译准则

中文翻译请遵守
[中文文案排版指北](http://mazhuang.org/wiki/chinese-copywriting-guidelines/)
和 [文档翻译指南](translation-guide.md)

[文档翻译进度](TODO.md)

[预览最新文档](https://codeigniter-chinese.github.io/codeigniter4-user-guide/)

## 安装步骤

CodeIgniter 的用户指南使用 Sphinx 软件进行管理，并可以生成各种不同的格式。所有页面都采用 [ReStructured
Text](https://en.wikipedia.org/wiki/ReStructuredText) 格式书写，这种格式非常方便人们阅读。

### 安装条件

Sphinx 软件依赖于 Python，如果你使用的是 OS X 系统，则系统已经自带 Python 了。 你可以在终端中执行不带参数的
`python` 命令，以确认你的系统是否已安装 Python 。 如果你已安装，会显示出你当前所使用的版本。 如果显示的不是 3.7
以上版本，你可以去这里下载并安装 3.7.6
<https://www.python.org/downloads/release/python-376/>

### 安装

1. 安装 [easy\_install](http://peak.telecommunity.com/DevCenter/EasyInstall#installing-easy-install)
2. `easy_install "sphinx==1.8.5"`
3. `easy_install "sphinxcontrib-phpdomain==0.7.0"`
4. `easy_install "docutils==0.16"`
5. `easy_install "sphinx-rtd-theme>=0.4.3"`
6. `easy_install "jieba==0.42.1"`
7. `make html`

译注：

1. Ubuntu 系统上安装 easy\_install 可以直接：`sudo apt-get install python-setuptools`
2. easy\_install 需要 root 权限，前面加上 sudo

### 使用 Docker

如果你喜欢使用 Docker 构建文档的话，可以这样：

1. clone 代码库到本地，例如 `/my/ci4` 目录
2. 在 `/my/ci4` 目录下执行 `docker build -t ci4 .`
3. 在 `/my/ci4` 目录下执行 `docker run -t --rm -v /my/ci4:/ci ci4`

执行完毕后，`/my/ci4/build/html` 目录就是生成的文档啦。

### 编辑并创建文档

所有的源文件都在 *source/* 目录下，在这里你可以添加新的文档或修改已有的文档。

### 那么，HTML 文档在哪里

很显然，HTML 文档才是我们最关心的，因为这毕竟才是用户最终看到的。 由于对自动生成的文件进行版本控制没有意义，所以它们并不在版本控制之下。
你如果想要预览 HTML 文档，你可以重新生成它们。生成 HTML 文档非常简单，
首先进入你的用户指南目录，然后执行上面安装步骤中的最后一步:

    make html

你将会看到正在编译中的信息，编译成功后，生成的用户指南和图片都位于 *build/html/* 目录下。 在 HTML
第一次编译之后，后面将只会针对修改的文件进行重编译，这将大大的节约我们的时间。
如果你想再重新全部编译一次，只需删除 *build* 目录然后编译即可。

## 贡献者 ✨

感谢这些可爱的童鞋为中文手册做出的卓越贡献。 ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
  <tr>
    <td align="center"><a href="http://alexfu.cc"><img src="https://avatars3.githubusercontent.com/u/9924787?v=4" width="100px;" alt=""/><br /><sub><b>Alexander.Fu</b></sub></a><br /><a href="#translation-FlyingWings" title="Translation">🌍</a></td>
    <td align="center"><a href="http://www.wazidw.com"><img src="https://avatars0.githubusercontent.com/u/4579995?v=4" width="100px;" alt=""/><br /><sub><b>wazidw</b></sub></a><br /><a href="#translation-wazidw" title="Translation">🌍</a> <a href="#projectManagement-wazidw" title="Project Management">📆</a> <a href="https://github.com/CodeIgniter-Chinese/codeigniter4-user-guide/pulls?q=is%3Apr+reviewed-by%3Awazidw" title="Reviewed Pull Requests">👀</a></td>
    <td align="center"><a href="https://github.com/zhangxiaoshua"><img src="https://avatars3.githubusercontent.com/u/31472394?v=4" width="100px;" alt=""/><br /><sub><b>zhangxiaoshua</b></sub></a><br /><a href="#translation-zhangxiaoshua" title="Translation">🌍</a></td>
    <td align="center"><a href="https://www.qichengzx.com"><img src="https://avatars0.githubusercontent.com/u/1927478?v=4" width="100px;" alt=""/><br /><sub><b>xin zhao</b></sub></a><br /><a href="#translation-qichengzx" title="Translation">🌍</a></td>
    <td align="center"><a href="https://www.minipudding.com"><img src="https://avatars0.githubusercontent.com/u/11162253?v=4" width="100px;" alt=""/><br /><sub><b>icicle198514</b></sub></a><br /><a href="#translation-icicle198514" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/calciferlh"><img src="https://avatars0.githubusercontent.com/u/14966692?v=4" width="100px;" alt=""/><br /><sub><b>Calcifer</b></sub></a><br /><a href="#translation-calciferlh" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/DuXuanXuan"><img src="https://avatars1.githubusercontent.com/u/17022815?v=4" width="100px;" alt=""/><br /><sub><b>DuXuanXuan</b></sub></a><br /><a href="#translation-DuXuanXuan" title="Translation">🌍</a></td>
  </tr>
  <tr>
    <td align="center"><a href="http://amberoracle.blog.163.com/"><img src="https://avatars0.githubusercontent.com/u/9973560?v=4" width="100px;" alt=""/><br /><sub><b>amberhu</b></sub></a><br /><a href="#translation-amberzizi" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/te-riper"><img src="https://avatars3.githubusercontent.com/u/33308188?v=4" width="100px;" alt=""/><br /><sub><b>te-riper</b></sub></a><br /><a href="#translation-te-riper" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/tlingYX"><img src="https://avatars3.githubusercontent.com/u/28684950?v=4" width="100px;" alt=""/><br /><sub><b>tlingYX</b></sub></a><br /><a href="#translation-tlingYX" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.red"><img src="https://avatars3.githubusercontent.com/u/12731778?v=4" width="100px;" alt=""/><br /><sub><b>John Wu</b></sub></a><br /><a href="#translation-wuhan005" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/FirstPunch"><img src="https://avatars0.githubusercontent.com/u/47411716?v=4" width="100px;" alt=""/><br /><sub><b>FirstPunch</b></sub></a><br /><a href="#translation-FirstPunch" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/chengshao2014"><img src="https://avatars2.githubusercontent.com/u/6170936?v=4" width="100px;" alt=""/><br /><sub><b>chengshao2014</b></sub></a><br /><a href="#translation-chengshao2014" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/wuzheng40"><img src="https://avatars2.githubusercontent.com/u/1391798?v=4" width="100px;" alt=""/><br /><sub><b>Ryan Wu</b></sub></a><br /><a href="#translation-wuzheng40" title="Translation">🌍</a></td>
  </tr>
  <tr>
    <td align="center"><a href="https://github.com/lsc77"><img src="https://avatars2.githubusercontent.com/u/17445192?v=4" width="100px;" alt=""/><br /><sub><b>lsc77</b></sub></a><br /><a href="#translation-lsc77" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/lockemgt"><img src="https://avatars0.githubusercontent.com/u/50262134?v=4" width="100px;" alt=""/><br /><sub><b>LockeMGT</b></sub></a><br /><a href="#translation-lockemgt" title="Translation">🌍</a></td>
    <td align="center"><a href="https://www.cnblogs.com/Andres/"><img src="https://avatars2.githubusercontent.com/u/24663432?v=4" width="100px;" alt=""/><br /><sub><b>Li Wang</b></sub></a><br /><a href="#translation-leven87" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/crazePhper"><img src="https://avatars2.githubusercontent.com/u/21233129?v=4" width="100px;" alt=""/><br /><sub><b>小叮当的肚兜</b></sub></a><br /><a href="#translation-crazePhper" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/arcsinw"><img src="https://avatars3.githubusercontent.com/u/10514065?v=4" width="100px;" alt=""/><br /><sub><b>arcsinw</b></sub></a><br /><a href="#translation-arcsinw" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/Qnurye"><img src="https://avatars0.githubusercontent.com/u/50016379?v=4" width="100px;" alt=""/><br /><sub><b>Qnurye</b></sub></a><br /><a href="#translation-Qnurye" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/JerryGai"><img src="https://avatars2.githubusercontent.com/u/38777583?v=4" width="100px;" alt=""/><br /><sub><b>JerryGai</b></sub></a><br /><a href="#translation-JerryGai" title="Translation">🌍</a></td>
  </tr>
  <tr>
    <td align="center"><a href="https://codeigniter.org.cn"><img src="https://avatars1.githubusercontent.com/u/13709?v=4" width="100px;" alt=""/><br /><sub><b>Hex</b></sub></a><br /><a href="#translation-hex-ci" title="Translation">🌍</a> <a href="#maintenance-hex-ci" title="Maintenance">🚧</a> <a href="#projectManagement-hex-ci" title="Project Management">📆</a> <a href="https://github.com/CodeIgniter-Chinese/codeigniter4-user-guide/pulls?q=is%3Apr+reviewed-by%3Ahex-ci" title="Reviewed Pull Requests">👀</a></td>
    <td align="center"><a href="https://github.com/bangbangda"><img src="https://avatars1.githubusercontent.com/u/13864407?v=4" width="100px;" alt=""/><br /><sub><b>24Kdabaiyang</b></sub></a><br /><a href="#translation-bangbangda" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/tianpanhaha"><img src="https://avatars3.githubusercontent.com/u/8691684?v=4" width="100px;" alt=""/><br /><sub><b>tianpanhaha</b></sub></a><br /><a href="#translation-tianpanhaha" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/visvoy"><img src="https://avatars1.githubusercontent.com/u/376332?v=4" width="100px;" alt=""/><br /><sub><b>visvoy</b></sub></a><br /><a href="#translation-visvoy" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/yeye978151"><img src="https://avatars1.githubusercontent.com/u/23291154?v=4" width="100px;" alt=""/><br /><sub><b>张叶</b></sub></a><br /><a href="#translation-yeye978151" title="Translation">🌍</a></td>
  </tr>
</table>

<!-- markdownlint-enable -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->

本项目遵循 [all-contributors](https://github.com/all-contributors/all-contributors) 规范。欢迎任何形式的贡献！