提交 4f48fe43 编写于 作者: Lab机器人's avatar Lab机器人

CODE CHINA

上级 e10a3bd1
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
## 概览[](#概览 "Permalink") ## 概览[](#概览 "Permalink")
欢迎您使用CODEChina,如果您是 Github 或 GitLab 的初级用户,我们建议您从查看本文档开始学习如何使用 CODEChina。如果您熟悉以上两个产品中的一个或多个,您可以直接开始 CODEChina 产品,在产品中我们也会为您设置帮助提示,您可以随时回来查看我们的产品文档。 欢迎您使用CODE CHINA,如果您是 Github 或 GitLab 的初级用户,我们建议您从查看本文档开始学习如何使用 CODE CHINA。如果您熟悉以上两个产品中的一个或多个,您可以直接开始 CODE CHINA 产品,在产品中我们也会为您设置帮助提示,您可以随时回来查看我们的产品文档。
| 基础入门 | 基本入门 | | 基础入门 | 基本入门 |
| --- | --- | | --- | --- |
| [**用户文件**](/docs/user)熟悉CODEChina 中的功能和概念. |[**是 Git 和 GitLab/GitHub 的新手吗?**](#刚开始使用gitcodechinagitlabgithub)我们有资源可以帮助您入门 | | [**用户文件**](/docs/user)熟悉CODE CHINA 中的功能和概念. |[**是 Git 和 GitLab/GitHub 的新手吗?**](#刚开始使用gitcodechinagitlabgithub)我们有资源可以帮助您入门 |
| [**为 CODEChina 做贡献**](#为codechina开源做贡献)为CODEChina开源贡献力量! | [**从另一个平台进入 CODEChina?**](#从另一个平台进入到-codechina)请查阅我们的便捷指南 | | [**为 CODE CHINA 做贡献**](#为codechina开源做贡献)为CODE CHINA开源贡献力量! | [**从另一个平台进入 CODE CHINA?**](#从另一个平台进入到-codechina)请查阅我们的便捷指南 |
## 热门话题[](#热门话题 "Permalink") ## 热门话题[](#热门话题 "Permalink")
...@@ -16,9 +16,9 @@ ...@@ -16,9 +16,9 @@
### 计划[](#计划 "Permalink") ### 计划[](#计划 "Permalink")
无论您使用 Waterfall,敏捷还是会话开发,CODEChina 均可简化您的协作工作流程。 无论您使用 Waterfall,敏捷还是会话开发,CODE CHINA 均可简化您的协作工作流程。
使用 CODEChina 灵活的项目管理工具可视化,确定优先级,协调和跟踪进度。 使用 CODE CHINA 灵活的项目管理工具可视化,确定优先级,协调和跟踪进度。
以下文档与 DevOps **计划**阶段有关: 以下文档与 DevOps **计划**阶段有关:
...@@ -44,7 +44,7 @@ ...@@ -44,7 +44,7 @@
将源代码整合到一个易于管理和控制的[分布式版本控制系统中](https://en.wikipedia.org/wiki/Distributed_version_control) ,而不会中断您的工作流程。 将源代码整合到一个易于管理和控制的[分布式版本控制系统中](https://en.wikipedia.org/wiki/Distributed_version_control) ,而不会中断您的工作流程。
CODEChina 存储库随附分支工具和访问控制,可为项目和代码的协作提供可扩展的单一事实来源。 CODE CHINA 存储库随附分支工具和访问控制,可为项目和代码的协作提供可扩展的单一事实来源。
以下文档与 DevOps **新建**阶段有关: 以下文档与 DevOps **新建**阶段有关:
...@@ -52,7 +52,7 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 ...@@ -52,7 +52,7 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的
| 创建主题-项目和组 | 描述 | | 创建主题-项目和组 | 描述 |
| --- | --- | | --- | --- |
| 全局搜索 | 利用 Elasticsearch 在整个 CODEChina 实例上进行更快,更高级的代码搜索| | 全局搜索 | 利用 Elasticsearch 在整个 CODE CHINA 实例上进行更快,更高级的代码搜索|
| 语法检索 | 使用高级查询获得更具针对性的搜索结果| | 语法检索 | 使用高级查询获得更具针对性的搜索结果|
| Contribution analytics | 请参阅小组贡献者的详细统计信息| | Contribution analytics | 请参阅小组贡献者的详细统计信息|
| [创建](/docs/basic/create-project)并 fork 项目,以及[导入项目](/docs/user/project/import) | 创建,复制和移动项目 | | [创建](/docs/basic/create-project)并 fork 项目,以及[导入项目](/docs/user/project/import) | 创建,复制和移动项目 |
...@@ -70,7 +70,7 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 ...@@ -70,7 +70,7 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的
| 创建主题-代码仓库 | 描述 | | 创建主题-代码仓库 | 描述 |
| --- | --- | | --- | --- |
| [分支](/docs/user/project/repo/branches)[默认分支](/docs/user/project/repo/branches#默认分支) | 如何在 CODEChina 中使用分支 | | [分支](/docs/user/project/repo/branches)[默认分支](/docs/user/project/repo/branches#默认分支) | 如何在 CODE CHINA 中使用分支 |
| [提交](/docs/user/project/repo#提交) and [署名提交](/docs/user/project/repo/gpg-sign) | 处理提交,并使用 GPG 对您的提交进行签名 | | [提交](/docs/user/project/repo#提交) and [署名提交](/docs/user/project/repo/gpg-sign) | 处理提交,并使用 GPG 对您的提交进行签名 |
| [创建分支](/docs/user/project/repo/web-editor#新建分支)[创建](/docs/user/project/repo/web-editor#创建文件)[上传](/docs/user/project/repo/web-editor#上传文件)文件,并[创建目录](/docs/user/project/repo/web-editor#新建目录) | 创建分支,创建和上传文件以及创建目录| | [创建分支](/docs/user/project/repo/web-editor#新建分支)[创建](/docs/user/project/repo/web-editor#创建文件)[上传](/docs/user/project/repo/web-editor#上传文件)文件,并[创建目录](/docs/user/project/repo/web-editor#新建目录) | 创建分支,创建和上传文件以及创建目录|
| [删除已合并的分支](/docs/user/project/repo/branches#删除已合并的分支) | 合并更改后的批量删除分支| | [删除已合并的分支](/docs/user/project/repo/branches#删除已合并的分支) | 合并更改后的批量删除分支|
...@@ -98,13 +98,13 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 ...@@ -98,13 +98,13 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的
[返回概览](#概览) [返回概览](#概览)
## 刚开始使用Git/CODEChina/GitLab/Github?[](#刚开始使用git吗 "Permalink") ## 刚开始使用Git/CODE CHINA/GitLab/Github?[](#刚开始使用git吗 "Permalink")
使用新系统可能让您觉得难以入手,我们有以下文档可快速提升您的相关知识: 使用新系统可能让您觉得难以入手,我们有以下文档可快速提升您的相关知识:
| 主题 | 描述 | | 主题 | 描述 |
| --- | --- | | --- | --- |
| Basics guides | 开始在命令行和 CODEChina 上工作 | | Basics guides | 开始在命令行和 CODE CHINA 上工作 |
| Workflow overview | 利用最佳的工作流程增强您的工作流程 | | Workflow overview | 利用最佳的工作流程增强您的工作流程 |
| [Markdown](/docs/user/markdown) | 高级格式化系统(Markdown) | | [Markdown](/docs/user/markdown) | 高级格式化系统(Markdown) |
...@@ -122,9 +122,9 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 ...@@ -122,9 +122,9 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的
[返回概览](#概览) [返回概览](#概览)
### Git 和 CODEChina[](#Git和CODEChina "Permalink") ### Git 和 CODE CHINA[](#Git和CODE CHINA "Permalink")
了解有关使用 Git 以及将 Git 与 CODEChina 结合使用的更多信息: 了解有关使用 Git 以及将 Git 与 CODE CHINA 结合使用的更多信息:
| 主题 | 描述 | | 主题 | 描述 |
| --- | --- | | --- | --- |
...@@ -134,21 +134,21 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 ...@@ -134,21 +134,21 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的
[返回概览](#概览) [返回概览](#概览)
## 从另一个平台进入到 CODEChina?[](#从另一个平台进入到codechina "Permalink") ## 从另一个平台进入到 CODE CHINA?[](#从另一个平台进入到codechina "Permalink")
如果您是从另一个平台进入 CODEChina,您会发现以下有用信息: 如果您是从另一个平台进入 CODE CHINA,您会发现以下有用信息:
| 主题 | 描述 | | 主题 | 描述 |
| --- | --- | | --- | --- |
| [导入项目](/docs/user/project/import) | 从 GitHub 和 SVN 导入项目 | | [导入项目](/docs/user/project/import) | 从 GitHub 和 SVN 导入项目 |
| 从SVN迁移 | 将 SVN 存储库转换为 Git 和 CODEChina | | 从SVN迁移 | 将 SVN 存储库转换为 Git 和 CODE CHINA |
[返回概览](#概览) [返回概览](#概览)
## 为CODEChina开源做贡献[](#为codehina开源做贡献 "Permalink") ## 为CODE CHINA开源做贡献[](#为codehina开源做贡献 "Permalink")
CODEChina 是开源的,您可以通过以下方式为我们的开源社区做出贡献: CODE CHINA 是开源的,您可以通过以下方式为我们的开源社区做出贡献:
| 主题 | 描述 | | 主题 | 描述 |
......
{ {
"title" : "CODEChina帮助文档", "title" : "CODE CHINA帮助文档",
"author" : "Miykael", "author" : "Miykael",
"description" : "CODEChina开源社区用户使用及帮助文档", "description" : "CODE CHINA开源社区用户使用及帮助文档",
"language" : "zh-hans", "language" : "zh-hans",
"links" : { "links" : {
"sidebar" : { "sidebar" : {
......
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
## 概览[](#概览 "Permalink") ## 概览[](#概览 "Permalink")
欢迎您使用CODEChina,如果您是 Github 或 GitLab 的初级用户,我们建议您从查看本文档开始学习如何使用 CODEChina。如果您熟悉以上两个产品中的一个或多个,您可以直接开始 CODEChina 产品,在产品中我们也会为您设置帮助提示,您可以随时回来查看我们的产品文档。 欢迎您使用CODE CHINA,如果您是 Github 或 GitLab 的初级用户,我们建议您从查看本文档开始学习如何使用 CODE CHINA。如果您熟悉以上两个产品中的一个或多个,您可以直接开始 CODE CHINA 产品,在产品中我们也会为您设置帮助提示,您可以随时回来查看我们的产品文档。
| 基础入门 | 基本入门 | | 基础入门 | 基本入门 |
| --- | --- | | --- | --- |
| [**用户文件**](/docs/user)熟悉CODEChina 中的功能和概念. |[**是 Git 和 GitLab/GitHub 的新手吗?**](#刚开始使用gitcodechinagitlabgithub)我们有资源可以帮助您入门 | | [**用户文件**](/docs/user)熟悉CODE CHINA 中的功能和概念. |[**是 Git 和 GitLab/GitHub 的新手吗?**](#刚开始使用gitcodechinagitlabgithub)我们有资源可以帮助您入门 |
| [**为 CODEChina 做贡献**](#为codechina开源做贡献)为CODEChina开源贡献力量! | [**从另一个平台进入 CODEChina?**](#从另一个平台进入到-codechina)请查阅我们的便捷指南 | | [**为 CODE CHINA 做贡献**](#为codechina开源做贡献)为CODE CHINA开源贡献力量! | [**从另一个平台进入 CODE CHINA?**](#从另一个平台进入到-codechina)请查阅我们的便捷指南 |
## 热门话题[](#热门话题 "Permalink") ## 热门话题[](#热门话题 "Permalink")
...@@ -16,9 +16,9 @@ ...@@ -16,9 +16,9 @@
### 计划[](#计划 "Permalink") ### 计划[](#计划 "Permalink")
无论您使用 Waterfall,敏捷还是会话开发,CODEChina 均可简化您的协作工作流程。 无论您使用 Waterfall,敏捷还是会话开发,CODE CHINA 均可简化您的协作工作流程。
使用 CODEChina 灵活的项目管理工具可视化,确定优先级,协调和跟踪进度。 使用 CODE CHINA 灵活的项目管理工具可视化,确定优先级,协调和跟踪进度。
以下文档与 DevOps **计划**阶段有关: 以下文档与 DevOps **计划**阶段有关:
...@@ -44,7 +44,7 @@ ...@@ -44,7 +44,7 @@
将源代码整合到一个易于管理和控制的[分布式版本控制系统中](https://en.wikipedia.org/wiki/Distributed_version_control) ,而不会中断您的工作流程。 将源代码整合到一个易于管理和控制的[分布式版本控制系统中](https://en.wikipedia.org/wiki/Distributed_version_control) ,而不会中断您的工作流程。
CODEChina 存储库随附分支工具和访问控制,可为项目和代码的协作提供可扩展的单一事实来源。 CODE CHINA 存储库随附分支工具和访问控制,可为项目和代码的协作提供可扩展的单一事实来源。
以下文档与 DevOps **新建**阶段有关: 以下文档与 DevOps **新建**阶段有关:
...@@ -52,7 +52,7 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 ...@@ -52,7 +52,7 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的
| 创建主题-项目和组 | 描述 | | 创建主题-项目和组 | 描述 |
| --- | --- | | --- | --- |
| 全局搜索 | 利用 Elasticsearch 在整个 CODEChina 实例上进行更快,更高级的代码搜索| | 全局搜索 | 利用 Elasticsearch 在整个 CODE CHINA 实例上进行更快,更高级的代码搜索|
| 语法检索 | 使用高级查询获得更具针对性的搜索结果| | 语法检索 | 使用高级查询获得更具针对性的搜索结果|
| Contribution analytics | 请参阅小组贡献者的详细统计信息| | Contribution analytics | 请参阅小组贡献者的详细统计信息|
| [创建](/docs/basic/create-project)并 fork 项目,以及[导入项目](/docs/user/project/import) | 创建,复制和移动项目 | | [创建](/docs/basic/create-project)并 fork 项目,以及[导入项目](/docs/user/project/import) | 创建,复制和移动项目 |
...@@ -70,7 +70,7 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 ...@@ -70,7 +70,7 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的
| 创建主题-代码仓库 | 描述 | | 创建主题-代码仓库 | 描述 |
| --- | --- | | --- | --- |
| [分支](/docs/user/project/repo/branches)[默认分支](/docs/user/project/repo/branches#默认分支) | 如何在 CODEChina 中使用分支 | | [分支](/docs/user/project/repo/branches)[默认分支](/docs/user/project/repo/branches#默认分支) | 如何在 CODE CHINA 中使用分支 |
| [提交](/docs/user/project/repo#提交) and [署名提交](/docs/user/project/repo/gpg-sign) | 处理提交,并使用 GPG 对您的提交进行签名 | | [提交](/docs/user/project/repo#提交) and [署名提交](/docs/user/project/repo/gpg-sign) | 处理提交,并使用 GPG 对您的提交进行签名 |
| [创建分支](/docs/user/project/repo/web-editor#新建分支)[创建](/docs/user/project/repo/web-editor#创建文件)[上传](/docs/user/project/repo/web-editor#上传文件)文件,并[创建目录](/docs/user/project/repo/web-editor#新建目录) | 创建分支,创建和上传文件以及创建目录| | [创建分支](/docs/user/project/repo/web-editor#新建分支)[创建](/docs/user/project/repo/web-editor#创建文件)[上传](/docs/user/project/repo/web-editor#上传文件)文件,并[创建目录](/docs/user/project/repo/web-editor#新建目录) | 创建分支,创建和上传文件以及创建目录|
| [删除已合并的分支](/docs/user/project/repo/branches#删除已合并的分支) | 合并更改后的批量删除分支| | [删除已合并的分支](/docs/user/project/repo/branches#删除已合并的分支) | 合并更改后的批量删除分支|
...@@ -98,13 +98,13 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 ...@@ -98,13 +98,13 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的
[返回概览](#概览) [返回概览](#概览)
## 刚开始使用Git/CODEChina/GitLab/Github?[](#刚开始使用git吗 "Permalink") ## 刚开始使用Git/CODE CHINA/GitLab/Github?[](#刚开始使用git吗 "Permalink")
使用新系统可能让您觉得难以入手,我们有以下文档可快速提升您的相关知识: 使用新系统可能让您觉得难以入手,我们有以下文档可快速提升您的相关知识:
| 主题 | 描述 | | 主题 | 描述 |
| --- | --- | | --- | --- |
| Basics guides | 开始在命令行和 CODEChina 上工作 | | Basics guides | 开始在命令行和 CODE CHINA 上工作 |
| Workflow overview | 利用最佳的工作流程增强您的工作流程 | | Workflow overview | 利用最佳的工作流程增强您的工作流程 |
| [Markdown](/docs/user/markdown) | 高级格式化系统(Markdown) | | [Markdown](/docs/user/markdown) | 高级格式化系统(Markdown) |
...@@ -122,9 +122,9 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 ...@@ -122,9 +122,9 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的
[返回概览](#概览) [返回概览](#概览)
### Git 和 CODEChina[](#Git和CODEChina "Permalink") ### Git 和 CODE CHINA[](#Git和CODE CHINA "Permalink")
了解有关使用 Git 以及将 Git 与 CODEChina 结合使用的更多信息: 了解有关使用 Git 以及将 Git 与 CODE CHINA 结合使用的更多信息:
| 主题 | 描述 | | 主题 | 描述 |
| --- | --- | | --- | --- |
...@@ -134,21 +134,21 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 ...@@ -134,21 +134,21 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的
[返回概览](#概览) [返回概览](#概览)
## 从另一个平台进入到 CODEChina?[](#从另一个平台进入到codechina "Permalink") ## 从另一个平台进入到 CODE CHINA?[](#从另一个平台进入到codechina "Permalink")
如果您是从另一个平台进入 CODEChina,您会发现以下有用信息: 如果您是从另一个平台进入 CODE CHINA,您会发现以下有用信息:
| 主题 | 描述 | | 主题 | 描述 |
| --- | --- | | --- | --- |
| [导入项目](/docs/user/project/import) | 从 GitHub 和 SVN 导入项目 | | [导入项目](/docs/user/project/import) | 从 GitHub 和 SVN 导入项目 |
| 从SVN迁移 | 将 SVN 存储库转换为 Git 和 CODEChina | | 从SVN迁移 | 将 SVN 存储库转换为 Git 和 CODE CHINA |
[返回概览](#概览) [返回概览](#概览)
## 为CODEChina开源做贡献[](#为codehina开源做贡献 "Permalink") ## 为CODE CHINA开源做贡献[](#为codehina开源做贡献 "Permalink")
CODEChina 是开源的,您可以通过以下方式为我们的开源社区做出贡献: CODE CHINA 是开源的,您可以通过以下方式为我们的开源社区做出贡献:
| 主题 | 描述 | | 主题 | 描述 |
......
# SSH密钥[](#ssh "Permalink") # SSH密钥[](#ssh "Permalink")
Git 是一个分布式版本控制系统,这意味着您可以在本地工作. 此外,您还可以将更改共享或"推送"到其他服务器. CODEChina 支持使用 SSH 密钥在 Git 及其服务器之间进行安全通信. Git 是一个分布式版本控制系统,这意味着您可以在本地工作. 此外,您还可以将更改共享或"推送"到其他服务器. CODE CHINA 支持使用 SSH 密钥在 Git 及其服务器之间进行安全通信.
SSH 协议提供的这种安全机制,并允许您向 CODEChina 远程服务器进行身份验证,而无需每次都提供用户名或密码,我们推荐您使用这种方式来作为您推拉代码的凭据。 SSH 协议提供的这种安全机制,并允许您向 CODE CHINA 远程服务器进行身份验证,而无需每次都提供用户名或密码,我们推荐您使用这种方式来作为您推拉代码的凭据。
通过阅读本文档可以帮助您配置安全的 SSH 密钥,这些密钥可用于帮助保护与 CODEChina 代码仓库的安全连接。 通过阅读本文档可以帮助您配置安全的 SSH 密钥,这些密钥可用于帮助保护与 CODE CHINA 代码仓库的安全连接。
* 如果您需要有关创建 SSH 密钥的信息,请从我们的[ SSH 密钥选项](#options-for-ssh-keys)开始 * 如果您需要有关创建 SSH 密钥的信息,请从我们的[ SSH 密钥选项](#options-for-ssh-keys)开始
* 如果您有专用于 CODEChina 帐户的 SSH 密钥,则可能对[使用非默认 SSH 密钥对路径](#working-with-non-default-ssh-key-pair-paths)感兴趣 * 如果您有专用于 CODE CHINA 帐户的 SSH 密钥,则可能对[使用非默认 SSH 密钥对路径](#working-with-non-default-ssh-key-pair-paths)感兴趣
* 如果您已经有了 SSH 密钥对,则可以转到[将 SSH 密钥添加到 CODEChina 帐户的方法](#adding-an-ssh-key-to-your-gitlab-account) * 如果您已经有了 SSH 密钥对,则可以转到[将 SSH 密钥添加到 CODE CHINA 帐户的方法](#adding-an-ssh-key-to-your-gitlab-account)
## 环境要求[](#requirements "Permalink") ## 环境要求[](#requirements "Permalink")
为了支持 SSH,CODEChina 需要安装 OpenSSH 客户端,该客户端已预装在 GNU / Linux 和 macOS 上,但未预先安装在 Windows 上。 为了支持 SSH,CODE CHINA 需要安装 OpenSSH 客户端,该客户端已预装在 GNU / Linux 和 macOS 上,但未预先安装在 Windows 上。
我们要求您使用 SSH 6.5 或更高版本,因为它不包括现在不安全的 MD5 签名。您可以通过下命令查看系统上安装的 SSH 版本: 我们要求您使用 SSH 6.5 或更高版本,因为它不包括现在不安全的 MD5 签名。您可以通过下命令查看系统上安装的 SSH 版本:
...@@ -22,7 +22,7 @@ ssh -V ...@@ -22,7 +22,7 @@ ssh -V
## SSH 密钥选项[](#options-for-ssh-keys "Permalink") ## SSH 密钥选项[](#options-for-ssh-keys "Permalink")
CODEChina 支持使用 RSA,DSA,ECDSA 和 ED25519 密钥。 CODE CHINA 支持使用 RSA,DSA,ECDSA 和 ED25519 密钥。
**提示:**现有文档表明 ED25519 更安全,如果使用 RSA 密钥,则美国国家科学技术研究院[出版物 800-57 第 3 部分(PDF)](https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-57Pt3r1.pdf)建议密钥大小至少为 2048 位。 **提示:**现有文档表明 ED25519 更安全,如果使用 RSA 密钥,则美国国家科学技术研究院[出版物 800-57 第 3 部分(PDF)](https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-57Pt3r1.pdf)建议密钥大小至少为 2048 位。
...@@ -30,7 +30,7 @@ CODEChina 支持使用 RSA,DSA,ECDSA 和 ED25519 密钥。 ...@@ -30,7 +30,7 @@ CODEChina 支持使用 RSA,DSA,ECDSA 和 ED25519 密钥。
## 查看现有的 SSH 密钥[](#review-existing-ssh-keys "Permalink") ## 查看现有的 SSH 密钥[](#review-existing-ssh-keys "Permalink")
如果您已有 SSH 密钥,则可以使用它们来与 CODEChina 的代码库进行连接。 默认情况下,Linux 和 macOS 系统上的 SSH 密钥存储在用户的主目录中的`.ssh/`子目录中,下表包括每种 SSH 密钥算法的默认文件名: 如果您已有 SSH 密钥,则可以使用它们来与 CODE CHINA 的代码库进行连接。 默认情况下,Linux 和 macOS 系统上的 SSH 密钥存储在用户的主目录中的`.ssh/`子目录中,下表包括每种 SSH 密钥算法的默认文件名:
| 算法 | 公钥 | 私钥 | | 算法 | 公钥 | 私钥 |
| --- | --- | --- | | --- | --- | --- |
...@@ -128,7 +128,7 @@ ssh-keygen -p -f /path/to/ssh_key ...@@ -128,7 +128,7 @@ ssh-keygen -p -f /path/to/ssh_key
如果您的 OpenSSH 版本介于 6.5 至 7.8(含)之间,请使用`-o`选项运行`ssh-keygen` ,以更安全的 OpenSSH 格式保存您的 SSH 私钥。 如果您的 OpenSSH 版本介于 6.5 至 7.8(含)之间,请使用`-o`选项运行`ssh-keygen` ,以更安全的 OpenSSH 格式保存您的 SSH 私钥。
如果您已经具有可用于 CODEChina 的 RSA SSH 密钥,请考虑对其进行升级以使用更安全的密码加密格式。 您可以使用以下命令进行操作: 如果您已经具有可用于 CODE CHINA 的 RSA SSH 密钥,请考虑对其进行升级以使用更安全的密码加密格式。 您可以使用以下命令进行操作:
``` ```
ssh-keygen -o -f ~/.ssh/id_rsa ssh-keygen -o -f ~/.ssh/id_rsa
...@@ -142,9 +142,9 @@ ssh-keygen -o -t rsa -b 4096 -C "email@example.com" ...@@ -142,9 +142,9 @@ ssh-keygen -o -t rsa -b 4096 -C "email@example.com"
**注意:**ED25519 已将密钥加密为更安全的 OpenSSH 格式。 **注意:**ED25519 已将密钥加密为更安全的 OpenSSH 格式。
## 在您的 CODEChina 账号中添加 SSH 密钥[](#adding-an-ssh-key-to-your-account "Permalink") ## 在您的 CODE CHINA 账号中添加 SSH 密钥[](#adding-an-ssh-key-to-your-account "Permalink")
现在,您可以将创建好的 SSH 密钥复制到您的 CODEChina 帐户。您可以参考以下步骤: 现在,您可以将创建好的 SSH 密钥复制到您的 CODE CHINA 帐户。您可以参考以下步骤:
1. 从以文本格式保存 SSH 密钥的位置复制您的**公共** SSH 密钥,以下命令可以将 ED25519 的信息保存到指定操作系统的剪贴板中: 1. 从以文本格式保存 SSH 密钥的位置复制您的**公共** SSH 密钥,以下命令可以将 ED25519 的信息保存到指定操作系统的剪贴板中:
...@@ -188,7 +188,7 @@ ssh-keygen -o -t rsa -b 4096 -C "email@example.com" ...@@ -188,7 +188,7 @@ ssh-keygen -o -t rsa -b 4096 -C "email@example.com"
ssh -T git@codechina.csdn.net ssh -T git@codechina.csdn.net
``` ```
在您第一次通过 SSH 方式连接到 CODEChina的时候,将会询问您是否信任将要连接的 CODEChina host地址。当确认 `yes` 后,会将 CODEChina 作为已知主机添加到受信任的 hosts 地址中: 在您第一次通过 SSH 方式连接到 CODE CHINA的时候,将会询问您是否信任将要连接的 CODE CHINA host地址。当确认 `yes` 后,会将 CODE CHINA 作为已知主机添加到受信任的 hosts 地址中:
``` ```
The authenticity of host 'codechina.csdn.net (121.36.6.22)' can't be established. The authenticity of host 'codechina.csdn.net (121.36.6.22)' can't be established.
...@@ -197,7 +197,7 @@ Are you sure you want to continue connecting (yes/no)? yes ...@@ -197,7 +197,7 @@ Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'codechina.csdn.net' (ECDSA) to the list of known hosts. Warning: Permanently added 'codechina.csdn.net' (ECDSA) to the list of known hosts.
``` ```
一旦添加到已知主机列表中,将不再要求您再次验证 CODEChina 主机的真实性。 再次运行以上命令时,您将只收到*欢迎使用 CODEChina 的`@username` !* 信息。 一旦添加到已知主机列表中,将不再要求您再次验证 CODE CHINA 主机的真实性。 再次运行以上命令时,您将只收到*欢迎使用 CODE CHINA 的`@username` !* 信息。
如果未出现欢迎消息,则可以通过使用以下命令在详细模式下运行`ssh`来解决问题: 如果未出现欢迎消息,则可以通过使用以下命令在详细模式下运行`ssh`来解决问题:
...@@ -207,7 +207,7 @@ ssh -Tv git@codechina.csdn.net ...@@ -207,7 +207,7 @@ ssh -Tv git@codechina.csdn.net
## 使用非默认路径的 SSH 密钥[](#working-with-non-default-ssh-key-pair-paths "Permalink") ## 使用非默认路径的 SSH 密钥[](#working-with-non-default-ssh-key-pair-paths "Permalink")
如果您为 SSH 密钥对使用了非默认文件路径,请配置 SSH 客户端以指向 CODEChina 私有 SSH 密钥。 如果您为 SSH 密钥对使用了非默认文件路径,请配置 SSH 客户端以指向 CODE CHINA 私有 SSH 密钥。
可以运行以下命令进行配置: 可以运行以下命令进行配置:
...@@ -216,10 +216,10 @@ eval $(ssh-agent -s) ...@@ -216,10 +216,10 @@ eval $(ssh-agent -s)
ssh-add <path to private SSH key> ssh-add <path to private SSH key>
``` ```
以上设置将会保存到`~/.ssh/config`文件中。以下是两个专用于 CODEChina 的 SSH 密钥示例: 以上设置将会保存到`~/.ssh/config`文件中。以下是两个专用于 CODE CHINA 的 SSH 密钥示例:
``` ```
# CODEChina # CODE CHINA
Host codechina.csdn.net Host codechina.csdn.net
Preferredauthentications publickey Preferredauthentications publickey
IdentityFile ~/.ssh/codechina_rsa IdentityFile ~/.ssh/codechina_rsa
...@@ -230,7 +230,7 @@ ssh-add <path to private SSH key> ...@@ -230,7 +230,7 @@ ssh-add <path to private SSH key>
IdentityFile ~/.ssh/example_github_rsa IdentityFile ~/.ssh/example_github_rsa
``` ```
公共 SSH 密钥对于 CODEChina 必须是唯一的,因为它们将绑定到您的账号中。 SSH 密钥是通过 SSH 推送代码时唯一的标识符,这是为什么它需要唯一地映射到单个用户的原因。 公共 SSH 密钥对于 CODE CHINA 必须是唯一的,因为它们将绑定到您的账号中。 SSH 密钥是通过 SSH 推送代码时唯一的标识符,这是为什么它需要唯一地映射到单个用户的原因。
## 为项目设置 SSH 密钥[](#per-repository-ssh-keys "Permalink") ## 为项目设置 SSH 密钥[](#per-repository-ssh-keys "Permalink")
...@@ -244,7 +244,7 @@ git config core.sshCommand "ssh -o IdentitiesOnly=yes -i ~/.ssh/private-key-file ...@@ -244,7 +244,7 @@ git config core.sshCommand "ssh -o IdentitiesOnly=yes -i ~/.ssh/private-key-file
## 多账号设置[](#multiple-accounts-on-a-single-gitlab-instance "Permalink") ## 多账号设置[](#multiple-accounts-on-a-single-gitlab-instance "Permalink")
[为项目设置 SSH 密钥](#per-repository-ssh-keys)方法还适用于在 CODEChina 中使用多个账号的情况。 [为项目设置 SSH 密钥](#per-repository-ssh-keys)方法还适用于在 CODE CHINA 中使用多个账号的情况。
此外,您也可以直接在`~.ssh/config`为主机分配别名。 如果在`.ssh/config`中的`Host`块之外设置了`IdentityFile` ,则 SSH 和作为扩展的 Git 将无法登录. 这是 SSH 组装`IdentityFile`条目的方式,因此不能通过将`IdentitiesOnly`设置为`yes`来更改. `IdentityFile`条目应指向 SSH 密钥对的私钥。 此外,您也可以直接在`~.ssh/config`为主机分配别名。 如果在`.ssh/config`中的`Host`块之外设置了`IdentityFile` ,则 SSH 和作为扩展的 Git 将无法登录. 这是 SSH 组装`IdentityFile`条目的方式,因此不能通过将`IdentitiesOnly`设置为`yes`来更改. `IdentityFile`条目应指向 SSH 密钥对的私钥。
...@@ -264,7 +264,7 @@ git config core.sshCommand "ssh -o IdentitiesOnly=yes -i ~/.ssh/private-key-file ...@@ -264,7 +264,7 @@ git config core.sshCommand "ssh -o IdentitiesOnly=yes -i ~/.ssh/private-key-file
**注意:**为提高效率和透明度,示例`Host`别名定义为`user_1.codechina.csdn.net``user_2.codechina.csdn.net` 。 高级配置难以维护,使用这种别名在使用其他工具(如`git remote`子命令)时会更容易理解。 SSH 可以将任何字符串理解为`Host`别名,因此`Tanuki1``Tanuki2`尽管提供了很少的上下文指向它们,也可以使用. **注意:**为提高效率和透明度,示例`Host`别名定义为`user_1.codechina.csdn.net``user_2.codechina.csdn.net` 。 高级配置难以维护,使用这种别名在使用其他工具(如`git remote`子命令)时会更容易理解。 SSH 可以将任何字符串理解为`Host`别名,因此`Tanuki1``Tanuki2`尽管提供了很少的上下文指向它们,也可以使用.
克隆`CODEChina`代码仓库通常如下所示: 克隆`CODE CHINA`代码仓库通常如下所示:
``` ```
git clone git@gcodechina.csdn.net:repo-org/repo.git git clone git@gcodechina.csdn.net:repo-org/repo.git
...@@ -303,6 +303,6 @@ git remote set-url origin git@<user_1.codechina.csdn.net>:repo-org/repo.git ...@@ -303,6 +303,6 @@ git remote set-url origin git@<user_1.codechina.csdn.net>:repo-org/repo.git
如果在 Git Clone 上,系统会提示您输入密码,例如`git@codechina.csdn.net's password:`,则表明您的 SSH 设置有问题。 如果在 Git Clone 上,系统会提示您输入密码,例如`git@codechina.csdn.net's password:`,则表明您的 SSH 设置有问题。
* 确保您正确地生成了 SSH 密钥,并将公共 SSH 密钥添加到了您 CODEChina 账号的 SSH 密钥中 * 确保您正确地生成了 SSH 密钥,并将公共 SSH 密钥添加到了您 CODE CHINA 账号的 SSH 密钥中
* 尝试使用`ssh-agent`手动注册您的私有 SSH 密钥,如本文档前面所述 * 尝试使用`ssh-agent`手动注册您的私有 SSH 密钥,如本文档前面所述
* 尝试通过运行`ssh -Tv git@codechina.csdn.net`调试连接 * 尝试通过运行`ssh -Tv git@codechina.csdn.net`调试连接
\ No newline at end of file
# 用户文档[](#user "Permalink") # 用户文档[](#user "Permalink")
欢迎您开始使用CODEChina作为您的项目/开源项目代码托管平台! 欢迎您开始使用CODE CHINA作为您的项目/开源项目代码托管平台!
CODEChina 是一个基于 Git 的平台,它集成了许多用于软件开发和部署以及项目管理的基本工具: CODE CHINA 是一个基于 Git 的平台,它集成了许多用于软件开发和部署以及项目管理的基本工具:
* 通过版本控制在代码仓库中托管代码 * 通过版本控制在代码仓库中托管代码
* 使用功能齐全的[Issues](/docs/user/project/issues#issue-列表)跟踪有关新功能开发、错误报告及反馈的建议 * 使用功能齐全的[Issues](/docs/user/project/issues#issue-列表)跟踪有关新功能开发、错误报告及反馈的建议
...@@ -55,8 +55,8 @@ CODEChina 是一个基于 Git 的平台,它集成了许多用于软件开发 ...@@ -55,8 +55,8 @@ CODEChina 是一个基于 Git 的平台,它集成了许多用于软件开发
## 快捷键[](#shortcutkey "Permalink") ## 快捷键[](#shortcutkey "Permalink")
CODEChina中支持许多[快捷键](/docs/user/shortcutkey) ,帮助您更方便的在页面之间进行切换、更快地完成任务。 CODE CHINA中支持许多[快捷键](/docs/user/shortcutkey) ,帮助您更方便的在页面之间进行切换、更快地完成任务。
## Webhooks[](#webhooks "Permalink") ## Webhooks[](#webhooks "Permalink")
配置webhook]以侦听特定事件,例如推送,问题或合并请求。CODEChina会将相关数据通过 POST 请求发送到 webhook 中配置的 URL 中。 配置webhook]以侦听特定事件,例如推送,问题或合并请求。CODE CHINA会将相关数据通过 POST 请求发送到 webhook 中配置的 URL 中。
\ No newline at end of file \ No newline at end of file
# 用户账号[](#用户账号 "Permalink") # 用户账号[](#用户账号 "Permalink")
您的个人资料请前往 [CSDN 个人中心](https://i.csdn.net/#/uc/profile) 进行修改设置,修改后的资料我们将在您下次一登录 CODEChina 的时候进行同步更新。 您的个人资料请前往 [CSDN 个人中心](https://i.csdn.net/#/uc/profile) 进行修改设置,修改后的资料我们将在您下次一登录 CODE CHINA 的时候进行同步更新。
## 个人资料[](#user-profile "Permalink") ## 个人资料[](#user-profile "Permalink")
......
# 电子邮件通知[](#电子邮件通知 "Permalink") # 电子邮件通知[](#电子邮件通知 "Permalink")
通知使您可以随时了解 CODEChina 中发生的事情,启用通知后,您可以接收有关 Issue、合并请求和 Epic 活动的更新,通知将通过电子邮件发送。 通知使您可以随时了解 CODE CHINA 中发生的事情,启用通知后,您可以接收有关 Issue、合并请求和 Epic 活动的更新,通知将通过电子邮件发送。
## 接收通知[](#receiving-notifications "Permalink") ## 接收通知[](#receiving-notifications "Permalink")
...@@ -15,7 +15,7 @@ ...@@ -15,7 +15,7 @@
## 调整你的通知[](#tuning-your-notifications "Permalink") ## 调整你的通知[](#tuning-your-notifications "Permalink")
通知的数量可能是巨大的,CODEChina 允许您调整收到的通知。例如,您可能希望收到有关特定项目中所有活动的通知,而对于其他项目,仅当您的名字被提及时才得到通知。 通知的数量可能是巨大的,CODE CHINA 允许您调整收到的通知。例如,您可能希望收到有关特定项目中所有活动的通知,而对于其他项目,仅当您的名字被提及时才得到通知。
您可以通过组合通知设置来调整收到的通知: 您可以通过组合通知设置来调整收到的通知:
...@@ -175,9 +175,9 @@ ...@@ -175,9 +175,9 @@
## 过滤 email[](#filtering-email "Permalink") ## 过滤 email[](#filtering-email "Permalink")
通知电子邮件包括特定于 CODEChina 的标题。您可以根据这些标头的内容过滤通知电子邮件,以更好地管理您的通知。 例如,您可以过滤特定项目的所有电子邮件,在该项目中您将被分配合并请求或问题。 通知电子邮件包括特定于 CODE CHINA 的标题。您可以根据这些标头的内容过滤通知电子邮件,以更好地管理您的通知。 例如,您可以过滤特定项目的所有电子邮件,在该项目中您将被分配合并请求或问题。
下表列出了所有特定于 CODEChina 的电子邮件标题: 下表列出了所有特定于 CODE CHINA 的电子邮件标题:
| 标题 | 描述 | | 标题 | 描述 |
| --- | --- | | --- | --- |
......
# 登录日志[](#logs "Permalink") # 登录日志[](#logs "Permalink")
CODEChina 列出了已登录到您帐户的所有设备,这使您可以查看会话,并撤销所有您不认识的会话。 CODE CHINA 列出了已登录到您帐户的所有设备,这使您可以查看会话,并撤销所有您不认识的会话。
## 列出所有活动会话[](#listing-all-active-sessions "Permalink") ## 列出所有活动会话[](#listing-all-active-sessions "Permalink")
...@@ -10,9 +10,9 @@ CODEChina 列出了已登录到您帐户的所有设备,这使您可以查看 ...@@ -10,9 +10,9 @@ CODEChina 列出了已登录到您帐户的所有设备,这使您可以查看
## 活动会话限制[](#active-sessions-limit "Permalink") ## 活动会话限制[](#active-sessions-limit "Permalink")
CODEChina 允许用户一次拥有多达 100 个活动会话,如果活动会话数超过 100,则最早的会话将被删除。 CODE CHINA 允许用户一次拥有多达 100 个活动会话,如果活动会话数超过 100,则最早的会话将被删除。
## 撤消一个会话[](#revoking-a-session "Permalink") ## 撤消一个会话[](#revoking-a-session "Permalink")
1. 使用前面的步骤导航到**活动会话** 1. 使用前面的步骤导航到**活动会话**
2. 单击除会话外的**撤消**,当前会话无法撤消,因为这将使您退出 CODEChina。 2. 单击除会话外的**撤消**,当前会话无法撤消,因为这将使您退出 CODE CHINA。
\ No newline at end of file \ No newline at end of file
# 组织[](#组织 "Permalink") # 组织[](#组织 "Permalink")
通过 CODEChina 的组织,您可以: 通过 CODE CHINA 的组织,您可以:
* 将相关项目组装在一起 * 将相关项目组装在一起
* 授予成员一次访问多个项目的权限 * 授予成员一次访问多个项目的权限
...@@ -39,7 +39,7 @@ ...@@ -39,7 +39,7 @@
## 命名空间[](#命名空间 "Permalink") ## 命名空间[](#命名空间 "Permalink")
在 CODEChina 中,命名空间将会是用户名称、组织名称或子组名的唯一名称。 在 CODE CHINA 中,命名空间将会是用户名称、组织名称或子组名的唯一名称。
* `https://codechina.csdn.net/username` * `https://codechina.csdn.net/username`
* `https://codechina.csdn.net/groupname` * `https://codechina.csdn.net/groupname`
...@@ -47,7 +47,7 @@ ...@@ -47,7 +47,7 @@
例如,假设有一个名为 Miykael 的用户: 例如,假设有一个名为 Miykael 的用户:
1. Miykael 在 CODEChina 上使用用户名`Miykael`创建了一个帐户; 他们的个人资料将在`https://codechina.csdn.net/miykael`下访问 1. Miykael 在 CODE CHINA 上使用用户名`Miykael`创建了一个帐户; 他们的个人资料将在`https://codechina.csdn.net/miykael`下访问
2. Miykael 为他们的团队创建了一个组织,名称为`csdn-team` ; 该组织及其项目将在`https://codechina.csdn.net/csdn-team`下访问 2. Miykael 为他们的团队创建了一个组织,名称为`csdn-team` ; 该组织及其项目将在`https://codechina.csdn.net/csdn-team`下访问
3. CSDN 创建了一个名为`coding`的子组织 ; 该子组织及其项目将在`https://codechina.csdn.net/csdn-team/coding`下访问 3. CSDN 创建了一个名为`coding`的子组织 ; 该子组织及其项目将在`https://codechina.csdn.net/csdn-team/coding`下访问
...@@ -57,7 +57,7 @@ ...@@ -57,7 +57,7 @@
* CSDN通过`@csdn-team`提及了团队中的每个人 * CSDN通过`@csdn-team`提及了团队中的每个人
* CSDN只提及`@csdn-team/coding` * CSDN只提及`@csdn-team/coding`
> 注:出于系统安全以及知识产权、商标保护等因素,我们预留了一部分namespace,如果您的用户名与预留这部分namespace有冲突,系统将会自动对您在CODEChina中的namespace进行调整。 > 注:出于系统安全以及知识产权、商标保护等因素,我们预留了一部分namespace,如果您的用户名与预留这部分namespace有冲突,系统将会自动对您在CODE CHINA中的namespace进行调整。
## 组织内的Issue及合并请求[](#组织内的Issue及合并请求 "Permalink") ## 组织内的Issue及合并请求[](#组织内的Issue及合并请求 "Permalink")
......
# 个人偏好[](#个人偏好 "Permalink") # 个人偏好[](#个人偏好 "Permalink")
用户的个人资料首选项页面允许用户自定义 CODEChina 的各个方面,可以通过以下步骤进行设置: 用户的个人资料首选项页面允许用户自定义 CODE CHINA 的各个方面,可以通过以下步骤进行设置:
1. 单击您的头像 1. 单击您的头像
2. 点击"设置" 2. 点击"设置"
...@@ -8,9 +8,9 @@ ...@@ -8,9 +8,9 @@
## 语法高亮主题[](#syntax-highlighting-theme "Permalink") ## 语法高亮主题[](#syntax-highlighting-theme "Permalink")
**注意:** CODEChina 使用[rouge Ruby 库](http://rouge.jneen.net/)在任何 Editor 上下文之外突出显示语法,WebIDE(如代码片段)使用[Monaco Editor](https://microsoft.github.io/monaco-editor/) ,并提供了[Monarch](https://microsoft.github.io/monaco-editor/monarch.html)库以突出显示语法,有关支持的语言的列表,请访问相应库的文档。 **注意:** CODE CHINA 使用[rouge Ruby 库](http://rouge.jneen.net/)在任何 Editor 上下文之外突出显示语法,WebIDE(如代码片段)使用[Monaco Editor](https://microsoft.github.io/monaco-editor/) ,并提供了[Monarch](https://microsoft.github.io/monaco-editor/monarch.html)库以突出显示语法,有关支持的语言的列表,请访问相应库的文档。
更改此设置可让您在 CODEChina 上查看语法突出显示的代码时自定义颜色主题。 更改此设置可让您在 CODE CHINA 上查看语法突出显示的代码时自定义颜色主题。
默认语法主题为"白色",您可以在 5 个不同的主题中进行选择: 默认语法主题为"白色",您可以在 5 个不同的主题中进行选择:
...@@ -22,11 +22,11 @@ ...@@ -22,11 +22,11 @@
## 个性化[](#behavior "Permalink") ## 个性化[](#behavior "Permalink")
以下设置可让您自定义 CODEChina 布局的行为以及仪表板和项目登录页面的默认视图。 以下设置可让您自定义 CODE CHINA 布局的行为以及仪表板和项目登录页面的默认视图。
### 宽度[](#layout-width "Permalink") ### 宽度[](#layout-width "Permalink")
可以根据喜好将 CODEChina 设置为使用不同的宽度,在固定(最大`1280px` )和流畅( `100%` )应用程序布局之间选择。 可以根据喜好将 CODE CHINA 设置为使用不同的宽度,在固定(最大`1280px` )和流畅( `100%` )应用程序布局之间选择。
**注意:**虽然使用固定版式时`1280px`是标准最大宽度,但是某些页面仍根据内容使用 100%宽度。 **注意:**虽然使用固定版式时`1280px`是标准最大宽度,但是某些页面仍根据内容使用 100%宽度。
...@@ -47,9 +47,9 @@ ...@@ -47,9 +47,9 @@
### 选项卡宽度[](#tab-width "Permalink") ### 选项卡宽度[](#tab-width "Permalink")
您可以在 CODEChina 的各个部分设置标签字符的显示宽度,例如 blob,diff 和代码片段。 您可以在 CODE CHINA 的各个部分设置标签字符的显示宽度,例如 blob,diff 和代码片段。
**注意:** CODEChina 的某些部分不遵守此设置,包括 WebIDE,文件编辑器和 Markdown 编辑器。 **注意:** CODE CHINA 的某些部分不遵守此设置,包括 WebIDE,文件编辑器和 Markdown 编辑器。
## 本地化[](#localization "Permalink") ## 本地化[](#localization "Permalink")
......
...@@ -6,9 +6,9 @@ ...@@ -6,9 +6,9 @@
## 创建个人访问令牌[](#creating-a-personal-access-token "Permalink") ## 创建个人访问令牌[](#creating-a-personal-access-token "Permalink")
您可以在 CODEChina 个人资料中创建任意数量的个人访问令牌: 您可以在 CODE CHINA 个人资料中创建任意数量的个人访问令牌:
1. 登录到 CODEChina 1. 登录到 CODE CHINA
2. 点击右上角的头像,然后选择**设置** 2. 点击右上角的头像,然后选择**设置**
3.**用户设置**菜单上,选择**访问令牌** 3.**用户设置**菜单上,选择**访问令牌**
4. 选择令牌的名称和可选的到期日期. 4. 选择令牌的名称和可选的到期日期.
......
...@@ -57,7 +57,7 @@ ...@@ -57,7 +57,7 @@
## 新建项目[](#新建项目 "Permalink") ## 新建项目[](#新建项目 "Permalink")
了解如何在 CODEChina[创建一个新项目](/docs/basic/create-project) 了解如何在 CODE CHINA[创建一个新项目](/docs/basic/create-project)
### Fork 项目[](#fork项目 "Permalink") ### Fork 项目[](#fork项目 "Permalink")
......
# 自动填充字符[](#autofill "Permalink") # 自动填充字符[](#autofill "Permalink")
自动完成字符填充提供了一种在 Markdown 字段中输入字段值的快速方法,当您开始在 Markdown 字段中使用以下字符之一键入单词时,CODEChina 将针对一组匹配值逐步自动完成, 字符串匹配不区分大小写。 自动完成字符填充提供了一种在 Markdown 字段中输入字段值的快速方法,当您开始在 Markdown 字段中使用以下字符之一键入单词时,CODE CHINA 将针对一组匹配值逐步自动完成, 字符串匹配不区分大小写。
| 字符 | 自动补全内容 | | 字符 | 自动补全内容 |
| --- | --- | | --- | --- |
......
# 自定义Git属性[](#自定义Git属性 "Permalink") # 自定义Git属性[](#自定义Git属性 "Permalink")
CODEChina 支持定义自定义[Git 属性](https://git-scm.com/docs/gitattributes),例如将哪些文件视为二进制文件,以及将哪种语言用于语法突出显示差异。 CODE CHINA 支持定义自定义[Git 属性](https://git-scm.com/docs/gitattributes),例如将哪些文件视为二进制文件,以及将哪种语言用于语法突出显示差异。
要定义这些属性,在代码仓库的根目录中创建一个名为`.gitattributes`的文件,并将其推送到项目的默认分支即可。 要定义这些属性,在代码仓库的根目录中创建一个名为`.gitattributes`的文件,并将其推送到项目的默认分支即可。
......
# 从Github导入[](#从Github导入 "Permalink") # 从Github导入[](#从Github导入 "Permalink")
使用导入器,您可以将 GitHub 代码仓库导入 CODEChina 使用导入器,您可以将 GitHub 代码仓库导入 CODE CHINA
## 概览[](#overview "Permalink") ## 概览[](#overview "Permalink")
...@@ -21,13 +21,13 @@ ...@@ -21,13 +21,13 @@
## 实现原理[](#how-it-works "Permalink") ## 实现原理[](#how-it-works "Permalink")
导入 Issue 和拉取请求时,导入程序会尝试在数据库中查找其 GitHub 作者和 指派人(请注意,拉取请求在 CODEChina 中被称为"合并请求")。 导入 Issue 和拉取请求时,导入程序会尝试在数据库中查找其 GitHub 作者和 指派人(请注意,拉取请求在 CODE CHINA 中被称为"合并请求")。
为了导入成功,在Github 项目导入前,至少需要项目中的每个作者和指派人都应该满足下列条件: 为了导入成功,在Github 项目导入前,至少需要项目中的每个作者和指派人都应该满足下列条件:
* 有一个 GitHub 帐户,其[主要电子邮件地址](https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address)与其 CODEChina 帐户的电子邮件地址匹配。 * 有一个 GitHub 帐户,其[主要电子邮件地址](https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address)与其 CODE CHINA 帐户的电子邮件地址匹配。
如果在 CODEChina 的数据库中未找到项目中引用的用户,则会将项目创建者(通常是启动导入的用户)设置为作者/指派人,但是对于该项目中 Issue 的评论,还是会提及到 Github 原作者。 如果在 CODE CHINA 的数据库中未找到项目中引用的用户,则会将项目创建者(通常是启动导入的用户)设置为作者/指派人,但是对于该项目中 Issue 的评论,还是会提及到 Github 原作者。
如果导入项目的命名空间不存在,则导入项目时会创建新的命名空间/组织;如果名称空间已经被占用,则会将该项目导入至启动导入过程的用户的命名空间里,命名空间/代码仓库名称也可以由具有权限的用户进行编辑。 如果导入项目的命名空间不存在,则导入项目时会创建新的命名空间/组织;如果名称空间已经被占用,则会将该项目导入至启动导入过程的用户的命名空间里,命名空间/代码仓库名称也可以由具有权限的用户进行编辑。
......
...@@ -4,7 +4,7 @@ ...@@ -4,7 +4,7 @@
## 概览[](#overview "Permalink") ## 概览[](#overview "Permalink")
CODEChina Issue 跟踪器是用于协作开发想法,解决问题和计划工作的高级工具。 CODE CHINA Issue 跟踪器是用于协作开发想法,解决问题和计划工作的高级工具。
通过 Issue,可以在以下各项之间,在实施之前和期间共享和讨论提案: 通过 Issue,可以在以下各项之间,在实施之前和期间共享和讨论提案:
......
...@@ -20,13 +20,13 @@ ...@@ -20,13 +20,13 @@
## 工作方式[](#how-it-works "Permalink") ## 工作方式[](#how-it-works "Permalink")
看板功能通过将 CODEChina 现有的[发行跟踪功能](/docs/user/project/issues#issue-列表)[标签](/docs/user/project/label)用作 Scrum 板的列表而建立。 看板功能通过将 CODE CHINA 现有的[发行跟踪功能](/docs/user/project/issues#issue-列表)[标签](/docs/user/project/label)用作 Scrum 板的列表而建立。
使用看板,您可以对 Issue 有不同的看法,同时保持在问题跟踪器中看到的相同过滤和排序功能。看板基于其项目的标签结构,因此它使用相同的描述性标签来指示在板上的位置,从而在整个开发生命周期中保持一致性。 使用看板,您可以对 Issue 有不同的看法,同时保持在问题跟踪器中看到的相同过滤和排序功能。看板基于其项目的标签结构,因此它使用相同的描述性标签来指示在板上的位置,从而在整个开发生命周期中保持一致性。
问题板向您显示团队正在处理的问题,分配给每个人的问题以及这些问题在工作流中的位置。 问题板向您显示团队正在处理的问题,分配给每个人的问题以及这些问题在工作流中的位置。
从创建 Issue,托管代码,执行审阅,构建,测试和部署这些您都可以再一个平台完成,看板可帮助您在 CODEChina 中可视化和管理整个过程。 从创建 Issue,托管代码,执行审阅,构建,测试和部署这些您都可以再一个平台完成,看板可帮助您在 CODE CHINA 中可视化和管理整个过程。
## 用户示例[](#use-cases "Permalink") ## 用户示例[](#use-cases "Permalink")
...@@ -34,7 +34,7 @@ ...@@ -34,7 +34,7 @@
### 单个看板示例[](#use-cases-for-a-single-issue-board "Permalink") ### 单个看板示例[](#use-cases-for-a-single-issue-board "Permalink")
借助 CODEChina 工作流程,您可以讨论 Issue 中的提案,使用标签对其进行分类,然后在其中使用问题委员会进行组织并确定优先级。 借助 CODE CHINA 工作流程,您可以讨论 Issue 中的提案,使用标签对其进行分类,然后在其中使用问题委员会进行组织并确定优先级。
例如,让我们考虑以下简化的开发工作流程: 例如,让我们考虑以下简化的开发工作流程:
......
...@@ -59,7 +59,7 @@ ...@@ -59,7 +59,7 @@
可以进入**项目设置 > 可见性,项目功能,权限**然后单击**允许用户请求访问权限** 启用该设置。 可以进入**项目设置 > 可见性,项目功能,权限**然后单击**允许用户请求访问权限** 启用该设置。
CODEChina 用户可以请求成为项目成员,进入到您要加入的项目,然后单击项目名称右侧的**申请权限"按钮。 CODE CHINA 用户可以请求成为项目成员,进入到您要加入的项目,然后单击项目名称右侧的**申请权限"按钮。
申请权限后: 申请权限后:
......
...@@ -57,7 +57,7 @@ MR 还包含导航选项卡,从中可以查看线程上正在进行的讨论 ...@@ -57,7 +57,7 @@ MR 还包含导航选项卡,从中可以查看线程上正在进行的讨论
## 合并请求认证[](#authorization-for-merge-requests "Permalink") ## 合并请求认证[](#authorization-for-merge-requests "Permalink")
使用 CODEChina 进行合并请求的主要方法有两种: 使用 CODE CHINA 进行合并请求的主要方法有两种:
1. 在单个存储库中使用[受保护的分支](/docs/user/project/protected-branch) 1. 在单个存储库中使用[受保护的分支](/docs/user/project/protected-branch)
2. 使用权威项目的分支 2. 使用权威项目的分支
\ No newline at end of file
# 创建合并请求[](#创建合并请求 "Permalink") # 创建合并请求[](#创建合并请求 "Permalink")
每个合并请求都从创建一个分支开始,您可以通过[命令行](#从本地新建合并请求) ,Git CLI 应用程序或[CODEChina WEB](#来自新建分支的合并请求)完成分支的创建。 每个合并请求都从创建一个分支开始,您可以通过[命令行](#从本地新建合并请求) ,Git CLI 应用程序或[CODE CHINA WEB](#来自新建分支的合并请求)完成分支的创建。
本文档介绍了创建合并请求的几种方法。 本文档介绍了创建合并请求的几种方法。
启动新的合并请求时,无论使用哪种方法,都将转到[**新合并请求**](#新建合并请求)页面,并在其中添加合并请求相关的信息。 启动新的合并请求时,无论使用哪种方法,都将转到[**新合并请求**](#新建合并请求)页面,并在其中添加合并请求相关的信息。
如果将新分支推送到 CODEChina,不论使用哪种方法,都可以单击[**创建合并请求**](#创建合并请求按钮)按钮并从此处启动合并请求。 如果将新分支推送到 CODE CHINA,不论使用哪种方法,都可以单击[**创建合并请求**](#创建合并请求按钮)按钮并从此处启动合并请求。
## 新建合并请求[](#new-merge-request-page "Permalink") ## 新建合并请求[](#new-merge-request-page "Permalink")
...@@ -16,11 +16,11 @@ ...@@ -16,11 +16,11 @@
在初始屏幕上,您还可以查看提交合并请求之前推送到分支的所有提交,管道和文件更改。 在初始屏幕上,您还可以查看提交合并请求之前推送到分支的所有提交,管道和文件更改。
**提示:**您可以在创建合并请求之前将一次或多次推送到 CODEChina 中的分支。 **提示:**您可以在创建合并请求之前将一次或多次推送到 CODE CHINA 中的分支。
## 创建合并请求按钮[](#create-merge-request-button "Permalink") ## 创建合并请求按钮[](#create-merge-request-button "Permalink")
将新分支推送到 CODEChina 后,请访问 CODEChina 中的代码仓库,并在屏幕顶​​部看到一个提示,您可以从中单击**创建合并请求**按钮。 将新分支推送到 CODE CHINA 后,请访问 CODE CHINA 中的代码仓库,并在屏幕顶​​部看到一个提示,您可以从中单击**创建合并请求**按钮。
您还可以在以下页面的右上方看到**创建合并请求**按钮: 您还可以在以下页面的右上方看到**创建合并请求**按钮:
...@@ -68,13 +68,13 @@ git add . ...@@ -68,13 +68,13 @@ git add .
git commit -m "My commit message" git commit -m "My commit message"
``` ```
完成后,将分支推送到 CODEChina 完成后,将分支推送到 CODE CHINA
```markdown ```markdown
git push origin my-new-branch git push origin my-new-branch
``` ```
在输出中,CODEChina 将提示您一个直接链接来创建合并请求: 在输出中,CODE CHINA 将提示您一个直接链接来创建合并请求:
```markdown ```markdown
... ...
...@@ -86,7 +86,7 @@ remote: https://codechina.csdn.net/my-group/my-project/merge_requests/new?merg ...@@ -86,7 +86,7 @@ remote: https://codechina.csdn.net/my-group/my-project/merge_requests/new?merg
在通过命令行推送时 ,还可以向命令添加一些标志,以减少通过界面手动编辑合并请求的需要。 在通过命令行推送时 ,还可以向命令添加一些标志,以减少通过界面手动编辑合并请求的需要。
如果您没有通过命令行将分支推送到 CODEChina(例如,您使用 Git CLI 应用程序来推送更改),则可以通过单击" [**创建合并请求**](#创建合并请求按钮)按钮 [**创建合并请求**](#创建合并请求按钮) 如果您没有通过命令行将分支推送到 CODE CHINA(例如,您使用 Git CLI 应用程序来推送更改),则可以通过单击" [**创建合并请求**](#创建合并请求按钮)按钮 [**创建合并请求**](#创建合并请求按钮)
## 从 Issue 新建合并请求[](#new-merge-request-from-an-issue "Permalink") ## 从 Issue 新建合并请求[](#new-merge-request-from-an-issue "Permalink")
...@@ -119,4 +119,4 @@ Fork 项目在本地更改后,可以通过以下步骤从 fork 创建一个合 ...@@ -119,4 +119,4 @@ Fork 项目在本地更改后,可以通过以下步骤从 fork 创建一个合
## 审查和管理合并请求[](#reviewing-and-managing-merge-requests "Permalink") ## 审查和管理合并请求[](#reviewing-and-managing-merge-requests "Permalink")
提交合并请求后,可以通过 CODEChina 进行[审查和管理](/docs/user/project/merge-request/reviewing) 提交合并请求后,可以通过 CODE CHINA 进行[审查和管理](/docs/user/project/merge-request/reviewing)
\ No newline at end of file \ No newline at end of file
...@@ -4,11 +4,11 @@ ...@@ -4,11 +4,11 @@
在大多数情况下,Git 能够自动合并分支之间的更改,但是在某些情况下,Git 需要您的帮助来手动解决冲突。通常,当人们更改了同一文件的相同部分时,这就需要手动来解决冲突了。 在大多数情况下,Git 能够自动合并分支之间的更改,但是在某些情况下,Git 需要您的帮助来手动解决冲突。通常,当人们更改了同一文件的相同部分时,这就需要手动来解决冲突了。
在解决所有冲突之前,系统将阻止合并请求。冲突可以在本地解决,许多情况下在 CODEChina 网页上也可以解决(有关何时可用的信息,请参见可解决的[冲突](#可解决的冲突) )。 在解决所有冲突之前,系统将阻止合并请求。冲突可以在本地解决,许多情况下在 CODE CHINA 网页上也可以解决(有关何时可用的信息,请参见可解决的[冲突](#可解决的冲突) )。
[![Merge request widget](/docs/img/merge_request_widget.png)](/docs/img/merge_request_widget.png) [![Merge request widget](/docs/img/merge_request_widget.png)](/docs/img/merge_request_widget.png)
**注意:** CODEChina 通过在未自动合并到目标分支的源分支中创建合并提交来解决冲突,这样可以在合并更改之前在源分支对合并提交进行检查和测试,从而在更改进入目标分支前防止没有检查或破坏构建导致的意外。 **注意:** CODE CHINA 通过在未自动合并到目标分支的源分支中创建合并提交来解决冲突,这样可以在合并更改之前在源分支对合并提交进行检查和测试,从而在更改进入目标分支前防止没有检查或破坏构建导致的意外。
## 交互模式[](#resolve-conflicts-interactive-mode "Permalink") ## 交互模式[](#resolve-conflicts-interactive-mode "Permalink")
...@@ -20,13 +20,13 @@ ...@@ -20,13 +20,13 @@
## 内联编辑模式[](#resolve-conflicts-inline-editor "Permalink") ## 内联编辑模式[](#resolve-conflicts-inline-editor "Permalink")
合并冲突编辑模式可以让您在 CODEChina 界面中解决更复杂的合并冲突,比如需要用户手动修改文件才能解决的冲突。使用**内联编辑**按钮打开编辑器. 确定更改后,请单击**提交到源分支**按钮。 合并冲突编辑模式可以让您在 CODE CHINA 界面中解决更复杂的合并冲突,比如需要用户手动修改文件才能解决的冲突。使用**内联编辑**按钮打开编辑器. 确定更改后,请单击**提交到源分支**按钮。
[![Merge conflict editor](/docs/img/merge_conflict_editor.png)](/docs/img/merge_conflict_editor.png) [![Merge conflict editor](/docs/img/merge_conflict_editor.png)](/docs/img/merge_conflict_editor.png)
## 可解决的冲突[](#conflicts-available-for-resolution "Permalink") ## 可解决的冲突[](#conflicts-available-for-resolution "Permalink")
CODEChina 界面只允许解决以下所有条件均成立的文件中的冲突: CODE CHINA 界面只允许解决以下所有条件均成立的文件中的冲突:
* 该文件是文本,不是二进制 * 该文件是文本,不是二进制
* 该文件采用 UTF-8 兼容编码 * 该文件采用 UTF-8 兼容编码
......
...@@ -2,7 +2,7 @@ ...@@ -2,7 +2,7 @@
## 概览[](#overview "Permalink") ## 概览[](#overview "Permalink")
CODEChina 中的里程碑是一种跟踪 Issue 及合并请求并在一定时期内实现更广泛目标的方法。 CODE CHINA 中的里程碑是一种跟踪 Issue 及合并请求并在一定时期内实现更广泛目标的方法。
里程碑使您可以将 Isuue 及合并请求组织到一个紧密联系的组中,并带有一个可选的开始日期和一个可选的截止日期。 里程碑使您可以将 Isuue 及合并请求组织到一个紧密联系的组中,并带有一个可选的开始日期和一个可选的截止日期。
...@@ -22,7 +22,7 @@ CODEChina 中的里程碑是一种跟踪 Issue 及合并请求并在一定时期 ...@@ -22,7 +22,7 @@ CODEChina 中的里程碑是一种跟踪 Issue 及合并请求并在一定时期
2. 将里程碑标题设置为您的发行版,例如`Version 9.4` 2. 将里程碑标题设置为您的发行版,例如`Version 9.4`
3. 通过关联问题右侧的期望里程碑,将问题添加到您的发行中 3. 通过关联问题右侧的期望里程碑,将问题添加到您的发行中
此外,您可以将里程碑与 CODEChina[Releases 功能](/docs/user/project/releases#associate-milestones-with-a-release)集成. 此外,您可以将里程碑与 CODE CHINA[Releases 功能](/docs/user/project/releases#associate-milestones-with-a-release)集成.
## 项目里程碑和组织里程碑[](#project-milestones-and-group-milestones "Permalink") ## 项目里程碑和组织里程碑[](#project-milestones-and-group-milestones "Permalink")
......
# 快速操作[](#quick-actions "Permalink") # 快速操作[](#quick-actions "Permalink")
快速操作是针对 Issue 、Epic、合并请求和提交的常见操作的文本快捷方式,通常可通过在 CODEChina 用户界面中单击按钮或下拉菜单来完成。您可以在 Issue、Epic、合并请求和提交的说明中或讨论中输入这些命令,每个命令需要放在单独的行上,以便正确检测和执行。 快速操作是针对 Issue 、Epic、合并请求和提交的常见操作的文本快捷方式,通常可通过在 CODE CHINA 用户界面中单击按钮或下拉菜单来完成。您可以在 Issue、Epic、合并请求和提交的说明中或讨论中输入这些命令,每个命令需要放在单独的行上,以便正确检测和执行。
## Issue、合并请求及 Epic 的快速操作[](#quick-actions-for-issues-merge-requests-and-epics "Permalink") ## Issue、合并请求及 Epic 的快速操作[](#quick-actions-for-issues-merge-requests-and-epics "Permalink")
......
...@@ -23,7 +23,7 @@ ...@@ -23,7 +23,7 @@
## 创建 Release[](#create-a-release "Permalink") ## 创建 Release[](#create-a-release "Permalink")
可以在 CODEChina 界面中直接创建发布。 可以在 CODE CHINA 界面中直接创建发布。
**注意:**只有具有 developer 权限或更高权限的用户才能创建发行版。 **注意:**只有具有 developer 权限或更高权限的用户才能创建发行版。
...@@ -133,13 +133,13 @@ ...@@ -133,13 +133,13 @@
### 链接[](#links "Permalink") ### 链接[](#links "Permalink")
链接是任何可以指向您喜欢的任何内容的URL:文档、构建的二进制文件或其他相关材料。这些可以是来自 CODEChina 的内部或外部链接。 链接是任何可以指向您喜欢的任何内容的URL:文档、构建的二进制文件或其他相关材料。这些可以是来自 CODE CHINA 的内部或外部链接。
链接的四种类型是" Runbook"," Package"," Image"和" Other"。 链接的四种类型是" Runbook"," Package"," Image"和" Other"。
## 发布证据[](#release-evidence "Permalink") ## 发布证据[](#release-evidence "Permalink")
每次创建发行版时,CODEChina 都会拍摄与之相关的数据快照。此数据保存在 JSON 文件中,称为*发布证据* , 它包括链接的里程碑和问题,并且可以促进内部流程,例如外部审核。 每次创建发行版时,CODE CHINA 都会拍摄与之相关的数据快照。此数据保存在 JSON 文件中,称为*发布证据* , 它包括链接的里程碑和问题,并且可以促进内部流程,例如外部审核。
要访问发布证据,请在"发布"页面上,单击**证据集合**标题下列出的 JSON 文件的链接。 要访问发布证据,请在"发布"页面上,单击**证据集合**标题下列出的 JSON 文件的链接。
......
# 代码仓库[](#repository "Permalink") # 代码仓库[](#repository "Permalink")
[代码仓库](https://git-scm.com/book/en/v2/Git-Basics-Getting-a-Git-Repository)是用于将代码库存储在 CODEChina 中并通过版本控制对其进行更改的存储库。代码仓库是[项目](/docs/user/project)的一部分,它具有许多其他功能。 [代码仓库](https://git-scm.com/book/en/v2/Git-Basics-Getting-a-Git-Repository)是用于将代码库存储在 CODE CHINA 中并通过版本控制对其进行更改的存储库。代码仓库是[项目](/docs/user/project)的一部分,它具有许多其他功能。
## 新建一个代码仓库[](#create-a-repository "Permalink") ## 新建一个代码仓库[](#create-a-repository "Permalink")
...@@ -8,15 +8,15 @@ ...@@ -8,15 +8,15 @@
创建新项目后,您可以通过界面或通过命令行添加新文件, 要从命令行添加文件,请遵循创建新项目时在屏幕上显示的说明。 创建新项目后,您可以通过界面或通过命令行添加新文件, 要从命令行添加文件,请遵循创建新项目时在屏幕上显示的说明。
> **重要提示:**出于安全原因,强烈建议您在使用命令行时[通过 SSH 与 CODEChina 连接](/docs/ssh) 。 > **重要提示:**出于安全原因,强烈建议您在使用命令行时[通过 SSH 与 CODE CHINA 连接](/docs/ssh) 。
## 文件[](#files "Permalink") ## 文件[](#files "Permalink")
在 CODEChina 上我们使用代码仓库来存储您的文件,您将在代码仓库的文件树中在文件名旁边看到一个与其扩展名称想对应的图标。 在 CODE CHINA 上我们使用代码仓库来存储您的文件,您将在代码仓库的文件树中在文件名旁边看到一个与其扩展名称想对应的图标。
### 新建和编辑文件[](#create-and-edit-files "Permalink") ### 新建和编辑文件[](#create-and-edit-files "Permalink")
通过将文件推送到 CODEChina,您就可以将代码库托管在代码仓库中。您可以使用用户界面也可以通过命令行将本地计算机与我们相连。 通过将文件推送到 CODE CHINA,您就可以将代码库托管在代码仓库中。您可以使用用户界面也可以通过命令行将本地计算机与我们相连。
**从用户界面:** **从用户界面:**
......
...@@ -30,8 +30,8 @@ git blame README ...@@ -30,8 +30,8 @@ git blame README
```markdown ```markdown
fb0fc7d6 (Someone 2019-11-07 22:21:22 +0100 1) fb0fc7d6 (Someone 2019-11-07 22:21:22 +0100 1)
^764ca75 (Someone else 2019-10-05 23:40:24 -0600 2) # CODEChina Documentation ^764ca75 (Someone else 2019-10-05 23:40:24 -0600 2) # CODE CHINA Documentation
^764ca75 (Someone else 2019-10-05 23:40:24 -0600 3) ^764ca75 (Someone else 2019-10-05 23:40:24 -0600 3)
0e62ed6d (Someone 2019-11-26 21:44:53 +0000 4) This project hosts the repository used to generate the CODEChina 0e62ed6d (Someone 2019-11-26 21:44:53 +0000 4) This project hosts the repository used to generate the CODE CHINA
0e62ed6d (Someone else 2019-11-26 21:44:53 +0000 5) documentation website 0e62ed6d (Someone else 2019-11-26 21:44:53 +0000 5) documentation website
``` ```
\ No newline at end of file
...@@ -8,7 +8,7 @@ ...@@ -8,7 +8,7 @@
* 执行内联代码审查 * 执行内联代码审查
* 与团队[讨论](/docs/user/discussions)实施情况 * 与团队[讨论](/docs/user/discussions)实施情况
有关使用 CODEChina 管理分支的更多信息,请参见: 有关使用 CODE CHINA 管理分支的更多信息,请参见:
- [默认分支](#默认分支) - [默认分支](#默认分支)
- [对比](#对比) - [对比](#对比)
......
# 文件查找[](#file-finder "Permalink") # 文件查找[](#file-finder "Permalink")
文件查找器功能使您可以使用 CODEChina 在代码仓库中搜索文件。 文件查找器功能使您可以使用 CODE CHINA 在代码仓库中搜索文件。
您可以在项目的**文件**部分中找到**查找文件**按钮。 您可以在项目的**文件**部分中找到**查找文件**按钮。
......
# GPG签名提交[](#gpg-sign "Permalink") # GPG签名提交[](#gpg-sign "Permalink")
您可以使用 GPG 密钥对在 CODEChina 代码仓库中的 Git 提交进行签名。 如果可以验证提交者的身份,则已签名的提交将标记为 **已验证**,为了验证提交者的身份,CODEChina 需要他们的公共 GPG 密钥。 您可以使用 GPG 密钥对在 CODE CHINA 代码仓库中的 Git 提交进行签名。 如果可以验证提交者的身份,则已签名的提交将标记为 **已验证**,为了验证提交者的身份,CODE CHINA 需要他们的公共 GPG 密钥。
目前尚不支持通过 GPG 验证标签。 目前尚不支持通过 GPG 验证标签。
## GPG 签名[](#how-we-handles-gpg "Permalink") ## GPG 签名[](#how-we-handles-gpg "Permalink")
CODEChina 使用其自己的密钥环来验证 GPG 签名,它不访问任何公钥服务器。 CODE CHINA 使用其自己的密钥环来验证 GPG 签名,它不访问任何公钥服务器。
对于要由 CODEChina 验证的提交: 对于要由 CODE CHINA 验证的提交:
* 提交者必须具有 GPG 公钥/私钥对 * 提交者必须具有 GPG 公钥/私钥对
* 提交者的公钥必须已上传到其 CODEChina 帐户 * 提交者的公钥必须已上传到其 CODE CHINA 帐户
* GPG 密钥中的一封电子邮件必须与提交者在 CODEChina 中使用的**经过验证的**电子邮件地址匹配 * GPG 密钥中的一封电子邮件必须与提交者在 CODE CHINA 中使用的**经过验证的**电子邮件地址匹配
* 提交者的电子邮件地址必须与 GPG 密钥中验证的电子邮件地址匹配 * 提交者的电子邮件地址必须与 GPG 密钥中验证的电子邮件地址匹配
## 生成 GPG 密钥[](#generating-a-gpg-key "Permalink") ## 生成 GPG 密钥[](#generating-a-gpg-key "Permalink")
...@@ -65,7 +65,7 @@ CODEChina 使用其自己的密钥环来验证 GPG 签名,它不访问任何 ...@@ -65,7 +65,7 @@ CODEChina 使用其自己的密钥环来验证 GPG 签名,它不访问任何
Is this correct? (y/N) y Is this correct? (y/N) y
``` ```
7. 接下来输入您的真实姓名,与此密钥关联的电子邮件地址(应与您在 CODEChina 中使用的经过验证的电子邮件地址匹配)和可选注释(按`Enter`跳过): 7. 接下来输入您的真实姓名,与此密钥关联的电子邮件地址(应与您在 CODE CHINA 中使用的经过验证的电子邮件地址匹配)和可选注释(按`Enter`跳过):
```markdown ```markdown
GnuPG needs to construct a user ID to identify your key. GnuPG needs to construct a user ID to identify your key.
...@@ -115,7 +115,7 @@ CODEChina 使用其自己的密钥环来验证 GPG 签名,它不访问任何 ...@@ -115,7 +115,7 @@ CODEChina 使用其自己的密钥环来验证 GPG 签名,它不访问任何
2. 点击**GPG 密钥**,然后将您的*公共*密钥粘贴到"密钥"框中 2. 点击**GPG 密钥**,然后将您的*公共*密钥粘贴到"密钥"框中
3. 最后,单击**添加键**将其添加到 CODEChina,您将能够看到其指纹,相应的电子邮件地址和创建日期 3. 最后,单击**添加键**将其添加到 CODE CHINA,您将能够看到其指纹,相应的电子邮件地址和创建日期
## 在 Git 中使用 GPG 密钥[](#associating-your-gpg-key-with-git "Permalink") ## 在 Git 中使用 GPG 密钥[](#associating-your-gpg-key-with-git "Permalink")
...@@ -163,7 +163,7 @@ CODEChina 使用其自己的密钥环来验证 GPG 签名,它不访问任何 ...@@ -163,7 +163,7 @@ CODEChina 使用其自己的密钥环来验证 GPG 签名,它不访问任何
``` ```
2. 按提示输入 GPG 密钥的密码 2. 按提示输入 GPG 密钥的密码
3. 推送至 CODEChina 并检查您的提交[是否已通过验证](#验证提交) 3. 推送至 CODE CHINA 并检查您的提交[是否已通过验证](#验证提交)
如果您不想在每次提交时都键入`-S`标志,则可以告诉 Git 自动签名您的提交: 如果您不想在每次提交时都键入`-S`标志,则可以告诉 Git 自动签名您的提交:
......
...@@ -57,7 +57,7 @@ ...@@ -57,7 +57,7 @@
git remote add origin https://codechina.csdn.net/<namespace>/<project_name>.git git remote add origin https://codechina.csdn.net/<namespace>/<project_name>.git
``` ```
5. 强制推送更改以覆盖 CODEChina 上的所有分支: 5. 强制推送更改以覆盖 CODE CHINA 上的所有分支:
```markdown ```markdown
git push origin --force --all git push origin --force --all
...@@ -65,7 +65,7 @@ ...@@ -65,7 +65,7 @@
[受保护的分支](/docs/user/project/protected-branch)将导致此操作失败。要继续的话,您必须删除分支保护,推送,然后重新启用受保护的分支。 [受保护的分支](/docs/user/project/protected-branch)将导致此操作失败。要继续的话,您必须删除分支保护,推送,然后重新启用受保护的分支。
6. 要从标记的 Release 中删除大文件,请强制将更改推送到CODEChina上的所有标记: 6. 要从标记的 Release 中删除大文件,请强制将更改推送到CODE CHINA上的所有标记:
```markdown ```markdown
git push origin --force --tags git push origin --force --tags
...@@ -79,9 +79,9 @@ ...@@ -79,9 +79,9 @@
## 在代码仓库中净化文件[](#purge-files-from-repo-storage "Permalink") ## 在代码仓库中净化文件[](#purge-files-from-repo-storage "Permalink")
要减少代码仓库的大小,必须删除 CODEChina 内部引用包含大文件的提交。在完成这些步骤之前,请[从存储库历史记录中清除文件](#purge-files-from-repository-history) . 要减少代码仓库的大小,必须删除 CODE CHINA 内部引用包含大文件的提交。在完成这些步骤之前,请[从存储库历史记录中清除文件](#purge-files-from-repository-history) .
除了[分支](/docs/user/project/repo/branches)和标签(这是一种 Git 引用)之外,系统还会自动创建其他引用,[代码仓库清理](#repository-cleanup)可用于从 CODEChina 中删除它们. 除了[分支](/docs/user/project/repo/branches)和标签(这是一种 Git 引用)之外,系统还会自动创建其他引用,[代码仓库清理](#repository-cleanup)可用于从 CODE CHINA 中删除它们.
以下为内部参考文献: 以下为内部参考文献:
...@@ -133,7 +133,7 @@ ...@@ -133,7 +133,7 @@
## 代码仓库清理[](#repository-cleanup "Permalink") ## 代码仓库清理[](#repository-cleanup "Permalink")
代码仓库清理允许您上传对象的文本文件,并且 CODEChina 将删除对这些对象的内部 Git 引用。您可以使用[`git filter-repo`](https://github.com/newren/git-filter-repo)生成对象列表(在`commit-map`文件中),该对象列表可与存储库清理一起使用。 代码仓库清理允许您上传对象的文本文件,并且 CODE CHINA 将删除对这些对象的内部 Git 引用。您可以使用[`git filter-repo`](https://github.com/newren/git-filter-repo)生成对象列表(在`commit-map`文件中),该对象列表可与存储库清理一起使用。
要清理代码仓库: 要清理代码仓库:
...@@ -153,7 +153,7 @@ ...@@ -153,7 +153,7 @@
* 项目统计信息已缓存,您可能需要等待 5 到 10 分钟才能看到存储利用率下降 * 项目统计信息已缓存,您可能需要等待 5 到 10 分钟才能看到存储利用率下降
* Housekeeping 会精简2周以上的松散物品,这意味着在最近 2 周内添加的对象将不会被立即删除 * Housekeeping 会精简2周以上的松散物品,这意味着在最近 2 周内添加的对象将不会被立即删除
* 此过程将从 CODEChina 的缓存和数据库中删除一些重写提交的副本,但是覆盖范围仍然存在许多空白,并且某些副本可能会无限期地存在 * 此过程将从 CODE CHINA 的缓存和数据库中删除一些重写提交的副本,但是覆盖范围仍然存在许多空白,并且某些副本可能会无限期地存在
## 仓库大小限制[](#storage-limits "Permalink") ## 仓库大小限制[](#storage-limits "Permalink")
......
...@@ -6,12 +6,12 @@ ...@@ -6,12 +6,12 @@
## 概览[](#overview "Permalink") ## 概览[](#overview "Permalink")
当您想在 CODEChina 之外的平台使用存储库时,存储库镜像很有用。 当您想在 CODE CHINA 之外的平台使用存储库时,存储库镜像很有用。
我们支持两种仓库镜像方式: 我们支持两种仓库镜像方式:
* 推送:用于将 CODEChina 仓库镜像到另一个位置 * 推送:用于将 CODE CHINA 仓库镜像到另一个位置
* 拉取:用于将其他位置的仓库镜像到 CODEChina * 拉取:用于将其他位置的仓库镜像到 CODE CHINA
至少具有 [Developer](/docs/user/permissions) 权限的用户也可以强制立即更新,除非: 至少具有 [Developer](/docs/user/permissions) 权限的用户也可以强制立即更新,除非:
...@@ -24,8 +24,8 @@ ...@@ -24,8 +24,8 @@
以下是我们建议使用仓库镜像的一些场景: 以下是我们建议使用仓库镜像的一些场景:
* 您迁移到了 CODEChina,但仍需要将项目保留在另一个源中。在这种情况下,您只需将其设置为镜像到 CODEChina(拉取),所有提交,标签和分支的基本历史记录都将在您的 CODEChina 仓库中。 * 您迁移到了 CODE CHINA,但仍需要将项目保留在另一个源中。在这种情况下,您只需将其设置为镜像到 CODE CHINA(拉取),所有提交,标签和分支的基本历史记录都将在您的 CODE CHINA 仓库中。
* 您在另一个源中有旧项目,这些旧项目不再使用,但又不想出于归档目的而删除它们。在这种情况下,您可以创建一个推送镜像,以便您的 CODEChina 仓库可以将其更改推送到旧源的项目中。 * 您在另一个源中有旧项目,这些旧项目不再使用,但又不想出于归档目的而删除它们。在这种情况下,您可以创建一个推送镜像,以便您的 CODE CHINA 仓库可以将其更改推送到旧源的项目中。
## 推送到远程仓库[](#pushing-to-a-remote-repository-core "Permalink") ## 推送到远程仓库[](#pushing-to-a-remote-repository-core "Permalink")
...@@ -43,7 +43,7 @@ ...@@ -43,7 +43,7 @@
启用推送镜像后,为防止镜像发散只有推送会直接提交到镜像仓库。任何时候,所有更改都将最终存储在镜像仓库中: 启用推送镜像后,为防止镜像发散只有推送会直接提交到镜像仓库。任何时候,所有更改都将最终存储在镜像仓库中:
* 提交被推送到 CODEChina * 提交被推送到 CODE CHINA
* [强制更新](#强制更新)已启动 * [强制更新](#强制更新)已启动
推送到仓库中的文件的更改至少会自动推送到远程镜像: 推送到仓库中的文件的更改至少会自动推送到远程镜像:
...@@ -62,9 +62,9 @@ ...@@ -62,9 +62,9 @@
启用**保持差异 refs**选项后,将跳过`develop`分支,从而可以更新`master``stable`。镜像将反映`develop`已偏离并被跳过,并标记为更新失败。 启用**保持差异 refs**选项后,将跳过`develop`分支,从而可以更新`master``stable`。镜像将反映`develop`已偏离并被跳过,并标记为更新失败。
## 创建一个从 CODEChina 到 Github 的镜像[](#setting-up-a-push-mirror-from-CODEChina-to-github-core "Permalink") ## 创建一个从 CODE CHINA 到 Github 的镜像[](#setting-up-a-push-mirror-from-CODE CHINA-to-github-core "Permalink")
要设置从 CODEChina 到 GitHub 的镜像,您需要执行以下步骤: 要设置从 CODE CHINA 到 GitHub 的镜像,您需要执行以下步骤:
1. 创建一个[GitHub 个人访问令牌](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token) ,并选中`public_repo`复选框 1. 创建一个[GitHub 个人访问令牌](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token) ,并选中`public_repo`复选框
2. 使用以下格式填写**Git 存储库 URL**字段: `https://<your_github_username>@github.com/<your_github_group>/<your_github_project>.git` 2. 使用以下格式填写**Git 存储库 URL**字段: `https://<your_github_username>@github.com/<your_github_group>/<your_github_project>.git`
...@@ -79,7 +79,7 @@ ...@@ -79,7 +79,7 @@
您可以将仓库设置为自动从上游仓库更新分支,标记和提交。 您可以将仓库设置为自动从上游仓库更新分支,标记和提交。
当您感兴趣的仓库位于其他服务器上并且您希望能够在 CODEChina 中浏览其内容时,这个功能会十分有用。 当您感兴趣的仓库位于其他服务器上并且您希望能够在 CODE CHINA 中浏览其内容时,这个功能会十分有用。
> 目前,镜像拉取的功能仅针对入驻的组织开放,可以点击这里**申请[组织入驻](https://codechina.csdn.net/codechina/org-cert)** > 目前,镜像拉取的功能仅针对入驻的组织开放,可以点击这里**申请[组织入驻](https://codechina.csdn.net/codechina/org-cert)**
...@@ -96,18 +96,18 @@ ...@@ -96,18 +96,18 @@
[![Repository mirroring pull settings screen - upper part](/docs/img/repository_mirroring_pull_settings_upper.png)](/docs/img/repository_mirroring_pull_settings_upper.png) [![Repository mirroring pull settings screen - upper part](/docs/img/repository_mirroring_pull_settings_upper.png)](/docs/img/repository_mirroring_pull_settings_upper.png)
现在,由于 CODEChina 中的项目已经设置为从上游存仓库中提取更改,所以不应将提交直接推送到 CODEChina 上的仓库中。相反地,现在任何提交都应该推送到上游仓库。推送到上游仓库中的更改将被拉入 CODEChina 仓库中: 现在,由于 CODE CHINA 中的项目已经设置为从上游存仓库中提取更改,所以不应将提交直接推送到 CODE CHINA 上的仓库中。相反地,现在任何提交都应该推送到上游仓库。推送到上游仓库中的更改将被拉入 CODE CHINA 仓库中:
* 在一定时间内自动拉取 * 在一定时间内自动拉取
* 启动[强制更新](#强制更新) * 启动[强制更新](#强制更新)
**警告**:如果您确实在 CODEChina 仓库中更新了分支,则该分支将与上游分叉,并且 CODEChina 将不再自动更新该分支以防止丢失任何更改。另请注意,上游仓库中已删除的分支和标签将不会反映在 CODEChina 的仓库中。 **警告**:如果您确实在 CODE CHINA 仓库中更新了分支,则该分支将与上游分叉,并且 CODE CHINA 将不再自动更新该分支以防止丢失任何更改。另请注意,上游仓库中已删除的分支和标签将不会反映在 CODE CHINA 的仓库中。
### 工作机制[](#how-it-works "Permalink") ### 工作机制[](#how-it-works "Permalink")
为仓库启用拉取镜像功能后,会将仓库添加到队列中。每分钟一次,Sidekiq cron 作业基于以下内容计划仓库镜像的更新: 为仓库启用拉取镜像功能后,会将仓库添加到队列中。每分钟一次,Sidekiq cron 作业基于以下内容计划仓库镜像的更新:
* 可用容量,这由 Sidekiq 设置确定, CODEChina 参考了 [Gitlab.com](https://docs.gitlab.com/13.2/ee/user/gitlab_com/index.html#sidekiq) 的默认配置。 * 可用容量,这由 Sidekiq 设置确定, CODE CHINA 参考了 [Gitlab.com](https://docs.gitlab.com/13.2/ee/user/gitlab_com/index.html#sidekiq) 的默认配置。
* 队列中已经要更新的仓库镜像数,到期时间取决于仓库镜像的最后更新时间以及重试次数。 * 队列中已经要更新的仓库镜像数,到期时间取决于仓库镜像的最后更新时间以及重试次数。
Sidekiq 可用时,它就会开始处理仓库镜像并对它们进行拉取更新。更新仓库镜像的过程为: Sidekiq 可用时,它就会开始处理仓库镜像并对它们进行拉取更新。更新仓库镜像的过程为:
...@@ -143,7 +143,7 @@ SSH 身份验证是相互的: ...@@ -143,7 +143,7 @@ SSH 身份验证是相互的:
如果单击: 如果单击:
* **检测主机密钥**按钮,CODEChina 将从服务器获取主机密钥并显示指纹 * **检测主机密钥**按钮,CODE CHINA 将从服务器获取主机密钥并显示指纹
* **手动输入主机密钥**按钮,将显示一个字段,您可以在其中粘贴主机密钥 * **手动输入主机密钥**按钮,将显示一个字段,您可以在其中粘贴主机密钥
假设您使用了前者,那么现在需要验证指纹是否符合您的期望. gitlhub.com 和其他代码托管站点公开公开其指纹,供您检查: 假设您使用了前者,那么现在需要验证指纹是否符合您的期望. gitlhub.com 和其他代码托管站点公开公开其指纹,供您检查:
...@@ -156,22 +156,22 @@ SSH 身份验证是相互的: ...@@ -156,22 +156,22 @@ SSH 身份验证是相互的:
* [Savannah](http://savannah.gnu.org/maintenance/SshAccess/) * [Savannah](http://savannah.gnu.org/maintenance/SshAccess/)
* [SourceForge](https://sourceforge.net/p/forge/documentation/SSH%20Key%20Fingerprints/) * [SourceForge](https://sourceforge.net/p/forge/documentation/SSH%20Key%20Fingerprints/)
在镜像仓库时,CODEChina 将在连接之前检查至少一个存储的主机密钥是否匹配,这样可以防止将恶意代码注入到您的镜像中,或者防止您的密码被盗。 在镜像仓库时,CODE CHINA 将在连接之前检查至少一个存储的主机密钥是否匹配,这样可以防止将恶意代码注入到您的镜像中,或者防止您的密码被盗。
### SSH 公钥认证[](#ssh-public-key-authentication "Permalink") ### SSH 公钥认证[](#ssh-public-key-authentication "Permalink")
要使用 SSH 公钥身份验证,您还需要从**验证方式**下拉菜单中选择该选项。创建镜像后,CODEChina 将会自动生成一个 4096 位 RSA 密钥,可以通过单击**复制 SSH 公共密钥**按钮进行复制。 要使用 SSH 公钥身份验证,您还需要从**验证方式**下拉菜单中选择该选项。创建镜像后,CODE CHINA 将会自动生成一个 4096 位 RSA 密钥,可以通过单击**复制 SSH 公共密钥**按钮进行复制。
[![Repository mirroring copy SSH public key to clipboard button](/docs/img/repository_mirroring_copy_ssh_public_key_button.png)](/docs/img/repository_mirroring_copy_ssh_public_key_button.png) [![Repository mirroring copy SSH public key to clipboard button](/docs/img/repository_mirroring_copy_ssh_public_key_button.png)](/docs/img/repository_mirroring_copy_ssh_public_key_button.png)
然后,您需要将公共 SSH 密钥添加到另一个仓库的配置中: 然后,您需要将公共 SSH 密钥添加到另一个仓库的配置中:
* 如果其他仓库托管在 CODEChina 上,则应将公共 SSH 密钥添加为 Deploy Key * 如果其他仓库托管在 CODE CHINA 上,则应将公共 SSH 密钥添加为 Deploy Key
* 如果其他仓库位于其他位置,则可能需要将密钥添加到用户的`authorized_keys`文件中,将整个公共 SSH 密钥单独粘贴到文件中并保存。 * 如果其他仓库位于其他位置,则可能需要将密钥添加到用户的`authorized_keys`文件中,将整个公共 SSH 密钥单独粘贴到文件中并保存。
如果您需要更改密钥,则可以删除并重新添加镜像以生成新密钥。您必须使用新密钥更新另一个仓库,以保持镜像运行。 如果您需要更改密钥,则可以删除并重新添加镜像以生成新密钥。您必须使用新密钥更新另一个仓库,以保持镜像运行。
**注意**:生成的密钥存储在 CODEChina 数据库中,而不存储在文件系统中。因此,无法在 pre-recieve hook 中使用针对镜像的 SSH 公钥身份验证。 **注意**:生成的密钥存储在 CODE CHINA 数据库中,而不存储在文件系统中。因此,无法在 pre-recieve hook 中使用针对镜像的 SSH 公钥身份验证。
### 覆盖分叉分支[](#overwrite-diverged-branches-starter "Permalink") ### 覆盖分叉分支[](#overwrite-diverged-branches-starter "Permalink")
...@@ -183,7 +183,7 @@ SSH 身份验证是相互的: ...@@ -183,7 +183,7 @@ SSH 身份验证是相互的:
### 仅镜像保护分支[](#only-mirror-protected-branches-starter "Permalink") ### 仅镜像保护分支[](#only-mirror-protected-branches-starter "Permalink")
您可以选择仅将受保护的分支从远程仓库拉到 CODEChina,未受保护的分支不会被镜像,并且允许分叉。 您可以选择仅将受保护的分支从远程仓库拉到 CODE CHINA,未受保护的分支不会被镜像,并且允许分叉。
要使用此选项,请在创建仓库镜像时选中**仅镜像保护的分支**复选框。 要使用此选项,请在创建仓库镜像时选中**仅镜像保护的分支**复选框。
...@@ -201,7 +201,7 @@ SSH 身份验证是相互的: ...@@ -201,7 +201,7 @@ SSH 身份验证是相互的:
## 故障处理[](#troubleshooting "Permalink") ## 故障处理[](#troubleshooting "Permalink")
如果在推送过程中发生错误,则 CODEChina 将在该仓库中显示"错误"信息。然后,将鼠标悬停在突出显示的文本上,即可查看有关错误的详细信息。 如果在推送过程中发生错误,则 CODE CHINA 将在该仓库中显示"错误"信息。然后,将鼠标悬停在突出显示的文本上,即可查看有关错误的详细信息。
[![Repository mirroring error tips](/docs/img/repository_mirroring_error.png)](/docs/img/repository_mirroring_error.png) [![Repository mirroring error tips](/docs/img/repository_mirroring_error.png)](/docs/img/repository_mirroring_error.png)
......
# 文件编辑[](#文件编辑 "Permalink") # 文件编辑[](#文件编辑 "Permalink")
有时,直接从 CODEChina 界面进行快速更改要比克隆项目并使用 Gi​​t 命令行工具更容易。接下来,我们重点介绍如何从文件浏览器创建新文件,目录,分支或标记,以上所有这些操作都可以通过一个下拉菜单获得。 有时,直接从 CODE CHINA 界面进行快速更改要比克隆项目并使用 Gi​​t 命令行工具更容易。接下来,我们重点介绍如何从文件浏览器创建新文件,目录,分支或标记,以上所有这些操作都可以通过一个下拉菜单获得。
## 创建文件[](#create-a-file "Permalink") ## 创建文件[](#create-a-file "Permalink")
...@@ -14,7 +14,7 @@ ...@@ -14,7 +14,7 @@
### 文件模板[](#template-dropdowns "Permalink") ### 文件模板[](#template-dropdowns "Permalink")
启动新项目时,新项目可能也需要一些通用文件,CODEChina 将在仓库中提示您新建这些文件。 启动新项目时,新项目可能也需要一些通用文件,CODE CHINA 将在仓库中提示您新建这些文件。
[![First file for your project](/docs/img/web_editor_template_dropdown_first_file.png)](/docs/img/web_editor_template_dropdown_first_file.png) [![First file for your project](/docs/img/web_editor_template_dropdown_first_file.png)](/docs/img/web_editor_template_dropdown_first_file.png)
...@@ -44,7 +44,7 @@ ...@@ -44,7 +44,7 @@
## 新建分支[](#create-a-new-branch "Permalink") ## 新建分支[](#create-a-new-branch "Permalink")
有多种方法可从 CODEChina 的界面创建分支。 有多种方法可从 CODE CHINA 的界面创建分支。
### 从 Issue 创建一个新分支[](#create-a-new-branch-from-an-issue "Permalink") ### 从 Issue 创建一个新分支[](#create-a-new-branch-from-an-issue "Permalink")
...@@ -58,7 +58,7 @@ ...@@ -58,7 +58,7 @@
选择这些选项之一后,将基于项目的默认分支(默认为`master`创建新的分支或分支与合并请求. 分支名称将基于 Issue 的标题,并作为前缀具有其内部 ID。因此,上面的示例屏幕快照将创建一个名为`1-webpack`的分支。 选择这些选项之一后,将基于项目的默认分支(默认为`master`创建新的分支或分支与合并请求. 分支名称将基于 Issue 的标题,并作为前缀具有其内部 ID。因此,上面的示例屏幕快照将创建一个名为`1-webpack`的分支。
当您在一个空的项目中单击**创建分支**按钮时,CODEChina 会自动创建一个`master`分支, `README`提交一个空白的`README`文件,并根据 Issue 标题创建并将您重定向到新分支(如果您的项目已经配置了)。 当您在一个空的项目中单击**创建分支**按钮时,CODE CHINA 会自动创建一个`master`分支, `README`提交一个空白的`README`文件,并根据 Issue 标题创建并将您重定向到新分支(如果您的项目已经配置了)。
创建分支后,您可以编辑代码仓库中的文件以解决此 Issue。当基于新创建的分支创建合并请求时,描述字段将自动显示[ Issue 关闭模式](/docs/user/project/issues/manage#closing-issues-automatically) `Closes #ID` ,其中`ID`为 Issue 的 ID,一旦合并请求被合并, Issue 将自动关闭。 创建分支后,您可以编辑代码仓库中的文件以解决此 Issue。当基于新创建的分支创建合并请求时,描述字段将自动显示[ Issue 关闭模式](/docs/user/project/issues/manage#closing-issues-automatically) `Closes #ID` ,其中`ID`为 Issue 的 ID,一旦合并请求被合并, Issue 将自动关闭。
......
...@@ -85,7 +85,7 @@ ...@@ -85,7 +85,7 @@
### 导出项目[](#export-project "Permalink") ### 导出项目[](#export-project "Permalink")
可以在 CODEChina 中导出您的项目 可以在 CODE CHINA 中导出您的项目
### 高级设置[](#advanced-settings "Permalink") ### 高级设置[](#advanced-settings "Permalink")
...@@ -110,7 +110,7 @@ ...@@ -110,7 +110,7 @@
要查找已归档的项目: 要查找已归档的项目:
1. 以具有项目 Owner 的用户身份登录到 CODEChina 1. 以具有项目 Owner 的用户身份登录到 CODE CHINA
2. 如果你: 2. 如果你:
* 拥有项目的 URL,在浏览器中打开项目的页面. * 拥有项目的 URL,在浏览器中打开项目的页面.
* 没有项目的 URL:1.单击**项目>浏览项目** ;1.在**排序项目**下拉框中,选择**显示存档的项目** ;1.在**按名称过滤**字段中,提供项目的名称;1.单击指向项目的链接以打开其**详细信息**页面 * 没有项目的 URL:1.单击**项目>浏览项目** ;1.在**排序项目**下拉框中,选择**显示存档的项目** ;1.在**按名称过滤**字段中,提供项目的名称;1.单击指向项目的链接以打开其**详细信息**页面
......
# 时间跟踪[](#time-track "Permalink") # 时间跟踪[](#time-track "Permalink")
时间跟踪允许您跟踪估计和花费在问题上的时间以及在 CODEChina 中合并请求。 时间跟踪允许您跟踪估计和花费在问题上的时间以及在 CODE CHINA 中合并请求。
## 概览[](#overview "Permalink") ## 概览[](#overview "Permalink")
......
...@@ -40,7 +40,7 @@ Wiki 页面作为文件存储在 Git 代码仓库中,因此某些字符具有 ...@@ -40,7 +40,7 @@ Wiki 页面作为文件存储在 Git 代码仓库中,因此某些字符具有
### 文件及目录的长度限制[](#length-restrictions-for-file-and-directory-names "Permalink") ### 文件及目录的长度限制[](#length-restrictions-for-file-and-directory-names "Permalink")
许多常见的文件系统[的文件名和目录名限制为 255 个字节](https://en.wikipedia.org/wiki/Comparison_of_file_systems#Limits) ,尽管 Git 和 CODEChina 都支持超出这些限制的路径,但是它们的存在使这些文件系统上的用户无法在本地检出 Wiki 存储库。 许多常见的文件系统[的文件名和目录名限制为 255 个字节](https://en.wikipedia.org/wiki/Comparison_of_file_systems#Limits) ,尽管 Git 和 CODE CHINA 都支持超出这些限制的路径,但是它们的存在使这些文件系统上的用户无法在本地检出 Wiki 存储库。
为了避免这种情况,通过界面和 API 编辑页面时会强制执行以下限制: 为了避免这种情况,通过界面和 API 编辑页面时会强制执行以下限制:
...@@ -100,7 +100,7 @@ Wiki 页面随时间的变化记录在 Wiki 的 Git 存储库中,您可以通 ...@@ -100,7 +100,7 @@ Wiki 页面随时间的变化记录在 Wiki 的 Git 存储库中,您可以通
在右侧栏上,单击**克隆存储库",**然后按照屏幕上的说明进行操作。 在右侧栏上,单击**克隆存储库",**然后按照屏幕上的说明进行操作。
根据您要使用的标记语言,您在本地添加到 Wiki 的文件必须具有以下受支持的扩展名之一,否则当推送到 CODEChina 时将不会显示这些文件: 根据您要使用的标记语言,您在本地添加到 Wiki 的文件必须具有以下受支持的扩展名之一,否则当推送到 CODE CHINA 时将不会显示这些文件:
* Markdown 扩展名: `own``.mkd``.mkdn``` , `.markdown` * Markdown 扩展名: `own``.mkd``.mkdn``` , `.markdown`
* AsciiDoc 扩展名: `.adoc` , `.ad` , `.asciidoc` * AsciiDoc 扩展名: `.adoc` , `.ad` , `.asciidoc`
......
...@@ -2,11 +2,11 @@ ...@@ -2,11 +2,11 @@
通过我们支持的快捷键可以让您更轻松地访问不同的功能,您可以通过按`?`查看我们所支持的快捷键,或单击右上角头像菜单中的"快捷键" 。此外,您也可以通过设置弹窗中的**启用** / **禁用**切换来禁用键盘快捷键。 通过我们支持的快捷键可以让您更轻松地访问不同的功能,您可以通过按`?`查看我们所支持的快捷键,或单击右上角头像菜单中的"快捷键" 。此外,您也可以通过设置弹窗中的**启用** / **禁用**切换来禁用键盘快捷键。
[全局快捷键](#global-shortcuts)可在 CODEChina 的任何区域使用,但是您必须在特定页面中才能使用其他快捷方式,具体的参考以下文档说明。 [全局快捷键](#global-shortcuts)可在 CODE CHINA 的任何区域使用,但是您必须在特定页面中才能使用其他快捷方式,具体的参考以下文档说明。
## 全局快捷键[](#global-shortcuts "Permalink") ## 全局快捷键[](#global-shortcuts "Permalink")
在 CODEChina 的大多数区域中都可以使用以下这些快捷方式: 在 CODE CHINA 的大多数区域中都可以使用以下这些快捷方式:
| 快捷键 | 说明 | | 快捷键 | 说明 |
| --- | --- | | --- | --- |
......
# 待办事项[](#待办事项 "Permalink") # 待办事项[](#待办事项 "Permalink")
当您登录到 CODEChina 时,通常需要看一下哪些内容需要花费较多时间、开始干活或知道需要注意的是哪些,而无需理会大量的电子邮件通知。这里是您工作的地方,因此能够快速下手开展工作尤为重要。待办事项就是这样一个工具,它在一个简单的仪表板中按时间顺序列出了等待您处理的内容。 当您登录到 CODE CHINA 时,通常需要看一下哪些内容需要花费较多时间、开始干活或知道需要注意的是哪些,而无需理会大量的电子邮件通知。这里是您工作的地方,因此能够快速下手开展工作尤为重要。待办事项就是这样一个工具,它在一个简单的仪表板中按时间顺序列出了等待您处理的内容。
[![To Do screenshot showing a list of items to check on](/docs/img/todos_index.png)](/docs/img/todos_index.png) [![To Do screenshot showing a list of items to check on](/docs/img/todos_index.png)](/docs/img/todos_index.png)
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册