From f672c560941409495b278c7e409b7372816e510b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=86=8A=E4=BD=B3=E7=89=A7?= Date: Fri, 11 Sep 2020 11:09:28 +0800 Subject: [PATCH] update wiki format --- README.md => Home.md | 66 ++++++++--------- SUMMARY.md | 70 ------------------- _sidebar.md | 70 +++++++++++++++++++ docs/basic/create-project.md | 4 +- docs/overview.md | 66 ++++++++--------- docs/user.md | 4 +- docs/user/account.md | 8 +-- docs/user/discussions.md | 6 +- docs/user/markdown.md | 54 +++++++------- docs/user/org.md | 28 ++++---- docs/user/org/sub_org.md | 6 +- docs/user/permissions.md | 14 ++-- docs/user/profile/preferences.md | 2 +- docs/user/project.md | 60 ++++++++-------- docs/user/project/autofill.md | 2 +- docs/user/project/bulk-edit.md | 4 +- docs/user/project/description-template.md | 14 ++-- docs/user/project/import.md | 4 +- docs/user/project/issues.md | 24 +++---- docs/user/project/issues/actions.md | 30 ++++---- docs/user/project/issues/crosslinking.md | 2 +- docs/user/project/issues/due-date.md | 4 +- docs/user/project/issues/manage.md | 8 +-- docs/user/project/issues/sort.md | 2 +- docs/user/project/kanban.md | 10 +-- docs/user/project/label.md | 8 +-- docs/user/project/member.md | 8 +-- docs/user/project/member/share.md | 2 +- docs/user/project/merge-request.md | 8 +-- .../merge-request/create-merge-request.md | 10 +-- docs/user/project/merge-request/draft.md | 4 +- docs/user/project/merge-request/reviewing.md | 16 ++--- docs/user/project/merge-request/squash.md | 4 +- docs/user/project/milestone.md | 12 ++-- docs/user/project/protected-branch.md | 6 +- docs/user/project/protected-tag.md | 2 +- docs/user/project/quick-actions.md | 2 +- docs/user/project/releases.md | 4 +- docs/user/project/repo.md | 36 +++++----- docs/user/project/repo/blame.md | 4 +- docs/user/project/repo/branches.md | 10 +-- docs/user/project/repo/file-find.md | 2 +- docs/user/project/repo/gpg-sign.md | 4 +- docs/user/project/repo/history.md | 4 +- docs/user/project/repo/reduce-repo-size.md | 14 ++-- docs/user/project/repo/web-editor.md | 4 +- docs/user/project/settings.md | 42 +++++------ docs/user/project/time-track.md | 2 +- docs/user/project/webide.md | 2 +- docs/user/project/wiki.md | 10 +-- docs/user/search.md | 10 +-- docs/user/shortcutkey.md | 8 +-- docs/user/todo.md | 2 +- 53 files changed, 401 insertions(+), 401 deletions(-) rename README.md => Home.md (51%) delete mode 100644 SUMMARY.md create mode 100644 _sidebar.md diff --git a/README.md b/Home.md similarity index 51% rename from README.md rename to Home.md index 3f7da26..ce6a027 100644 --- a/README.md +++ b/Home.md @@ -6,7 +6,7 @@ | 基础入门 | 基本入门 | | --- | --- | -| [**用户文件**](/docs/user.md)熟悉CODEChina 中的功能和概念. |[**是 Git 和 GitLab/GitHub 的新手吗?**](#刚开始使用gitcodechinagitlabgithub)我们有资源可以帮助您入门 | +| [**用户文件**](/docs/user)熟悉CODEChina 中的功能和概念. |[**是 Git 和 GitLab/GitHub 的新手吗?**](#刚开始使用gitcodechinagitlabgithub)我们有资源可以帮助您入门 | | [**为 CODEChina 做贡献**](#为codechina开源做贡献)为CODEChina开源贡献力量! | [**从另一个平台进入 CODEChina?**](#从另一个平台进入到-codechina)请查阅我们的便捷指南 | @@ -25,18 +25,18 @@ | 计划主题 | 描述 | | --- | --- | | Burndown Charts| 在特定的里程碑中观察项目的进度 | -| [讨论](/docs/user/discussions.md) | 问题,提交和合并请求中的线程,注释和可解决线程 | -| [截止日期](/docs/user/project/issues/due-date.md) | 跟踪发行期限| +| [讨论](/docs/user/discussions) | 问题,提交和合并请求中的线程,注释和可解决线程 | +| [截止日期](/docs/user/project/issues/due-date) | 跟踪发行期限| | Epics | 跟踪共享主题的问题组| -| [ Issue ](/docs/user/project/issues.md) ,包括[机密问题](/docs/user/project/issues/confidential.md) ,[发布和合并请求模板](/docs/user/project/description-template.md) ,和[移动的问题](/docs/user/project/issues/manage.md#moving-issues) | 项目问题并限制对问题的访问,并创建用于提交新问题和合并请求的模板。 此外,在项目之间转移问题| -| [标签](/docs/user/project/label.md) | 分类问题或使用描述性标签合并请求| -| [里程碑](/docs/user/project/milestone.md) | 设置发布问题和合并请求的里程碑,并带有可选的截止日期| -| [看板](/docs/user/project/kanban.md) | 在 Scrum 或看板上显示问题| -| [快捷方式](/docs/user/shortcutkey.md) | 针对问题或合并请求的常见操作的快捷方式,而无需单击按钮或在WEB界面中使用下拉菜单 | -| [关联 Issue](/docs/user/project/issues/crosslinking.md) | 在问题之间建立关系 | +| [ Issue ](/docs/user/project/issues) ,包括[机密问题](/docs/user/project/issues/confidential) ,[发布和合并请求模板](/docs/user/project/description-template) ,和[移动的问题](/docs/user/project/issues/manage#moving-issues) | 项目问题并限制对问题的访问,并创建用于提交新问题和合并请求的模板。 此外,在项目之间转移问题| +| [标签](/docs/user/project/label) | 分类问题或使用描述性标签合并请求| +| [里程碑](/docs/user/project/milestone) | 设置发布问题和合并请求的里程碑,并带有可选的截止日期| +| [看板](/docs/user/project/kanban) | 在 Scrum 或看板上显示问题| +| [快捷方式](/docs/user/shortcutkey) | 针对问题或合并请求的常见操作的快捷方式,而无需单击按钮或在WEB界面中使用下拉菜单 | +| [关联 Issue](/docs/user/project/issues/crosslinking) | 在问题之间建立关系 | | Roadmap | 可视化史诗般的时间表 | -| [时间跟踪](/docs/user/project/time-track.md) | 跟踪花费在问题和合并请求上的时间 | -| [代办事项](/docs/user/todo.md) | 通过在简单仪表板上显示的时间顺序列表,跟踪需要注意的工作 | +| [时间跟踪](/docs/user/project/time-track) | 跟踪花费在问题和合并请求上的时间 | +| [代办事项](/docs/user/todo) | 通过在简单仪表板上显示的时间顺序列表,跟踪需要注意的工作 | [返回概览](#概览) @@ -55,14 +55,14 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 | 全局搜索 | 利用 Elasticsearch 在整个 CODEChina 实例上进行更快,更高级的代码搜索| | 语法检索 | 使用高级查询获得更具针对性的搜索结果| | Contribution analytics | 请参阅小组贡献者的详细统计信息| -| [创建](/docs/basic/create-project.md)并 fork 项目,以及[导入项目](/docs/user/project/import.md) | 创建,复制和移动项目 | +| [创建](/docs/basic/create-project)并 fork 项目,以及[导入项目](/docs/user/project/import) | 创建,复制和移动项目 | | 锁定文件 | 锁定文件以避免合并冲突 | -| [组织](/docs/user/org.md) and [子组织](/docs/user/org/sub_org.md) | 分组组织您的项目 | +| [组织](/docs/user/org) and [子组织](/docs/user/org/sub_org) | 分组组织您的项目 | | Issue 分析 | 检查每月创建了多少个问题| -| [项目](/docs/user/project.md) ,包括项目访问和[设置](/docs/user/project/settings.md) | 托管源代码,并控制项目的可见性和设置配置。| +| [项目](/docs/user/project) ,包括项目访问和[设置](/docs/user/project/settings) | 托管源代码,并控制项目的可见性和设置配置。| | [搜索](/docs/img/add_user_search_people.png) | 搜索问题,合并请求,项目,组和待办事项。| -| [Web IDE](/docs/user/project/webide.mdl) | 在 WebIDE 中编辑文件| -| [Wikis](/docs/user/project/wiki.md) | 使用内置的 Wiki 来管理您的文档| +| [Web IDE](/docs/user/project/webidel) | 在 WebIDE 中编辑文件| +| [Wikis](/docs/user/project/wiki) | 使用内置的 Wiki 来管理您的文档| [返回概览](#概览) @@ -70,18 +70,18 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 | 创建主题-代码仓库 | 描述 | | --- | --- | -| [分支](/docs/user/project/repo/branches.md)和[默认分支](/docs/user/project/repo/branches.md#default-branch) | 如何在 CODEChina 中使用分支 | -| [提交](/docs/user/project/repo.md#commits) and [署名提交](/docs/user/project/repo/gpg-sign.md) | 处理提交,并使用 GPG 对您的提交进行签名 | -| [创建分支](/docs/user/project/repo/web-editor.md#create-a-new-branch) , [创建](/docs/user/project/repo/web-editor.md#create-a-file)并[上传](/docs/user/project/repo/web-editor.md#upload-a-file)文件,并[创建目录](/docs/user/project/repo/web-editor.md#create-a-directory) | 创建分支,创建和上传文件以及创建目录| -| [删除已合并的分支](/docs/user/project/repo/branches.md#delete-merged-branches) | 合并更改后的批量删除分支| -| [文件模板](/docs/user/project/repo/web-editor.md#template-dropdowns) | 通用文件的文件模板 | -| [文件](/docs/user/project/repo.md#files) | 文件管理 | +| [分支](/docs/user/project/repo/branches)和[默认分支](/docs/user/project/repo/branches#default-branch) | 如何在 CODEChina 中使用分支 | +| [提交](/docs/user/project/repo#commits) and [署名提交](/docs/user/project/repo/gpg-sign) | 处理提交,并使用 GPG 对您的提交进行签名 | +| [创建分支](/docs/user/project/repo/web-editor#create-a-new-branch) , [创建](/docs/user/project/repo/web-editor#create-a-file)并[上传](/docs/user/project/repo/web-editor#upload-a-file)文件,并[创建目录](/docs/user/project/repo/web-editor#create-a-directory) | 创建分支,创建和上传文件以及创建目录| +| [删除已合并的分支](/docs/user/project/repo/branches#delete-merged-branches) | 合并更改后的批量删除分支| +| [文件模板](/docs/user/project/repo/web-editor#template-dropdowns) | 通用文件的文件模板 | +| [文件](/docs/user/project/repo#files) | 文件管理 | | Jupyter Notebook 文件 | 对`.ipynb`文件的支持 | -| [保护分支](/docs/user/project/protected-branch.md) | 使用受保护的分支 | +| [保护分支](/docs/user/project/protected-branch) | 使用受保护的分支 | | 推送规则| 对项目推送的附加控制 | -| [代码仓库](/docs/user/project/repo.md) | 在网页中管理源代码仓库 | +| [代码仓库](/docs/user/project/repo) | 在网页中管理源代码仓库 | | 镜像代码仓库 | 推入或拉出外部的代码仓库 | -| [处理合并请求](/docs/user/project/repo/web-editor.md#tips) | 在提交时启动合并请求 | +| [处理合并请求](/docs/user/project/repo/web-editor#tips) | 在提交时启动合并请求 | [返回概览](#概览) @@ -90,10 +90,10 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 | 创建主题-合并请求 | 描述 | | --- | --- | | 在本地处理合并请求 | 在本地处理合并请求的提示| -| [Cherry-pick](/docs/user/project/merge-request/cherry-pick.md) | 对更改进行 Cherry Pick | -| [Merge request thread resolution](/docs/user/discussions.md#moving-a-single-thread-to-a-new-issue) | 解析线程,将合并请求中的线程移至问题,并且仅在解决所有线程后才允许合并请求 | -| [合并请求](/docs/user/project/merge-request.md) | 合并请求管理 | -| [草稿合并请求](/docs/user/project/merge-request/draft.md) | 防止合并草稿合并请求 | +| [Cherry-pick](/docs/user/project/merge-request/cherry-pick) | 对更改进行 Cherry Pick | +| [Merge request thread resolution](/docs/user/discussions#moving-a-single-thread-to-a-new-issue) | 解析线程,将合并请求中的线程移至问题,并且仅在解决所有线程后才允许合并请求 | +| [合并请求](/docs/user/project/merge-request) | 合并请求管理 | +| [草稿合并请求](/docs/user/project/merge-request/draft) | 防止合并草稿合并请求 | [返回概览](#概览) @@ -106,7 +106,7 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 | --- | --- | | Basics guides | 开始在命令行和 CODEChina 上工作 | | Workflow overview | 利用最佳的工作流程增强您的工作流程 | -| [Markdown](/docs/user/markdown.md) | 高级格式化系统(Markdown) | +| [Markdown](/docs/user/markdown) | 高级格式化系统(Markdown) | [返回概览](#概览) @@ -116,9 +116,9 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 | 主题 | 描述 | | --- | --- | -| [用户账号](/docs/user/account.md) | 管理您的帐户 | +| [用户账号](/docs/user/account) | 管理您的帐户 | | 账号验证 | 设置您的 SSH 密钥,并部署密钥以安全地访问您的项目 | -| [用户权限](/docs/user/permissions.md) | 了解项目中的每个角色可以做什么 | +| [用户权限](/docs/user/permissions) | 了解项目中的每个角色可以做什么 | [返回概览](#概览) @@ -140,7 +140,7 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 | 主题 | 描述 | | --- | --- | -| [导入项目](/docs/user/project/import.md) | 从 GitHub,Bitbucket,GitLab.com,FogBugz 和 SVN 导入项目 | +| [导入项目](/docs/user/project/import) | 从 GitHub 和 SVN 导入项目 | | 从SVN迁移 | 将 SVN 存储库转换为 Git 和 CODEChina | [返回概览](#概览) diff --git a/SUMMARY.md b/SUMMARY.md deleted file mode 100644 index 54f6ded..0000000 --- a/SUMMARY.md +++ /dev/null @@ -1,70 +0,0 @@ -# Summary - -* [首页](README.md) -* [概览](docs/overview.md) -* [组织](docs/user/org.md) - * [子组织](docs/user/org/sub_org.md) -* [项目](docs/user/project.md) - * [徽章](docs/user/project/badges.md) - * [批量编辑](docs/user/project/bulk-edit.md) - * [新建项目](docs/basic/create-project.md) - * [描述模板](docs/user/project/description-template.md) - * [文件查找](docs/user/project/repo/file-find.md) - * [合并请求](docs/user/project/merge-request.md) - * [允许协作](docs/user/project/merge-request/fork-collaboration.md) - * [创建合并请求](docs/user/project/merge-request/create-merge-request.md) - * [Cherry-pick](docs/user/project/merge-request/cherry-pick.md) - * [快进合并](docs/user/project/merge-request/fast-forward.md) - * [解决冲突](docs/user/project/merge-request/resolve-conflicts.md) - * [还原](docs/user/project/merge-request/revert.md) - * [评审及管理](docs/user/project/merge-request/reviewing.md) - * [Squash合并](docs/user/project/merge-request/squash.md) - * [合并请求版本](docs/user/project/merge-request/versions.md) - * [草稿](docs/user/project/merge-request/draft.md) - * [项目成员](docs/user/project/member.md) - * [导入](docs/user/project/import.md) - * [Github](docs/user/project/import/github.md) - * [URL](docs/user/project/import/by-url.md) - * [Releases](docs/user/project/releases.md) - * [代码仓库](docs/user/project/repo.md) - * [分支](docs/user/project/repo/branches.md) - * [Git属性](docs/user/project/git-attr.md) - * [文件指责](docs/user/project/repo/blame.md) - * [文件历史记录](docs/user/project/repo/history.md) - * [保护分支](docs/user/project/protected-branch.md) - * [保护Tag](docs/user/project/protected-tag.md) - * [减少仓库大小](docs/user/project/repo/reduce-repo-size.md) - * [GPG签名提交](docs/user/project/repo/gpg-sign.md) - * [文件编辑](docs/user/project/repo/web-editor.md) - * [WebIDE](docs/user/project//webide.md) - * [项目设置](docs/user/project/settings.md) - * [与群组共享项目](docs/user/project/member/share.md) - * [wiki](docs/user/project/wiki.md) -* [Issues](docs/user/project/issues.md) - * [机密Issue](docs/user/project/issues/confidential.md) - * [关联Issue](docs/user/project/issues/crosslinking.md) - * [截止日期](docs/user/project/issues/due-date.md) - * [看板](docs/user/project/kanban.md) - * [操作Issue](docs/user/project/issues/actions.md) - * [标签](docs/user/project/label.md) - * [管理Issue](docs/user/project/issues/manage.md) - * [里程碑](docs/user/project/milestone.md) - * [Issue排序](docs/user/project/issues/sort.md) -* [用户](docs/user.md) - * [举报用户](docs/user/abuse.md) - * [用户账号](docs/user/account.md) - * [登录日志](docs/user/account/logs.md) - * [用户权限](docs/user/permissions.md) - * [个人访问令牌](docs/user/profile/token.md) - * [个人偏好](docs/user/profile/preferences.md) - * [探讨](docs/user/discussions.md) - * [SSH密钥](docs/ssh.md) - * [快捷键](docs/user/shortcutkey.md) - * [Markdown](docs/user/markdown.md) - * [电子邮件通知](docs/user/account/email-notify.md) - * [快速操作](docs/user/project/quick-actions.md) - * [自动填充](docs/user/project/autofill.md) - * [预留命名空间](docs/user/reserved.md) - * [搜索](docs/user/search.md) - * [时间跟踪](docs/user/project/time-track.md) - * [待办事项](docs/user/todo.md) \ No newline at end of file diff --git a/_sidebar.md b/_sidebar.md new file mode 100644 index 0000000..0d79c22 --- /dev/null +++ b/_sidebar.md @@ -0,0 +1,70 @@ +# 快速访问 + +- [首页](README) +- [概览](docs/overview) +- [组织](docs/user/org) + - [子组织](docs/user/org/sub_org) +- [项目](docs/user/project) + - [徽章](docs/user/project/badges) + - [批量编辑](docs/user/project/bulk-edit) + - [新建项目](docs/basic/create-project) + - [描述模板](docs/user/project/description-template) + - [文件查找](docs/user/project/repo/file-find) + - [合并请求](docs/user/project/merge-request) + - [允许协作](docs/user/project/merge-request/fork-collaboration) + - [创建合并请求](docs/user/project/merge-request/create-merge-request) + - [Cherry-pick](docs/user/project/merge-request/cherry-pick) + - [快进合并](docs/user/project/merge-request/fast-forward) + - [解决冲突](docs/user/project/merge-request/resolve-conflicts) + - [还原](docs/user/project/merge-request/revert) + - [评审及管理](docs/user/project/merge-request/reviewing) + - [Squash合并](docs/user/project/merge-request/squash) + - [合并请求版本](docs/user/project/merge-request/versions) + - [草稿](docs/user/project/merge-request/draft) + - [项目成员](docs/user/project/member) + - [导入](docs/user/project/import) + - [Github](docs/user/project/import/github) + - [URL](docs/user/project/import/by-url) + - [Releases](docs/user/project/releases) + - [代码仓库](docs/user/project/repo) + - [分支](docs/user/project/repo/branches) + - [Git属性](docs/user/project/git-attr) + - [文件指责](docs/user/project/repo/blame) + - [文件历史记录](docs/user/project/repo/history) + - [保护分支](docs/user/project/protected-branch) + - [保护Tag](docs/user/project/protected-tag) + - [减少仓库大小](docs/user/project/repo/reduce-repo-size) + - [GPG签名提交](docs/user/project/repo/gpg-sign) + - [文件编辑](docs/user/project/repo/web-editor) + - [WebIDE](docs/user/project//webide) + - [项目设置](docs/user/project/settings) + - [与群组共享项目](docs/user/project/member/share) + - [wiki](docs/user/project/wiki) +- [Issues](docs/user/project/issues) + - [机密Issue](docs/user/project/issues/confidential) + - [关联Issue](docs/user/project/issues/crosslinking) + - [截止日期](docs/user/project/issues/due-date) + - [看板](docs/user/project/kanban) + - [操作Issue](docs/user/project/issues/actions) + - [标签](docs/user/project/label) + - [管理Issue](docs/user/project/issues/manage) + - [里程碑](docs/user/project/milestone) + - [Issue排序](docs/user/project/issues/sort) +- [用户](docs/user) + - [举报用户](docs/user/abuse) + - [用户账号](docs/user/account) + - [登录日志](docs/user/account/logs) + - [用户权限](docs/user/permissions) + - [个人访问令牌](docs/user/profile/token) + - [个人偏好](docs/user/profile/preferences) + - [探讨](docs/user/discussions) + - [SSH密钥](docs/ssh) + - [快捷键](docs/user/shortcutkey) + - [Markdown](docs/user/markdown) + - [电子邮件通知](docs/user/account/email-notify) + - [快速操作](docs/user/project/quick-actions) + - [自动填充](docs/user/project/autofill) + - [预留命名空间](docs/user/reserved) + - [搜索](docs/user/search) + - [时间跟踪](docs/user/project/time-track) + - [待办事项](docs/user/todo) \ No newline at end of file diff --git a/docs/basic/create-project.md b/docs/basic/create-project.md index 63c2128..a5606c2 100644 --- a/docs/basic/create-project.md +++ b/docs/basic/create-project.md @@ -1,6 +1,6 @@ # 新建项目[](#create-a-project "Permalink") -开发中大多数工作都在一个[项目](/docs/user/project/repo.md)完成,文件和代码都保存在项目中,并且大多数功能都将在项目范围内使用。 +开发中大多数工作都在一个[项目](/docs/user/project/repo)完成,文件和代码都保存在项目中,并且大多数功能都将在项目范围内使用。 ## 新建一个项目[](#create-a-project "Permalink") @@ -12,7 +12,7 @@ * 使用可用的[项目模板](#project-templates)之一创建一个项目 * 从其他第三方导入一个项目,目前支持 github 以及 url 导入这两种方式 -**注意:**有关不能用作项目名称的单词列表,请参见[保留的项目和组名称](/docs/user/reserved.md) 。 +**注意:**有关不能用作项目名称的单词列表,请参见[保留的项目和组名称](/docs/user/reserved) 。 ### 空项目[](#blank-projects "Permalink") diff --git a/docs/overview.md b/docs/overview.md index 3f7da26..ce6a027 100644 --- a/docs/overview.md +++ b/docs/overview.md @@ -6,7 +6,7 @@ | 基础入门 | 基本入门 | | --- | --- | -| [**用户文件**](/docs/user.md)熟悉CODEChina 中的功能和概念. |[**是 Git 和 GitLab/GitHub 的新手吗?**](#刚开始使用gitcodechinagitlabgithub)我们有资源可以帮助您入门 | +| [**用户文件**](/docs/user)熟悉CODEChina 中的功能和概念. |[**是 Git 和 GitLab/GitHub 的新手吗?**](#刚开始使用gitcodechinagitlabgithub)我们有资源可以帮助您入门 | | [**为 CODEChina 做贡献**](#为codechina开源做贡献)为CODEChina开源贡献力量! | [**从另一个平台进入 CODEChina?**](#从另一个平台进入到-codechina)请查阅我们的便捷指南 | @@ -25,18 +25,18 @@ | 计划主题 | 描述 | | --- | --- | | Burndown Charts| 在特定的里程碑中观察项目的进度 | -| [讨论](/docs/user/discussions.md) | 问题,提交和合并请求中的线程,注释和可解决线程 | -| [截止日期](/docs/user/project/issues/due-date.md) | 跟踪发行期限| +| [讨论](/docs/user/discussions) | 问题,提交和合并请求中的线程,注释和可解决线程 | +| [截止日期](/docs/user/project/issues/due-date) | 跟踪发行期限| | Epics | 跟踪共享主题的问题组| -| [ Issue ](/docs/user/project/issues.md) ,包括[机密问题](/docs/user/project/issues/confidential.md) ,[发布和合并请求模板](/docs/user/project/description-template.md) ,和[移动的问题](/docs/user/project/issues/manage.md#moving-issues) | 项目问题并限制对问题的访问,并创建用于提交新问题和合并请求的模板。 此外,在项目之间转移问题| -| [标签](/docs/user/project/label.md) | 分类问题或使用描述性标签合并请求| -| [里程碑](/docs/user/project/milestone.md) | 设置发布问题和合并请求的里程碑,并带有可选的截止日期| -| [看板](/docs/user/project/kanban.md) | 在 Scrum 或看板上显示问题| -| [快捷方式](/docs/user/shortcutkey.md) | 针对问题或合并请求的常见操作的快捷方式,而无需单击按钮或在WEB界面中使用下拉菜单 | -| [关联 Issue](/docs/user/project/issues/crosslinking.md) | 在问题之间建立关系 | +| [ Issue ](/docs/user/project/issues) ,包括[机密问题](/docs/user/project/issues/confidential) ,[发布和合并请求模板](/docs/user/project/description-template) ,和[移动的问题](/docs/user/project/issues/manage#moving-issues) | 项目问题并限制对问题的访问,并创建用于提交新问题和合并请求的模板。 此外,在项目之间转移问题| +| [标签](/docs/user/project/label) | 分类问题或使用描述性标签合并请求| +| [里程碑](/docs/user/project/milestone) | 设置发布问题和合并请求的里程碑,并带有可选的截止日期| +| [看板](/docs/user/project/kanban) | 在 Scrum 或看板上显示问题| +| [快捷方式](/docs/user/shortcutkey) | 针对问题或合并请求的常见操作的快捷方式,而无需单击按钮或在WEB界面中使用下拉菜单 | +| [关联 Issue](/docs/user/project/issues/crosslinking) | 在问题之间建立关系 | | Roadmap | 可视化史诗般的时间表 | -| [时间跟踪](/docs/user/project/time-track.md) | 跟踪花费在问题和合并请求上的时间 | -| [代办事项](/docs/user/todo.md) | 通过在简单仪表板上显示的时间顺序列表,跟踪需要注意的工作 | +| [时间跟踪](/docs/user/project/time-track) | 跟踪花费在问题和合并请求上的时间 | +| [代办事项](/docs/user/todo) | 通过在简单仪表板上显示的时间顺序列表,跟踪需要注意的工作 | [返回概览](#概览) @@ -55,14 +55,14 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 | 全局搜索 | 利用 Elasticsearch 在整个 CODEChina 实例上进行更快,更高级的代码搜索| | 语法检索 | 使用高级查询获得更具针对性的搜索结果| | Contribution analytics | 请参阅小组贡献者的详细统计信息| -| [创建](/docs/basic/create-project.md)并 fork 项目,以及[导入项目](/docs/user/project/import.md) | 创建,复制和移动项目 | +| [创建](/docs/basic/create-project)并 fork 项目,以及[导入项目](/docs/user/project/import) | 创建,复制和移动项目 | | 锁定文件 | 锁定文件以避免合并冲突 | -| [组织](/docs/user/org.md) and [子组织](/docs/user/org/sub_org.md) | 分组组织您的项目 | +| [组织](/docs/user/org) and [子组织](/docs/user/org/sub_org) | 分组组织您的项目 | | Issue 分析 | 检查每月创建了多少个问题| -| [项目](/docs/user/project.md) ,包括项目访问和[设置](/docs/user/project/settings.md) | 托管源代码,并控制项目的可见性和设置配置。| +| [项目](/docs/user/project) ,包括项目访问和[设置](/docs/user/project/settings) | 托管源代码,并控制项目的可见性和设置配置。| | [搜索](/docs/img/add_user_search_people.png) | 搜索问题,合并请求,项目,组和待办事项。| -| [Web IDE](/docs/user/project/webide.mdl) | 在 WebIDE 中编辑文件| -| [Wikis](/docs/user/project/wiki.md) | 使用内置的 Wiki 来管理您的文档| +| [Web IDE](/docs/user/project/webidel) | 在 WebIDE 中编辑文件| +| [Wikis](/docs/user/project/wiki) | 使用内置的 Wiki 来管理您的文档| [返回概览](#概览) @@ -70,18 +70,18 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 | 创建主题-代码仓库 | 描述 | | --- | --- | -| [分支](/docs/user/project/repo/branches.md)和[默认分支](/docs/user/project/repo/branches.md#default-branch) | 如何在 CODEChina 中使用分支 | -| [提交](/docs/user/project/repo.md#commits) and [署名提交](/docs/user/project/repo/gpg-sign.md) | 处理提交,并使用 GPG 对您的提交进行签名 | -| [创建分支](/docs/user/project/repo/web-editor.md#create-a-new-branch) , [创建](/docs/user/project/repo/web-editor.md#create-a-file)并[上传](/docs/user/project/repo/web-editor.md#upload-a-file)文件,并[创建目录](/docs/user/project/repo/web-editor.md#create-a-directory) | 创建分支,创建和上传文件以及创建目录| -| [删除已合并的分支](/docs/user/project/repo/branches.md#delete-merged-branches) | 合并更改后的批量删除分支| -| [文件模板](/docs/user/project/repo/web-editor.md#template-dropdowns) | 通用文件的文件模板 | -| [文件](/docs/user/project/repo.md#files) | 文件管理 | +| [分支](/docs/user/project/repo/branches)和[默认分支](/docs/user/project/repo/branches#default-branch) | 如何在 CODEChina 中使用分支 | +| [提交](/docs/user/project/repo#commits) and [署名提交](/docs/user/project/repo/gpg-sign) | 处理提交,并使用 GPG 对您的提交进行签名 | +| [创建分支](/docs/user/project/repo/web-editor#create-a-new-branch) , [创建](/docs/user/project/repo/web-editor#create-a-file)并[上传](/docs/user/project/repo/web-editor#upload-a-file)文件,并[创建目录](/docs/user/project/repo/web-editor#create-a-directory) | 创建分支,创建和上传文件以及创建目录| +| [删除已合并的分支](/docs/user/project/repo/branches#delete-merged-branches) | 合并更改后的批量删除分支| +| [文件模板](/docs/user/project/repo/web-editor#template-dropdowns) | 通用文件的文件模板 | +| [文件](/docs/user/project/repo#files) | 文件管理 | | Jupyter Notebook 文件 | 对`.ipynb`文件的支持 | -| [保护分支](/docs/user/project/protected-branch.md) | 使用受保护的分支 | +| [保护分支](/docs/user/project/protected-branch) | 使用受保护的分支 | | 推送规则| 对项目推送的附加控制 | -| [代码仓库](/docs/user/project/repo.md) | 在网页中管理源代码仓库 | +| [代码仓库](/docs/user/project/repo) | 在网页中管理源代码仓库 | | 镜像代码仓库 | 推入或拉出外部的代码仓库 | -| [处理合并请求](/docs/user/project/repo/web-editor.md#tips) | 在提交时启动合并请求 | +| [处理合并请求](/docs/user/project/repo/web-editor#tips) | 在提交时启动合并请求 | [返回概览](#概览) @@ -90,10 +90,10 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 | 创建主题-合并请求 | 描述 | | --- | --- | | 在本地处理合并请求 | 在本地处理合并请求的提示| -| [Cherry-pick](/docs/user/project/merge-request/cherry-pick.md) | 对更改进行 Cherry Pick | -| [Merge request thread resolution](/docs/user/discussions.md#moving-a-single-thread-to-a-new-issue) | 解析线程,将合并请求中的线程移至问题,并且仅在解决所有线程后才允许合并请求 | -| [合并请求](/docs/user/project/merge-request.md) | 合并请求管理 | -| [草稿合并请求](/docs/user/project/merge-request/draft.md) | 防止合并草稿合并请求 | +| [Cherry-pick](/docs/user/project/merge-request/cherry-pick) | 对更改进行 Cherry Pick | +| [Merge request thread resolution](/docs/user/discussions#moving-a-single-thread-to-a-new-issue) | 解析线程,将合并请求中的线程移至问题,并且仅在解决所有线程后才允许合并请求 | +| [合并请求](/docs/user/project/merge-request) | 合并请求管理 | +| [草稿合并请求](/docs/user/project/merge-request/draft) | 防止合并草稿合并请求 | [返回概览](#概览) @@ -106,7 +106,7 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 | --- | --- | | Basics guides | 开始在命令行和 CODEChina 上工作 | | Workflow overview | 利用最佳的工作流程增强您的工作流程 | -| [Markdown](/docs/user/markdown.md) | 高级格式化系统(Markdown) | +| [Markdown](/docs/user/markdown) | 高级格式化系统(Markdown) | [返回概览](#概览) @@ -116,9 +116,9 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 | 主题 | 描述 | | --- | --- | -| [用户账号](/docs/user/account.md) | 管理您的帐户 | +| [用户账号](/docs/user/account) | 管理您的帐户 | | 账号验证 | 设置您的 SSH 密钥,并部署密钥以安全地访问您的项目 | -| [用户权限](/docs/user/permissions.md) | 了解项目中的每个角色可以做什么 | +| [用户权限](/docs/user/permissions) | 了解项目中的每个角色可以做什么 | [返回概览](#概览) @@ -140,7 +140,7 @@ CODEChina 存储库随附分支工具和访问控制,可为项目和代码的 | 主题 | 描述 | | --- | --- | -| [导入项目](/docs/user/project/import.md) | 从 GitHub,Bitbucket,GitLab.com,FogBugz 和 SVN 导入项目 | +| [导入项目](/docs/user/project/import) | 从 GitHub 和 SVN 导入项目 | | 从SVN迁移 | 将 SVN 存储库转换为 Git 和 CODEChina | [返回概览](#概览) diff --git a/docs/user.md b/docs/user.md index d53610c..c962256 100644 --- a/docs/user.md +++ b/docs/user.md @@ -18,7 +18,7 @@ CODEChina 是一个基于 Git 的平台,它集成了许多用于软件开发 您可以创建[项目](project)来托管代码,跟踪问题,在代码上进行协作。或者,您可以在一个项目中完成下列所有操作: -* [代码仓库](/project/repo.md) :将[代码库](/project/repo)托管在具有版本控制的存储库中,并作为完全集成平台的一部分 +* [代码仓库](/project/repo) :将[代码库](/project/repo)托管在具有版本控制的存储库中,并作为完全集成平台的一部分 * [Issues](/project/issues) :探索 Issue * [合并请求](/project/merge_requests) :在代码,评论,每个分支的实时预览更改方面进行协作,并通过合并请求来批准请求 * [里程碑](/project/milestone) :在设置的里程碑日期前处理多个Issue及合并请求 @@ -43,7 +43,7 @@ CODEChina 是一个基于 Git 的平台,它集成了许多用于软件开发 ### Markdown[](#markdown "Permalink") -您可以在[markdown](/docs/user/markdown.md)中了解如何在主题、注释、Issue 及合并请求以及所有支持markdonw的其他地方来使用markdown填写你的内容。 +您可以在[markdown](/docs/user/markdown)中了解如何在主题、注释、Issue 及合并请求以及所有支持markdonw的其他地方来使用markdown填写你的内容。 ## 待办事项[](#todo "Permalink") diff --git a/docs/user/account.md b/docs/user/account.md index 2fc9a4e..e7afa0b 100644 --- a/docs/user/account.md +++ b/docs/user/account.md @@ -14,10 +14,10 @@ * 更新您的个人信息 * 为您的个人资料设置[自定义状态](#current-status) * 管理您的个人资料的[提交电子邮件](#commit-email) -* 管理[个人访问令牌](/docs/user/profile/token.md)以通过 API 和授权的应用程序访问您的帐户 -* 选择用于[通知](/docs/user/account/email-notify.md) ,基于 Web 的提交并显示在您的公开个人资料上的电子邮件 -* 管理[SSH 密钥](/docs/ssh.md)以通过 SSH 访问您的帐户 -* 管理您的[首选项](/docs/user/profile/preferences.md#syntax-highlighting-theme) +* 管理[个人访问令牌](/docs/user/profile/token)以通过 API 和授权的应用程序访问您的帐户 +* 选择用于[通知](/docs/user/account/email-notify) ,基于 Web 的提交并显示在您的公开个人资料上的电子邮件 +* 管理[SSH 密钥](/docs/ssh)以通过 SSH 访问您的帐户 +* 管理您的[首选项](/docs/user/profile/preferences#syntax-highlighting-theme) * 查看您的活动会话并在必要时撤消其中的任何一个 * 访问认证日志,这是涉及您帐户的重要事件的安全日志 diff --git a/docs/user/discussions.md b/docs/user/discussions.md index e7999a8..731f920 100644 --- a/docs/user/discussions.md +++ b/docs/user/discussions.md @@ -10,9 +10,9 @@ 除了标准的评论形式外,您还可以选择以话题讨论的方式创建评论, 收到回复后,评论也将是[话题讨论](#start-a-thread-by-replying-to-a-standard-comment) 的形式。 -评论区域支持[Markdown](/docs/user/markdown.md)和[快速操作](/docs/user/project/quick-actions.md) , 您可以随时编辑自己的评论,拥有" [maintainer"](/docs/user/permissions.md)或更高权限的用户也可以编辑其他人的评论。 +评论区域支持[Markdown](/docs/user/markdown)和[快速操作](/docs/user/project/quick-actions) , 您可以随时编辑自己的评论,拥有" [maintainer"](/docs/user/permissions)或更高权限的用户也可以编辑其他人的评论。 -您还可以通过回复评论通知电子邮件来回复评论,回复标准评论会创建另一个标准评论。回复主题评论会在主题中创建回复,电子邮件回复支持[Markdown](/docs/user/markdown.md)和[快速操作](/docs/user/project/quick-actions.md)。 +您还可以通过回复评论通知电子邮件来回复评论,回复标准评论会创建另一个标准评论。回复主题评论会在主题中创建回复,电子邮件回复支持[Markdown](/docs/user/markdown)和[快速操作](/docs/user/project/quick-actions)。 **注意:**每个对象最多只能有 5,000 条评论,例如:issue,epic 及合并请求。 @@ -146,6 +146,6 @@ * **完成审阅** :提交**审阅中的**所有评论,使其他用户可以看到它们 * **立即添加评论** :提交常规评论,而不是审阅的一部分 -您可以在评论中使用[快速操作](/docs/user/project/quick-actions.md) ,评论也将会显示提交评论后即将执行的操作。 +您可以在评论中使用[快速操作](/docs/user/project/quick-actions) ,评论也将会显示提交评论后即将执行的操作。 要向评论添加更多评论,请照常开始写评论,然后单击**添加到评论**按钮,这会将评论添加到评论中。 diff --git a/docs/user/markdown.md b/docs/user/markdown.md index 8f8a54a..1950d5f 100644 --- a/docs/user/markdown.md +++ b/docs/user/markdown.md @@ -6,7 +6,7 @@ * Issues * 合并请求 * 里程碑 -* 代码段(代码段必须以`.md`扩展名命名) +* 代码段(代码段必须以``扩展名命名) * Wiki * 仓库中的 Markdown 文档 * Epics @@ -17,7 +17,7 @@ ### 从 Redcarpet 过渡到 CommonMark[](#transition-from-redcarpet-to-commonmark "Permalink") -从 11.1 开始,GitLab 使用[CommonMark Ruby 库](https://github.com/gjtorikian/commonmarker)对[Markit](https://github.com/gjtorikian/commonmarker)处理 GitLab 系统中的所有新问题,合并请求,注释和其他 Markdown 内容. 从 11.3 开始,存储库中的 Wiki 页面和 Markdown 文件( `*.md` )也将通过 CommonMark 处理. 从 11.8 开始, [Redcarpet Ruby 库](https://github.com/vmg/redcarpet)已被删除,所有问题和注释,包括 11.1 之前的问题和注释,现在都可以使用[CommonMark Ruby Library 处理](https://github.com/gjtorikian/commonmarker) . +从 11.1 开始,GitLab 使用[CommonMark Ruby 库](https://github.com/gjtorikian/commonmarker)对[Markit](https://github.com/gjtorikian/commonmarker)处理 GitLab 系统中的所有新问题,合并请求,注释和其他 Markdown 内容. 从 11.3 开始,存储库中的 Wiki 页面和 Markdown 文件( `*` )也将通过 CommonMark 处理. 从 11.8 开始, [Redcarpet Ruby 库](https://github.com/vmg/redcarpet)已被删除,所有问题和注释,包括 11.1 之前的问题和注释,现在都可以使用[CommonMark Ruby Library 处理](https://github.com/gjtorikian/commonmarker) . 该文档网站的[Markdown 引擎](https://gitlab.com/gitlab-org/gitlab-docs/-/merge_requests/108)已于 2018 年 10 月[从 Redcarpet 迁移到 Kramdown](https://gitlab.com/gitlab-org/gitlab-docs/-/merge_requests/108) . @@ -80,7 +80,7 @@ GitLab 充分利用了标准(CommonMark)格式,但还包括对 GitLab 用 ### Colors[](#colors "Permalink") -> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#colors) . +> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#colors) . 可以使用颜色标识呈现以 HEX,RGB 或 HSL 格式书写的颜色。 @@ -179,7 +179,7 @@ end ``` ### Emoji[](#emoji "Permalink") -> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#emoji) . +> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#emoji) . ``` Sometimes you want to :monkey: around a bit and add some :star2: to your :speech_balloon:. Well we have a gift for you: @@ -201,7 +201,7 @@ Consult the [Emoji Cheat Sheet](https://www.emojicopy.com) for a list of all sup Front matter 是 Markdown 文档开头,内容之前的元数据。 静态站点生成器(例如[Jekyll](https://jekyllrb.com/docs/front-matter/) , [Hugo](https://s0gohugo0io.icopy.site/content-management/front-matter/)和许多其他应用程序)可以使用此数据。 -当您查看由 GitLab 渲染的 Markdown 文件时,任何 Front matter 都会按原样显示在文档顶部的框中,位于渲染的 HTML 内容之前。要查看示例,可以在[GitLab 文档文件](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/README.md)的源版本和渲染版本之间切换。 +当您查看由 GitLab 渲染的 Markdown 文件时,任何 Front matter 都会按原样显示在文档顶部的框中,位于渲染的 HTML 内容之前。要查看示例,可以在[GitLab 文档文件](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/README)的源版本和渲染版本之间切换。 在 GitLab 中,仅在 Markdown 文件和 Wiki 页面中支持使用 Front matter ,而在其他支持 Markdown 格式的其他地方使用 Front matter 将无法生效。它必须在文档的最顶部,并且必须在定界符之间,如下所述: @@ -253,7 +253,7 @@ $example = array( ### 行内 diff[](#inline-diff "Permalink") -> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#inline-diff) 。 +> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#inline-diff) 。 使用内联 diff 标签,您可以显示`{+ additions +}`或`[- deletions -]` 。 @@ -296,7 +296,7 @@ $example = array( ### 数学公式[](#math "Permalink") -> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#math) 。 +> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#math) 。 可以使用[KaTeX](https://github.com/KaTeX/KaTeX)渲染用 LaTeX 语法编写的数学运算。 @@ -360,7 +360,7 @@ GFM 将识别以下内容: ### 任务列表[](#task-lists "Permalink") -> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#task-lists)。 +> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#task-lists)。 您可以在支持 Markdown 的任何位置添加任务列表,如果它们处于 Issue、合并请求或评论中,可以通过"单击"切换状态。但在其他地方,您必须手动编辑 Markdown 以通过在方括号内添加或删除`x`来更改状态。 @@ -419,10 +419,10 @@ Second section content. *相对于当前页面* ,带有文件扩展名的链接指向该文件。 -如果下面的代码段放在`/documentation/related`的页面上,它将链接到`/documentation/file.md` : +如果下面的代码段放在`/documentation/related`的页面上,它将链接到`/documentation/file` : ``` -[Link to File](file.md) +[Link to File](file) ``` #### Wiki - hierarchical link[](#wiki---hierarchical-link "Permalink") @@ -441,16 +441,16 @@ Second section content. [Link to Related Page](../main) ``` -如果此代码段放在`/documentation/main`的页面上,它将链接到`/documentation/related.md` : +如果此代码段放在`/documentation/main`的页面上,它将链接到`/documentation/related` : ``` -[Link to Related Page](./related.md) +[Link to Related Page](./related) ``` -如果此代码段放在`/documentation/related/content`的页面上,它将链接到`/documentation/main.md` : +如果此代码段放在`/documentation/related/content`的页面上,它将链接到`/documentation/main` : ``` -[Link to Related Page](../main.md) +[Link to Related Page](../main) ``` #### Wiki - root link[](#wiki---root-link "Permalink") @@ -463,10 +463,10 @@ Second section content. [Link to Related Page](/documentation) ``` -该代码段链接到`/miscellaneous.md` : +该代码段链接到`/miscellaneous` : ``` -[Link to Related Page](/miscellaneous.md) +[Link to Related Page](/miscellaneous) ``` ### Embedding metrics in GitLab Flavored Markdown[](#embedding-metrics-in-gitlab-flavored-markdown "Permalink") @@ -490,7 +490,7 @@ Quote break. #### 多个引用块[](#multiline-blockquote "Permalink") -> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#multiline-blockquote) 。 +> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#multiline-blockquote) 。 GFM 还支持`>>>`围起来的多行块引用,从而扩展了标准的 Markdown 标准: @@ -553,7 +553,7 @@ Tildes are OK too. #### 代码块颜色及语法高亮[](#colored-code-and-syntax-highlighting "Permalink") -> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#colored-code-and-syntax-highlighting) 。 +> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#colored-code-and-syntax-highlighting) 。 GitLab 使用[Rouge Ruby 库](http://rouge.jneen.net/)在代码块中突出显示了更加丰富多彩的语法. 有关支持的语言的列表,请访问[Rouge 项目 Wiki](https://github.com/rouge-ruby/rouge/wiki/List-of-supported-languages-and-lexers) . 语法突出显示仅在代码块中受支持,因此在内联时无法突出显示代码. @@ -624,7 +624,7 @@ Strikethrough uses two tildes. ~~Scratch this.~~ #### Multiple underscores in words and mid-word emphasis[](#multiple-underscores-in-words-and-mid-word-emphasis "Permalink") -> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#multiple-underscores-in-words)。 +> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#multiple-underscores-in-words)。 仅将单词的*一部分*斜体化通常是没有用的,尤其是当您要处理经常带有多个下划线的代码和名称时。 结果,GFM 通过忽略单词中的多个下划线来扩展了标准的 Markdown 标准,以更好地呈现讨论代码的 Markdown 文档: @@ -741,7 +741,7 @@ Reference-style (hover to see title text): #### 视频[](#videos "Permalink") -> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#videos) 。 +> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#videos) 。 链接到带有视频扩展名的文件的图像标签会自动转换为视频播放器. 有效的视频扩展名是`.mp4` , `.m4v` , `.mov` , `.webm`和`.ogv` : @@ -752,7 +752,7 @@ Here's a sample video: #### 音频[](#audio "Permalink") -> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#audio) 。 +> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#audio) 。 与视频类似,带有音频扩展名的文件的链接标签会自动转换为音频播放器,有效的音频扩展名是`.mp3` , `.oga` , `.ogg` , `.spx`和`.wav` : @@ -763,7 +763,7 @@ Here's a sample audio clip: ### 行内 HTML[](#inline-html "Permalink") -> 要在第二个示例中[查看](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#inline-html)在 HTML 中呈现的 Markdown,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#inline-html) 。 +> 要在第二个示例中[查看](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#inline-html)在 HTML 中呈现的 Markdown,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#inline-html) 。 您还可以在 Markdown 中使用原始 HTML,通常效果都很好。 @@ -793,7 +793,7 @@ Here's a sample audio clip: #### Details and summary[](#details-and-summary "Permalink") -> 要在第二个示例中[查看](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#details-and-summary)在 HTML 中呈现的 Markdown,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#details-and-summary) 。 +> 要在第二个示例中[查看](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#details-and-summary)在 HTML 中呈现的 Markdown,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#details-and-summary) 。 可以使用 HTML 的[`
`](https://s0developer0mozilla0org.icopy.site/en-US/docs/Web/HTML/Element/details)和[``](https://s0developer0mozilla0org.icopy.site/en-US/docs/Web/HTML/Element/summary)标记折叠内容. 这对于折叠长日志特别有用,因为它们占用更少的屏幕空间。 @@ -865,13 +865,13 @@ A new line due to the previous backslash. ``` - This is an [inline-style link](https://www.google.com) -- This is a [link to a repository file in the same directory](index.md) -- This is a [relative link to a readme one directory higher](../README.md) +- This is a [link to a repository file in the same directory](index) +- This is a [relative link to a readme one directory higher](../README) - This is a [link that also has title text](https://www.google.com "This link takes you to Google!") Using header ID anchors: -- This links to [a section on a different Markdown page, using a "#" and the header ID](index.md#overview) +- This links to [a section on a different Markdown page, using a "#" and the header ID](index#overview) - This links to [a different section on the same page, using a "#" and the header ID](#header-ids-and-links) Using references: @@ -1010,7 +1010,7 @@ while the equation for the theory of relativity is E = mc2. (另外,你可以通过添加冒号选择文本列中的对齐`:`第二行中的"破折号"线条的两侧), 这将影响列中的每个单元格。 -**注意:** [在 GitLab 本身中](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#tables) ,标题始终在 Chrome 和 Firefox 中左对齐,并在 Safari 中居中。 +**注意:** [在 GitLab 本身中](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#tables) ,标题始终在 Chrome 和 Firefox 中左对齐,并在 Safari 中居中。 ``` | Left Aligned | Centered | Right Aligned | Left Aligned | Centered | Right Aligned | diff --git a/docs/user/org.md b/docs/user/org.md index e2c8fa9..f12a016 100644 --- a/docs/user/org.md +++ b/docs/user/org.md @@ -5,7 +5,7 @@ * 将相关项目组装在一起 * 授予成员一次访问多个项目的权限 -组也可以嵌套在[子组织中](/docs/user/org/sub_org.md) 。 +组也可以嵌套在[子组织中](/docs/user/org/sub_org) 。 通过单击顶部导航中的**组织>您的组织**来找到您的组织。 @@ -29,7 +29,7 @@ * 通过在同一[命名空间](#命名空间)下组织相关项目并将成员添加到顶级组,可以以较少的步骤授予对多个项目和多个团队成员的访问权限。 * 通过创建小组并包括适当的成员,可以轻松地`@mention`所有团队中的问题并合并请求。 -例如,您可以为公司成员创建一个[组织](/docs/user/org/sub_org.md) ,并为每个单独的团队创建一个[子组织](/docs/user/org/sub_org.md). 假设您创建了一个名为`company-team` ,并且在该组中为各个团队`backend-team` , `frontend-team`和`production-team`创建了子组。 +例如,您可以为公司成员创建一个[组织](/docs/user/org/sub_org) ,并为每个单独的团队创建一个[子组织](/docs/user/org/sub_org). 假设您创建了一个名为`company-team` ,并且在该组中为各个团队`backend-team` , `frontend-team`和`production-team`创建了子组。 * 从问题开始新的实现时,请添加评论: *" `@company-team` ,让我们开始吧!* *`@company-team/backend-team`您很高兴!"* * 当您的后端团队需要前端提供帮助时,他们会添加一条评论: *" `@company-team/frontend-team`您能在这里帮助我们吗?"* @@ -59,15 +59,15 @@ ## 组织内的Issue及合并请求[](#组织内的Issue及合并请求 "Permalink") -Issue及合并请求是项目的一部分。对于组织,您可以在单个列表视图中查看所有[Issue](/docs/user/project/issues.md#issues-list),也可以查看组织中所有项目的请求合并。 +Issue及合并请求是项目的一部分。对于组织,您可以在单个列表视图中查看所有[Issue](/docs/user/project/issues#issues-list),也可以查看组织中所有项目的请求合并。 ### 批量编辑Issue及合并请求[](#批量编辑Issue及合并请求 "Permalink") -有关详细信息,请参考[批量编辑Issue及合并请求](/docs/user/project/bulk-edit.md) 。 +有关详细信息,请参考[批量编辑Issue及合并请求](/docs/user/project/bulk-edit) 。 ## 新建一个组织[](#新建一个组织 "Permalink") -> 有关不允许用作组名的单词列表,请参见[保留名称](/docs/user/reserved.md) 。 +> 有关不允许用作组名的单词列表,请参见[保留名称](/docs/user/reserved) 。 通过以下方式,您可以创建一个新的组织: @@ -98,7 +98,7 @@ Issue及合并请求是项目的一部分。对于组织,您可以在单个列 在**组织设置-组织成员设置**中将成员添加到组织,可以通过用户名或者注册邮箱来添加组织成员。 -选择[权限级别](/docs/user/permissions.md#permissions) ,然后添加新成员。您还可以设置该用户的到期日期。 +选择[权限级别](/docs/user/permissions#permissions) ,然后添加新成员。您还可以设置该用户的到期日期。 假设一个有两个项目的组织: @@ -122,7 +122,7 @@ Issue及合并请求是项目的一部分。对于组织,您可以在单个列 ## 变更组织的所有者[](#变更组织的所有者 "Permalink") -组织的所有关系是指至少有一个组织成员拥有组织的 [ Owner ](/docs/user/permissions.md#group-members-permissions),一个组织至少需要一名所有者。 +组织的所有关系是指至少有一个组织成员拥有组织的 [ Owner ](/docs/user/permissions#group-members-permissions),一个组织至少需要一名所有者。 只有拥有一个所有者的组织可以变更组织的所有者。 可以通过以下方式变更组织唯一所有者: @@ -132,7 +132,7 @@ Issue及合并请求是项目的一部分。对于组织,您可以在单个列 ## 移除组织成员[](#移除组织成员 "Permalink") -只有[ Owner ](/docs/user/permissions.md#group-members-permissions)权限的[用户](/docs/user/permissions.md#group-members-permissions)才能管理组织成员。 +只有[ Owner ](/docs/user/permissions#group-members-permissions)权限的[用户](/docs/user/permissions#group-members-permissions)才能管理组织成员。 如果要移除的成员在该组中具有直接成员资格,则可以从该组织中移除该成员; 如果成员资格是从父组继承的,则该成员只能从父组中进行移除。 @@ -163,12 +163,12 @@ Issue及合并请求是项目的一部分。对于组织,您可以在单个列 有两种方法可以在组织中新建项目: -* 选择一个组,单击**新建项目**按钮 。 然后,您可以继续[创建您的项目](/docs/basic/create-project.md) 。 +* 选择一个组,单击**新建项目**按钮 。 然后,您可以继续[创建您的项目](/docs/basic/create-project) 。 * 在创建项目时,从下拉菜单中选择已经创建的组名称空间 ### 项目创建权限[](#项目创建权限 "Permalink") -默认情况下, [开发人员和维护人员](/docs/user/permissions.md#group-members-permissions)可以在一个组下创建项目。 +默认情况下, [开发人员和维护人员](/docs/user/permissions#group-members-permissions)可以在一个组下创建项目。 可以通过以下操作为特定组更改此项设置: @@ -188,7 +188,7 @@ Issue及合并请求是项目的一部分。对于组织,您可以在单个列 ## 与组织共享一个项目[](#与组织共享一个项目 "Permalink") -您可以[与组织共享您的项目](/docs/user/project/member/share.md),并向所有组织成员立即授予对该项目的访问权限。 +您可以[与组织共享您的项目](/docs/user/project/member/share),并向所有组织成员立即授予对该项目的访问权限。 或者,您可以[锁定与组织共享功能](#锁定与组织共享功能) 。 @@ -216,7 +216,7 @@ Issue及合并请求是项目的一部分。对于组织,您可以在单个列 转移组织时,请注意: -* 更改组织的父组织可能会产生一些副作用,具体的请参阅[更改存储库路径时的重定向](/docs/user/project.md#redirects-when-changing-repository-paths) ; +* 更改组织的父组织可能会产生一些副作用,具体的请参阅[更改存储库路径时的重定向](/docs/user/project#redirects-when-changing-repository-paths) ; * 您只能将组织/子组织转移到您管理的组织/子组织中; * 您必须手动更新本地存储库以指向新位置; * 如果将要转移的父组织的公开可见性设置低于当前父组织,那么待转移组织机器项目的公开可见性将会与即将要转移到的父组织保持一致; @@ -233,7 +233,7 @@ Issue及合并请求是项目的一部分。对于组织,您可以在单个列 #### 变更组织的路径[](#变更组织的路径 "Permalink") -变更组织的路径也可能会产生一些副作用,具体的请参考[重定向的行为](/docs/user/project.md#redirects-when-changing-repository-paths) 。 +变更组织的路径也可能会产生一些副作用,具体的请参考[重定向的行为](/docs/user/project#redirects-when-changing-repository-paths) 。 如果您要腾出路径,以便其他组织或用户可以使用该路径,由于名称和路径都必须是唯一的,因此您在变更路径的同时也可能需要重命名该组织。 @@ -271,7 +271,7 @@ Issue及合并请求是项目的一部分。对于组织,您可以在单个列 #### 锁定与组织共享功能[](#锁定与组织共享功能 "Permalink") -该功能可防止一个组织中的[项目与另一个组共享项目](/docs/user/project/member/share.md),以便对项目访问进行更严格的控制。 +该功能可防止一个组织中的[项目与另一个组共享项目](/docs/user/project/member/share),以便对项目访问进行更严格的控制。 例如,假设您有两个不同的团队(A 组和 B 组)在一个项目中一起工作,并且要继承该组成员身份,您可以在 A 组和 B 组之间设置共享项目。**使用组锁共享**可以防止其中的任何项目群组与其他群组共享,从而确保只有合适的群组成员才能访问这些项目。 diff --git a/docs/user/org/sub_org.md b/docs/user/org/sub_org.md index 63dfb18..db0c67a 100644 --- a/docs/user/org/sub_org.md +++ b/docs/user/org/sub_org.md @@ -6,9 +6,9 @@ * **独立的子组织** 由于每个组都有自己的可见性级别,因此您可以在同一保护范围内创建不同子组织以满足您不同的使用目的; * **组织大型项目** 对于大型项目,子组织可能会更容易分隔源代码的权限 -* **使管理人员和控制可见性变得更加容易** 根据人们的组织[成员身份](#成员身份)赋予他们不同的[权限](/docs/user/permissions.md#group-members-permissions) +* **使管理人员和控制可见性变得更加容易** 根据人们的组织[成员身份](#成员身份)赋予他们不同的[权限](/docs/user/permissions#group-members-permissions) -有关组织和项目中允许的权限的更多信息,请参考[可见性级别](/docs/user/permissions.md#general-permissions) 。 +有关组织和项目中允许的权限的更多信息,请参考[可见性级别](/docs/user/permissions#general-permissions) 。 ## 概览[](#概览 "Permalink") @@ -41,7 +41,7 @@ 要在组织中创建子组织,您必须是该组织的所有者或维护者,具体取决于该组织的设置(默认情况下,允许所有者和维护者创建子组)。 -有关权限的更多信息,请检查[权限表](/docs/user/permissions.md) 。有关不允许用作组名的单词列表,请参见[保留名称](/docs/user/reserved.md) 。 +有关权限的更多信息,请检查[权限表](/docs/user/permissions) 。有关不允许用作组名的单词列表,请参见[保留名称](/docs/user/reserved) 。 如果用户明确地作为所有者(或维护者,如果启用了此设置)被添加到父组织中,则用户始终可以创建子组,即使管理员在其组织设置中禁用了组创建也是如此。 diff --git a/docs/user/permissions.md b/docs/user/permissions.md index 5a5644c..7f18048 100644 --- a/docs/user/permissions.md +++ b/docs/user/permissions.md @@ -8,13 +8,13 @@ * 留言 * 克隆或下载项目代码 -当成员离开团队的项目时,所有分配给他的" [Issue"](/docs/user/project/issues.md)及" [合并请求"](/docs/user/project/merge-request.md)将自动取消分配。 +当成员离开团队的项目时,所有分配给他的" [Issue"](/docs/user/project/issues)及" [合并请求"](/docs/user/project/merge-request)将自动取消分配。 -要添加或导入用户,可以遵循[项目成员文档](/docs/user/project/member.md)。 +要添加或导入用户,可以遵循[项目成员文档](/docs/user/project/member)。 ## 项目成员权限[](#project-members-permissions "Permalink") -虽然 Maintainer 是项目级别的最高角色,但是某些操作只能由拥有命名空间所有权限的用户或组的 Owner执行。 有关更多信息,请参阅[项目成员文档](/docs/user/project/member.md) 。 +虽然 Maintainer 是项目级别的最高角色,但是某些操作只能由拥有命名空间所有权限的用户或组的 Owner执行。 有关更多信息,请参阅[项目成员文档](/docs/user/project/member) 。 下表描述了项目中的各种用户权限级别: @@ -59,7 +59,7 @@ | Pull packages |   | ✓ | ✓ | ✓ | ✓ | | Publish packages |   |   | ✓ | ✓ | ✓ | | Upload Design Management files |   |   | ✓ | ✓ | ✓ | -| Create/edit/delete [Releases](/docs/user/project/releases.md) |   |   | ✓ | ✓ | ✓ | +| Create/edit/delete [Releases](/docs/user/project/releases) |   |   | ✓ | ✓ | ✓ | | 创建新分支 |   |   | ✓ | ✓ | ✓ | | 推送到不受保护的分支 |   |   | ✓ | ✓ | ✓ | | 强制推送到不受保护的分支 |   |   | ✓ | ✓ | ✓ | @@ -131,9 +131,9 @@ 2. Guest 用户只能查看他们自己创建的机密问题 3. 不允许 Guest,Reporter,Developer,Maintainer 或 Owner 使用,请参阅受保护的分支 4. 如果分支收到保护 ,则取决于授予开发人员和维护人员的权限 -5. Guest 用户可以访问 项目的 [**Release**](/docs/user/project/releases.md)来下载资源,但不能下载源代码,也不能查看代码仓库信息(例如标签和提交) +5. Guest 用户可以访问 项目的 [**Release**](/docs/user/project/releases)来下载资源,但不能下载源代码,也不能查看代码仓库信息(例如标签和提交) 6. 操作仅限于用户拥有(引用)的记录​​ -7. 启用" [共享组锁定"后](/docs/user/org.md#share-with-group-lock) ,该项目将无法与其他组共享,它不影响具有组共享的组 +7. 启用" [共享组锁定"后](/docs/user/org#share-with-group-lock) ,该项目将无法与其他组共享,它不影响具有组共享的组 ## 项目功能权限[](#project-features-permissions "Permalink") @@ -156,7 +156,7 @@ ### 机密 Issue 权限[](#confidential-issues-permissions "Permalink") -报告者和更高的权限级别以及创建机密问题的来宾用户都可以访问机密问题. 要了解更多信息,请通读有关[权限和访问机密问题](/docs/user/project/issues/confidential.md#permissions-and-access-to-confidential-issues)的文档. +报告者和更高的权限级别以及创建机密问题的来宾用户都可以访问机密问题. 要了解更多信息,请通读有关[权限和访问机密问题](/docs/user/project/issues/confidential#permissions-and-access-to-confidential-issues)的文档. ## 组织成员权限[](#group-members-permissions "Permalink") diff --git a/docs/user/profile/preferences.md b/docs/user/profile/preferences.md index 957e97e..69e7e19 100644 --- a/docs/user/profile/preferences.md +++ b/docs/user/profile/preferences.md @@ -41,7 +41,7 @@ * 您的项目活动 * 已加星标项目的活动 * 您的团体 -* [您的代办事项](/docs/user/todo.md) +* [您的代办事项](/docs/user/todo) * 分配的问题 * 分配的合并请求 diff --git a/docs/user/project.md b/docs/user/project.md index 23020c4..f83a2af 100644 --- a/docs/user/project.md +++ b/docs/user/project.md @@ -10,41 +10,41 @@ **代码仓库:** -* [Issue](/docs/user/project/issues.md) :与您的团队讨论问题内的实现 - * [看板](/docs/user/project/kanban.md) :组织工作流程并确定其优先级 -* [代码仓库](/docs/user/project/repo.md) :将代码托管在完全集成的平台中 - * [分支](/docs/user/project/repo/branches.md) :使用 Git 分支策略在代码上进行协作 - * [受保护的分支机构](/docs/user/project/protected-branch.md) :防止协作者弄乱历史记录或在未经审查的情况下推送代码 - * [受保护的标签](/docs/user/project/protected-tag.md) :控制谁有权创建标签,并防止意外更新或删除 +* [Issue](/docs/user/project/issues) :与您的团队讨论问题内的实现 + * [看板](/docs/user/project/kanban) :组织工作流程并确定其优先级 +* [代码仓库](/docs/user/project/repo) :将代码托管在完全集成的平台中 + * [分支](/docs/user/project/repo/branches) :使用 Git 分支策略在代码上进行协作 + * [受保护的分支机构](/docs/user/project/protected-branch) :防止协作者弄乱历史记录或在未经审查的情况下推送代码 + * [受保护的标签](/docs/user/project/protected-tag) :控制谁有权创建标签,并防止意外更新或删除 * 储存库镜像 - * [签署提交](/docs/user/project/repo/gpg-sign.md) :使用 GPG 签署您的提交 + * [签署提交](/docs/user/project/repo/gpg-sign) :使用 GPG 签署您的提交 * 部署令牌 :管理基于项目的部署令牌,这些令牌允许永久访问存储库和 Container Registry. -* [Web IDE](/docs/user/project/webide.md) +* [Web IDE](/docs/user/project/webide) **Release 及合并请求:** -* [Issue](/docs/user/project/issues.md) :与您的团队讨论问题内的实现 - * [发行板](/docs/user/project/kanban.md) :组织工作流程并确定其优先级 -* [合并请求](/docs/user/project/merge-request.md) :应用您的分支策略并获得团队的审查 +* [Issue](/docs/user/project/issues) :与您的团队讨论问题内的实现 + * [发行板](/docs/user/project/kanban) :组织工作流程并确定其优先级 +* [合并请求](/docs/user/project/merge-request) :应用您的分支策略并获得团队的审查 * 合并请求批准 :实施更改之前请求批准 - * [修复合并中的冲突](/docs/user/project/merge-request/resolve-conflicts.md) :直接从网页中使用 Git diff 工具 + * [修复合并中的冲突](/docs/user/project/merge-request/resolve-conflicts) :直接从网页中使用 Git diff 工具 * 审查应用程序 :按分支实时预览合并请求中建议的更改结果 -* [标签](/docs/user/project/label.md) :按标签整理问题并合并请求 -* [时间跟踪](/docs/user/project/time-track.md) :跟踪估计在完成问题或合并请求上花费的时间和时间 -* [里程碑](/docs/user/project/milestone.md) :朝着目标日期迈进 -* [描述模板](/docs/user/project/description-template.md) :为项目定义特定于上下文的模板,并为您的项目合并请求描述字段 -* [斜杠命令(快速操作)](/docs/user/project/quick-actions.md) :针对问题或合并请求的常见操作的文本快捷方式 -* [自动完成字符](/docs/user/project/autofill.md) :自动完成对用户,组,问题,合并请求和其他 GitLab 元素的引用 -* [Web IDE](/docs/user/project/webide.md) +* [标签](/docs/user/project/label) :按标签整理问题并合并请求 +* [时间跟踪](/docs/user/project/time-track) :跟踪估计在完成问题或合并请求上花费的时间和时间 +* [里程碑](/docs/user/project/milestone) :朝着目标日期迈进 +* [描述模板](/docs/user/project/description-template) :为项目定义特定于上下文的模板,并为您的项目合并请求描述字段 +* [斜杠命令(快速操作)](/docs/user/project/quick-actions) :针对问题或合并请求的常见操作的文本快捷方式 +* [自动完成字符](/docs/user/project/autofill) :自动完成对用户,组,问题,合并请求和其他 GitLab 元素的引用 +* [Web IDE](/docs/user/project/webide) **其他特性:** -* [Wiki](/docs/user/project/wiki.md) :在集成的 Wiki 中记录您的项目 +* [Wiki](/docs/user/project/wiki) :在集成的 Wiki 中记录您的项目 * 代码片 :存储,共享和协作代码片段 * 价值流分析 :查看您的开发生命周期 * 分析:配置对您的项目至关重要的见解 * 语法高亮 :一种自定义代码块的替代方法,可替代默认语言选择 -* [Release](/docs/user/project/releases.md) :一种跟踪项目中可交付成果的方式,可作为源,构建输出,其他元数据和与代码的发行版本相关的其他工件的快照 +* [Release](/docs/user/project/releases) :一种跟踪项目中可交付成果的方式,可作为源,构建输出,其他元数据和与代码的发行版本相关的其他工件的快照 * 代码所有者 :为某些文件指定代码所有者 * License :批准和拒绝项目的许可证 * 依赖项列表 :查看项目依赖项 @@ -57,7 +57,7 @@ ## 新建项目[](#新建项目 "Permalink") -了解如何在 CODEChina 中[创建一个新项目](/docs/basic/create-project.md) 。 +了解如何在 CODEChina 中[创建一个新项目](/docs/basic/create-project) 。 ### Fork 项目[](#fork项目 "Permalink") @@ -100,13 +100,13 @@ 项目设置允许您设置项目的可见性级别、访问级别,并执行诸如归档、重命名或转移项目的操作。 -了解更多有关[项目设置](/docs/user/project/settings.md)的文档。 +了解更多有关[项目设置](/docs/user/project/settings)的文档。 ## 导入/导出项目[](#i导入导出项目 "Permalink") -* [导入项目](/docs/user/project/import.md) from: - * [从Github导入](/docs/user/project/import/github.md) - * [从Bitbucket导入](/docs/user/project/import/by-url.md) +* [导入项目](/docs/user/project/import) from: + * [从Github导入](/docs/user/project/import/github) + * [从Bitbucket导入](/docs/user/project/import/by-url) * 导出项目 ## 删除项目[](#删除项目 "Permalink") @@ -126,19 +126,19 @@ ## 项目成员[](#项目成员 "Permalink") -了解如何[将成员添加到您的项目中](/docs/user/project/member.md) +了解如何[将成员添加到您的项目中](/docs/user/project/member) ## 退出项目[](#退出项目 "Permalink") -当项目属于组织时(即项目在[组织的命名空间下](/docs/user/org.md#命名空间) ),**退出项目**将仅显示在项目的页面上。如果您选择退出项目,那么您将不再是项目成员,并且将无法继续参与项目。 +当项目属于组织时(即项目在[组织的命名空间下](/docs/user/org#命名空间) ),**退出项目**将仅显示在项目的页面上。如果您选择退出项目,那么您将不再是项目成员,并且将无法继续参与项目。 ## 项目首页[](#项目首页 "Permalink") 项目首页会根据项目的可见性设置和用户权限来显示不同的内容: -对于公共项目以及私有项目中[有权查看该项目代码](/docs/user/permissions.md#project-members-permissions)的项目成员: +对于公共项目以及私有项目中[有权查看该项目代码](/docs/user/permissions#project-members-permissions)的项目成员: -* 显示[`README`文件或索引文件的](/docs/user/project/repo.md#repository-readme-and-index-files)内容(如果有),然后显示项目存储库中的目录列表 +* 显示[`README`文件或索引文件的](/docs/user/project/repo#repository-readme-and-index-files)内容(如果有),然后显示项目存储库中的目录列表 * 如果项目不包含这些文件中的任何一个,则访问者将看到存储库的文件和目录列表 对于没有权限查看项目代码的用户: diff --git a/docs/user/project/autofill.md b/docs/user/project/autofill.md index 635538a..562f4fe 100644 --- a/docs/user/project/autofill.md +++ b/docs/user/project/autofill.md @@ -16,7 +16,7 @@ 弹出列表中最多显示 5 个最相关的匹配项,当您从列表中选择一个项目时,该值将输入到该字段中。输入的字符越多,匹配结果就越精确。 -与" [快速操作"](/docs/user/project/quick-actions.md)结合使用时,字符自动完成将会十分有用。 +与" [快速操作"](/docs/user/project/quick-actions)结合使用时,字符自动完成将会十分有用。 ## 举例[](#example "Permalink") diff --git a/docs/user/project/bulk-edit.md b/docs/user/project/bulk-edit.md index 330335c..bf593d8 100644 --- a/docs/user/project/bulk-edit.md +++ b/docs/user/project/bulk-edit.md @@ -13,7 +13,7 @@ ## 项目中批量编辑 Issue[](#bulk-edit-issues-at-the-project-level "Permalink") -**注意:**您需要具有[Reporter 或更高](/docs/user/permissions.md)级别的权限才能管理 Issue 。 +**注意:**您需要具有[Reporter 或更高](/docs/user/permissions)级别的权限才能管理 Issue 。 当批量编辑项目的 Issue 时,您可以更改 Issue 的以下属性: @@ -32,7 +32,7 @@ ## 项目中批量编辑合并请求[](#bulk-edit-merge-requests-at-the-project-level "Permalink") -**注意:**您需要[开发人员或更高](/docs/user/permissions.md)级别的权限才能管理合并请求。 +**注意:**您需要[开发人员或更高](/docs/user/permissions)级别的权限才能管理合并请求。 在项目中批量编辑合并请求时,可以编辑以下属性: diff --git a/docs/user/project/description-template.md b/docs/user/project/description-template.md index af804ee..cba26ee 100644 --- a/docs/user/project/description-template.md +++ b/docs/user/project/description-template.md @@ -8,7 +8,7 @@ 每个项目都可以定义自己的一组描述模板,这些模板将被添加到项目代码仓库的根目录中。 -描述模板必须用[Markdown](/docs/user/markdown.md)编写,并存储在项目的存储库中的`.gitlab`目录下,且仅考虑默认分支的模板。 +描述模板必须用[Markdown](/docs/user/markdown)编写,并存储在项目的存储库中的`.gitlab`目录下,且仅考虑默认分支的模板。 ## 示例[](#use-cases "Permalink") @@ -18,12 +18,12 @@ ## 创建 Issue 描述模板[](#creating-issue-templates "Permalink") -在代码仓库的`.gitlab/issue_templates/`目录内创建一个新的 Markdown( `.md` )文件,提交并推送到您的默认分支。 +在代码仓库的`.gitlab/issue_templates/`目录内创建一个新的 Markdown( `` )文件,提交并推送到您的默认分支。 可以通过以下步骤新建一个 markdown 文件: 1. 单击`master`旁边的`+`按钮,然后单击**新建文件** -2. 将 Issue 模板的名称添加到`master`旁边的**文件名称**文本字段中,确保单词之间用下划线分隔,并且文件的扩展名为`.md` ,例如`feature_request.md` +2. 将 Issue 模板的名称添加到`master`旁边的**文件名称**文本字段中,确保单词之间用下划线分隔,并且文件的扩展名为`` ,例如`feature_request` 3. 提交并推送到您的默认分支 如果您的存储库中没有`.gitlab/issue_templates`目录,则需要创建它。 @@ -35,21 +35,21 @@ 3. 再次单击`master`旁边的`+`按钮,然后选择**新建目录** 4. 将新目录命名为`issue_templates`,并提交到默认分支 -要检查它是否正常工作,请[创建一个新 Issue](/docs/user/project/issues/manage.md#create-a-new-issue),然后查看是否可以选择描述模板。 +要检查它是否正常工作,请[创建一个新 Issue](/docs/user/project/issues/manage#create-a-new-issue),然后查看是否可以选择描述模板。 ## 创建合并请求描述模板[](#creating-merge-request-templates "Permalink") -与 Issue 模板类似,在代码仓库的`.gitlab/merge_request_templates/`目录内创建一个新的 Markdown( `.md` )文件. 提交并推送到您的默认分支。 +与 Issue 模板类似,在代码仓库的`.gitlab/merge_request_templates/`目录内创建一个新的 Markdown( `` )文件. 提交并推送到您的默认分支。 ## 使用模板[](#using-the-templates "Permalink") -假设我们已经创建了`.gitlab/issue_templates/Bug.md`文件,在创建或编辑问题时,这将启用`Bug`下拉选项,选择`Bug`,`Bug.md`模板文件中的内容将被复制到 Issue 描述字段;可以通过"重置模板"按钮放弃您在选择模板后所做的任何更改,并将其恢复为初始状态。 +假设我们已经创建了`.gitlab/issue_templates/Bug`文件,在创建或编辑问题时,这将启用`Bug`下拉选项,选择`Bug`,`Bug`模板文件中的内容将被复制到 Issue 描述字段;可以通过"重置模板"按钮放弃您在选择模板后所做的任何更改,并将其恢复为初始状态。 ## 描述模板示例[](#description-template-example "Permalink") GitLab 社区版项目中提供了一些 Issue 及合并请求的描述模板,具体的可以参考[`.gitlab`文件夹](https://gitlab.com/gitlab-org/gitlab/tree/master/.gitlab)中的一些示例。 -**提示:**可以在描述模板中使用[快速操作](/docs/user/project/quick-actions.md)来快速添加标签,指派人和里程碑。仅当提交问题或合并请求的用户有权执行相关操作时,才可以执行快速操作。 +**提示:**可以在描述模板中使用[快速操作](/docs/user/project/quick-actions)来快速添加标签,指派人和里程碑。仅当提交问题或合并请求的用户有权执行相关操作时,才可以执行快速操作。 以下是一个 bug 的模板示例: diff --git a/docs/user/project/import.md b/docs/user/project/import.md index 2744621..89f4f85 100644 --- a/docs/user/project/import.md +++ b/docs/user/project/import.md @@ -1,6 +1,6 @@ # 迁移项目[](#迁移项目 "Permalink") -1. [From GitHub.com or GitHub Enterprise](/docs/user/project/import/github.md) -2. [From repo by URL](/docs/user/project/import/by-url.md) +1. [From GitHub.com or GitHub Enterprise](/docs/user/project/import/github) +2. [From repo by URL](/docs/user/project/import/by-url) 除了上述特定的迁移文档之外,您还可以从 New Project 页面通过 HTTP 导入任何 Git 代码仓库。请注意,如果存储库太大,则导入可能会因为超时而失败。 \ No newline at end of file diff --git a/docs/user/project/issues.md b/docs/user/project/issues.md index 4b24537..5d48927 100644 --- a/docs/user/project/issues.md +++ b/docs/user/project/issues.md @@ -54,24 +54,24 @@ Issue 包含各种内容和元数据,从而在使用方式上具有很大的 针对问题的关键操作包括: -* [新建 Issue](/docs/user/project/issues/manage.md#create-a-new-issue) -* [移动 Issue](/docs/user/project/issues/manage.md#moving-issues) -* [关闭 Issue](/docs/user/project/issues/manage.md#closing-issues) -* [删除 Issue](/docs/user/project/issues/manage.md#deleting-issues) +* [新建 Issue](/docs/user/project/issues/manage#create-a-new-issue) +* [移动 Issue](/docs/user/project/issues/manage#moving-issues) +* [关闭 Issue](/docs/user/project/issues/manage#closing-issues) +* [删除 Issue](/docs/user/project/issues/manage#deleting-issues) ### Issue 详情页[](#issue-page "Permalink") -在 Issue 的详情页面上,您可以查看 Issue 的所有方面,如果有必要的[权限](/docs/user/permissions.md) ,可以对其进行修改。 +在 Issue 的详情页面上,您可以查看 Issue 的所有方面,如果有必要的[权限](/docs/user/permissions) ,可以对其进行修改。 ### Issue 列表[](#issues-list "Permalink") -在" Issue 列表"上,可以查看当前项目中的所有问题。使用[搜索查询](/docs/user/search.md#filtering-issue-and-merge-request-lists)过滤 Issue 列表,包括特定的元数据,例如标签,指派人,状态等。从此视图,您还可以对显示的 Issue [进行批量](/docs/user/project/bulk-edit.md)更改。 +在" Issue 列表"上,可以查看当前项目中的所有问题。使用[搜索查询](/docs/user/search#filtering-issue-and-merge-request-lists)过滤 Issue 列表,包括特定的元数据,例如标签,指派人,状态等。从此视图,您还可以对显示的 Issue [进行批量](/docs/user/project/bulk-edit)更改。 -您可以通过多种方式对问题列表进行排序,例如,通过问题创建日期,里程碑到期日期. 有关更多信息,请参见[排序和排序 Issue 列表](/docs/user/project/issues/sort.md)页面. +您可以通过多种方式对问题列表进行排序,例如,通过问题创建日期,里程碑到期日期. 有关更多信息,请参见[排序和排序 Issue 列表](/docs/user/project/issues/sort)页面. ### 看板[](#issue-boards "Permalink") -[看板](/docs/user/project/kanban.md)中的其栏目根据标签来显示 Issue,它提供了可高度定制的工作流来管理问题的灵活性。 +[看板](/docs/user/project/kanban)中的其栏目根据标签来显示 Issue,它提供了可高度定制的工作流来管理问题的灵活性。 您可以在栏中重新排序 Issue,如果将 Issue 拖到另一列,则其关联的标签将更改以匹配新列的标签,整个看板可以被筛选为仅包括某个里程碑或总体标签中的问题。 @@ -81,7 +81,7 @@ Issue 包含各种内容和元数据,从而在使用方式上具有很大的 ### 关联 Issue[](#crosslinking-issues "Permalink") -您可以通过引用另一个 Issue 来[关联 Issue](/docs/user/project/issues/crosslinking.md) ,也可以通过包括其 URL 或 ID 来合并请求。参考的 Issue 在活动流中显示有关参考的消息,并带有指向其他 Issue 或合并请求的链接。 +您可以通过引用另一个 Issue 来[关联 Issue](/docs/user/project/issues/crosslinking) ,也可以通过包括其 URL 或 ID 来合并请求。参考的 Issue 在活动流中显示有关参考的消息,并带有指向其他 Issue 或合并请求的链接。 ### 相似 Issue[](#similar-issues "Permalink") @@ -91,6 +91,6 @@ Issue 包含各种内容和元数据,从而在使用方式上具有很大的 ## 其他 Issue 操作[](#other-issue-actions "Permalink") -* [从模板创建 Issue](/docs/user/project/description-template.md#using-the-templates) -* [设置截止日期](/docs/user/project/issues/due-date.md) -* [批量编辑问题](/docs/user/project/bulk-edit.md)——从 Issue 列表中选择多个 Issue,以批量更改其状态,指派人,里程碑或标签。 \ No newline at end of file +* [从模板创建 Issue](/docs/user/project/description-template#using-the-templates) +* [设置截止日期](/docs/user/project/issues/due-date) +* [批量编辑问题](/docs/user/project/bulk-edit)——从 Issue 列表中选择多个 Issue,以批量更改其状态,指派人,里程碑或标签。 \ No newline at end of file diff --git a/docs/user/project/issues/actions.md b/docs/user/project/issues/actions.md index cfa7ae1..5a494d2 100644 --- a/docs/user/project/issues/actions.md +++ b/docs/user/project/issues/actions.md @@ -1,6 +1,6 @@ # 操作Issue[](#操作Issue "Permalink") -请参考[ Issue 文档](/docs/user/project/issues.md)以了解更多关于 Issue 的介绍。 +请参考[ Issue 文档](/docs/user/project/issues)以了解更多关于 Issue 的介绍。 ## Issue的元素[](#parts-of-an-issue "Permalink") @@ -40,11 +40,11 @@ Issue 从状态(打开或关闭)开始,然后是作者,并包括许多 单击" **新建 Issue"**将打开一个新窗口,可以在同一项目中创建一个新 Issue。单击**关闭 Issue**将关闭此 Issue,但不会被删除。如果 Issue 已经关闭,您仍然可以访问它,并且按钮将显示**重新开启 issue** ,您可以单击以重新打开 Issue,重新开放的 Issue 与其他任何 Issue 都没有不同。 -如果您无权修改 Issue,则" **关闭 Issue"**按钮将替换为" **举报 Issue"** ,您可以单击该按钮以[提交](/docs/user/abuse.md)有关该 Issue [的滥用情况报告](/docs/user/abuse.md); 如果您有权修改 Issue,但仅在关闭 Issue后,它也会显示. +如果您无权修改 Issue,则" **关闭 Issue"**按钮将替换为" **举报 Issue"** ,您可以单击该按钮以[提交](/docs/user/abuse)有关该 Issue [的滥用情况报告](/docs/user/abuse); 如果您有权修改 Issue,但仅在关闭 Issue后,它也会显示. ### 待办事项[](#to-do "Permalink") -您可以在[待办事项列表](/docs/user/todo.md)添加待办事项或从中删除待办事项。具体可以执行的操作取决于待办事项是否已在"任务列表"中,如果问题是: +您可以在[待办事项列表](/docs/user/todo)添加待办事项或从中删除待办事项。具体可以执行的操作取决于待办事项是否已在"任务列表"中,如果问题是: * 已在您的待办事项清单上:该按钮标有" **标记为已完成"** ,单击按钮以从您的任务列表中删除该问题 * 不在您的待办事项清单上:该按钮标有**添加待办事项** ,单击按钮将问题添加到您的"任务列表"中 @@ -62,19 +62,19 @@ Issue 从状态(打开或关闭)开始,然后是作者,并包括许多 ### 里程碑[](#milestone "Permalink") -选择一个[里程碑](/docs/user/project/milestone.md) ,并将 Issue 归类到其中。 +选择一个[里程碑](/docs/user/project/milestone) ,并将 Issue 归类到其中。 ### 工时统计[](#time-tracking "Permalink") -使用[快速行动](/docs/user/project/quick-actions.md)来[跟踪估计和花费在 Issue 上的时间](/docs/user/project/time-track.md) ,您可以添加解决 Issue [所需时间](/docs/user/project/time-track.md#estimates)的[估计](/docs/user/project/time-track.md#estimates),还可以添加解决 Issue[所花费的时间](/docs/user/project/time-track.md#time-spent) 。 +使用[快速行动](/docs/user/project/quick-actions)来[跟踪估计和花费在 Issue 上的时间](/docs/user/project/time-track) ,您可以添加解决 Issue [所需时间](/docs/user/project/time-track#estimates)的[估计](/docs/user/project/time-track#estimates),还可以添加解决 Issue[所花费的时间](/docs/user/project/time-track#time-spent) 。 ### 截止日期[](#due-date "Permalink") -当您的工作时间很紧时,有一种方法来为实现和解决 Issue 设置截止日期将尤为重要。这可以在[截止日期](/docs/user/project/issues/due-date.md)元素中完成,截止日期可以根据需要进行多次更改。 +当您的工作时间很紧时,有一种方法来为实现和解决 Issue 设置截止日期将尤为重要。这可以在[截止日期](/docs/user/project/issues/due-date)元素中完成,截止日期可以根据需要进行多次更改。 ### 标签[](#labels "Permalink") -通过给 Issue 加上[标签](/docs/user/project/label.md)来对其进行分类,它们有助于组织工作流程,并使您能够更顺畅的使用看板。 +通过给 Issue 加上[标签](/docs/user/project/label)来对其进行分类,它们有助于组织工作流程,并使您能够更顺畅的使用看板。 还可以为组织标签分配 Issue ,组织标签允许您对同一组内的所有项目使用相同的标签,它们的工作原理完全相同,并且可立即用于该组织的所有项目。 @@ -82,19 +82,19 @@ Issue 从状态(打开或关闭)开始,然后是作者,并包括许多 ### 机密性[](#confidentiality "Permalink") -您可以[将 Issue 设置为机密](/docs/user/project/issues/confidential.md), 设置后,未经授权的用户将无法访问该 Issue,也不会在项目看板或 Issue 列表中看到该 Issue。 +您可以[将 Issue 设置为机密](/docs/user/project/issues/confidential), 设置后,未经授权的用户将无法访问该 Issue,也不会在项目看板或 Issue 列表中看到该 Issue。 ### 锁定 Issue[](#lock-issue "Permalink") -您可以[锁定 Issue 中的讨论](/docs/user/discussions.md) ,以防止添加更多评论。 +您可以[锁定 Issue 中的讨论](/docs/user/discussions) ,以防止添加更多评论。 ### 参与者[](#participants "Permalink") -涉及该 Issue 的所有用户,他们要么参与了该 Issue 的[讨论](/docs/user/discussions.md) ,要么在描述或讨论中被提及。 +涉及该 Issue 的所有用户,他们要么参与了该 Issue 的[讨论](/docs/user/discussions) ,要么在描述或讨论中被提及。 ### 通知[](#notifications "Permalink") -单击图标以启用/禁用该 Issue 的[通知](/docs/user/account/email-notify.md#issue--epics--merge-request-events) ,如果您以任何方式参与了该 Issue,它将自动启用。 +单击图标以启用/禁用该 Issue 的[通知](/docs/user/account/email-notify#issue--epics--merge-request-events) ,如果您以任何方式参与了该 Issue,它将自动启用。 * **启用**: 如果您不是该 Issue 的参与者,但想要了解该 Issue 的进展,您可以启用并订阅该 Issue 的更新通知 * **禁用** :如果您正在接收有关该 Issue 的更新通知,但不再希望接收它们,请禁用该通知 @@ -105,7 +105,7 @@ Issue 从状态(打开或关闭)开始,然后是作者,并包括许多 ### 描述[](#description "Permalink") -纯文本标题和 Issue 描述位于 Issue 页面的顶部,该描述完全支持[Markdown](/docs/user/markdown.md#gitlab-flavored-markdown-gfm) ,支持许多格式。问题历史记录中列出了对 Issue 描述的更改记录。 +纯文本标题和 Issue 描述位于 Issue 页面的顶部,该描述完全支持[Markdown](/docs/user/markdown#gitlab-flavored-markdown-gfm) ,支持许多格式。问题历史记录中列出了对 Issue 描述的更改记录。 ### 提及[](#mentions "Permalink") @@ -117,11 +117,11 @@ Issue 从状态(打开或关闭)开始,然后是作者,并包括许多 ### 相关的合并请求[](#related-merge-requests "Permalink") -该 Issue 的描述或 Issue 讨论中提到的[合并请求](/docs/user/project/issues/crosslinking.md#from-merge-requests)在此处列为[相关合并请求](/docs/user/project/issues/crosslinking.md#from-merge-requests) ,另外,如果当前 Issue 在另一个合并请求中被提及,则该合并请求也将在此处列出。 +该 Issue 的描述或 Issue 讨论中提到的[合并请求](/docs/user/project/issues/crosslinking#from-merge-requests)在此处列为[相关合并请求](/docs/user/project/issues/crosslinking#from-merge-requests) ,另外,如果当前 Issue 在另一个合并请求中被提及,则该合并请求也将在此处列出。 ### 点赞[](#award-emoji "Permalink") -您可以为该 Issue 点赞, 有"顶"和"踩"两种快捷方式,或者您可以单击浅灰色的"笑脸"图标并从可用的[Markdown Emoji](/docs/user/markdown.md#emoji)下拉列表中选择其他表情。 +您可以为该 Issue 点赞, 有"顶"和"踩"两种快捷方式,或者您可以单击浅灰色的"笑脸"图标并从可用的[Markdown Emoji](/docs/user/markdown#emoji)下拉列表中选择其他表情。 **提示:在讨论中**发布"+1"作为评论会对该 Issue 的所有参与/订阅者造成垃圾邮件,也会使讨论内容显得混乱,因此不建议这样做.。给 Issue 点赞是一种让他们知道您的反应而不会发送垃圾邮件的方法,我们更建议您使用这种方式。 @@ -141,7 +141,7 @@ Issue 从状态(打开或关闭)开始,然后是作者,并包括许多 通过一个操作同时完成创建一个新的分支和**草稿**合并请求, 默认情况下,该分支将被命名为`issuenumber-title` ,但是您可以选择任何名称,并且系统会验证该分支是否已经被使用。创建的合并请求将自动继承 Issue 的里程碑和标签,并设置为在合并时自动关闭 Issue 。 -(可选)您可以选择仅创建一个[新分支](/docs/user/project/repo/web-editor.md#create-a-new-branch-from-an-issue) ,并以该 Issue 命名。 +(可选)您可以选择仅创建一个[新分支](/docs/user/project/repo/web-editor#create-a-new-branch-from-an-issue) ,并以该 Issue 命名。 ### Issue 历史记录[](#issue-history "Permalink") diff --git a/docs/user/project/issues/crosslinking.md b/docs/user/project/issues/crosslinking.md index acdb381..59caadb 100644 --- a/docs/user/project/issues/crosslinking.md +++ b/docs/user/project/issues/crosslinking.md @@ -32,4 +32,4 @@ git commit -m "this is my commit message. Related to https://codechina.csdn.net/ 在合并请求中提及 Issue 与在 Issue 中关联是一样的步骤。 -当您在合并请求说明中提到 Issue 时,它就会[将 Issue 和合并请求链接在一起](#from-related-issues)。此外,您还可以[将 Issue 设置](/docs/user/project/issues/manage.md#closing-issues-automatically)为在合并请求合并后立即[自动关闭](/docs/user/project/issues/manage.md#closing-issues-automatically) 。 \ No newline at end of file +当您在合并请求说明中提到 Issue 时,它就会[将 Issue 和合并请求链接在一起](#from-related-issues)。此外,您还可以[将 Issue 设置](/docs/user/project/issues/manage#closing-issues-automatically)为在合并请求合并后立即[自动关闭](/docs/user/project/issues/manage#closing-issues-automatically) 。 \ No newline at end of file diff --git a/docs/user/project/issues/due-date.md b/docs/user/project/issues/due-date.md index e1af1ec..b4cac22 100644 --- a/docs/user/project/issues/due-date.md +++ b/docs/user/project/issues/due-date.md @@ -8,7 +8,7 @@ 您还可以通过 Issue 侧边栏设置截止日期。在 Issue 详情页的右侧找到**截止日期**,然后单击**编辑**以选择截止日期或删除现有的日期,您所作的更改将立即保存。 -设置截止日期的最后一种方法是直接在 Issue 的描述或评论中使用[快速操作](/docs/user/project/quick-actions.md) : +设置截止日期的最后一种方法是直接在 Issue 的描述或评论中使用[快速操作](/docs/user/project/quick-actions) : * `/due ` :设置到期日, 有效的``示例包括`in 2 days` 、`this Friday`和`December 31st` * `/remove_due_date` :删除到期日 @@ -17,7 +17,7 @@ 设置了截止日期的 Issue 可以在 Issue 跟踪器中轻松查看到,并在它们旁边显示了截止日期,日期过期的 Issue 会将图标和日期显示为红色。您可以从右侧的下拉菜单中按截止日期倒叙/顺序对 Issue 进行排序。 -截止日期也会出现在您的[待办事项清单中](/docs/user/todo.md) . +截止日期也会出现在您的[待办事项清单中](/docs/user/todo) . 未解决 Issue 在截止日期的前一天,系统将向该 Issue 的所有参与者发送电子邮件,与截止日期一样,"截止日期前的一天"由服务器的时区来确定。 diff --git a/docs/user/project/issues/manage.md b/docs/user/project/issues/manage.md index 90dcc9a..cb4d08f 100644 --- a/docs/user/project/issues/manage.md +++ b/docs/user/project/issues/manage.md @@ -4,7 +4,7 @@ Issue 是通过想法和计划进行协工作的基本要素。 [创建](#create ## 创建 Issue[](#create-a-new-issue "Permalink") -创建新 Issue 时,系统将提示您填写 Issue 的数据和字段,如下所示。如果您清楚要分配给Issue 的值,则可以使用" [快速操作"](/docs/user/project/quick-actions.md)功能输入相应的内容,而不用从列表中选择它们。 +创建新 Issue 时,系统将提示您填写 Issue 的数据和字段,如下所示。如果您清楚要分配给Issue 的值,则可以使用" [快速操作"](/docs/user/project/quick-actions)功能输入相应的内容,而不用从列表中选择它们。 ### 获取新建 Issue 的表单[](#accessing-the-new-issue-form "Permalink") @@ -47,7 +47,7 @@ Issue 是通过想法和计划进行协工作的基本要素。 [创建](#create 当提交或合并请求解决了一个或多个 Issue 时,在将提交或合并请求推送到项目的默认分支时将会自动关闭这些 Issue。 -如果提交消息或合并请求描述包含与[定义的模式](#default-closing-pattern)相匹配的文本,则匹配文本中引用的所有 Issue 均将被关闭。将提交推送到项目的[**默认**分支时](/docs/user/project/repo/branches.md#default-branch) ,或者将提交或合并请求合并到默认分支时,Issue 就会自动关闭。 +如果提交消息或合并请求描述包含与[定义的模式](#default-closing-pattern)相匹配的文本,则匹配文本中引用的所有 Issue 均将被关闭。将提交推送到项目的[**默认**分支时](/docs/user/project/repo/branches#default-branch) ,或者将提交或合并请求合并到默认分支时,Issue 就会自动关闭。 例如,如果合并请求描述中包含`Closes #4, #6, Related to #5`,则合并合并请求时问题`#4`和`#6`将自动关闭,但不会合并`#5`,只会将其标记为相关 Issue ,但不会自动关闭。 @@ -90,10 +90,10 @@ and https://codechina.csdn.net/group/otherproject/issues/23. #### 禁用自动关闭 Issue[](#disabling-automatic-issue-closing "Permalink") -可以在[项目的设置中](/docs/user/project/settings.md)禁用项目的自动关闭 Issue 功能。引用的问题仍将按原样显示,但不会自动关闭。 +可以在[项目的设置中](/docs/user/project/settings)禁用项目的自动关闭 Issue 功能。引用的问题仍将按原样显示,但不会自动关闭。 这仅影响被新合并请求或提交关联的 Issue,已经解决的 Issue 仍然保持原样,禁用自动关闭 Issue 的设置仅影响当前项目中的合并请求,并不会阻止其他项目从通过跨项目的 Issue将其关闭。 ## 删除 Issue[](#deleting-issues "Permalink") -具有项目 [Owner](/docs/user/permissions.md) 权限的用户可以通过编辑 Issue 并单击删除按钮来删除 Issue。 +具有项目 [Owner](/docs/user/permissions) 权限的用户可以通过编辑 Issue 并单击删除按钮来删除 Issue。 diff --git a/docs/user/project/issues/sort.md b/docs/user/project/issues/sort.md index ced88b7..416613f 100644 --- a/docs/user/project/issues/sort.md +++ b/docs/user/project/issues/sort.md @@ -1,6 +1,6 @@ # Issue 排序[](#Issue排序 "Permalink") -您可以通过多种方式对 Issue 列表进行排序,包括按 Issue 创建日期、里程碑、截止日期等进行排序。可用的排序选项可以根据列表的上下文进行更改。有关按发布优先级排序的信息,请参见[标签优先级](/docs/user/project/label.md#label-priority)。 +您可以通过多种方式对 Issue 列表进行排序,包括按 Issue 创建日期、里程碑、截止日期等进行排序。可用的排序选项可以根据列表的上下文进行更改。有关按发布优先级排序的信息,请参见[标签优先级](/docs/user/project/label#label-priority)。 在项目的 Issue 列表清单中,也可以手动对 Issue 进行排序,类似于看板中的手动排序。 diff --git a/docs/user/project/kanban.md b/docs/user/project/kanban.md index 05c144d..bd302de 100644 --- a/docs/user/project/kanban.md +++ b/docs/user/project/kanban.md @@ -20,7 +20,7 @@ ## 工作方式[](#how-it-works "Permalink") -看板功能通过将 CODEChina 现有的[发行跟踪功能](/docs/user/project/issues.md#issues-list)和[标签](/docs/user/project/label.md)用作 Scrum 板的列表而建立。 +看板功能通过将 CODEChina 现有的[发行跟踪功能](/docs/user/project/issues#issues-list)和[标签](/docs/user/project/label)用作 Scrum 板的列表而建立。 使用看板,您可以对 Issue 有不同的看法,同时保持在问题跟踪器中看到的相同过滤和排序功能。看板基于其项目的标签结构,因此它使用相同的描述性标签来指示在板上的位置,从而在整个开发生命周期中保持一致性。 @@ -105,7 +105,7 @@ ## 权限[](#permissions "Permalink") -具有[报告者和更高角色的](/docs/user/permissions.md)用户可以使用看板的所有功能来创建或删除列表,并将问题从一个列表拖动到另一个列表。 +具有[报告者和更高角色的](/docs/user/permissions)用户可以使用看板的所有功能来创建或删除列表,并将问题从一个列表拖动到另一个列表。 ### 多看板[](#multiple-issue-boards "Permalink") @@ -204,7 +204,7 @@ 使用看板的典型工作流程为: -1. 您已经[创建了](/docs/user/project/label.md#label-management)标签并对其进行了[优先排序](/docs/user/project/label.md#label-priority)以便可以轻松地对问题进行分类 +1. 您已经[创建了](/docs/user/project/label#label-management)标签并对其进行了[优先排序](/docs/user/project/label#label-priority)以便可以轻松地对问题进行分类 2. 您遇到很多问题(理想情况下是带有标签的) 3. 您访问看板并开始[创建列表](#create-a-new-list)以创建工作流程 4. 您可以在列表中四处移动问题,以便您的团队知道谁应该处理什么问题 @@ -243,13 +243,13 @@ 访问看板时,问题在任何列表中都显示为有序。您可以通过拖放问题来更改顺序,更改后的顺序将保存到系统中,以便以后访问同一板的任何人都可以看到新的排序结果,但也有一些例外: -给定问题首次出现在任何面板中(即用户首次加载包含该问题的面板)时,将根据[优先级顺序](/docs/user/project/label.md#label-priority)对该列表中的其他问题进行[排序](/docs/user/project/label.md#label-priority) 。 +给定问题首次出现在任何面板中(即用户首次加载包含该问题的面板)时,将根据[优先级顺序](/docs/user/project/label#label-priority)对该列表中的其他问题进行[排序](/docs/user/project/label#label-priority) 。 此时,系统会为该问题分配一个相对顺序值,该值代表其相对于列表中其他问题的相对顺序,每当您拖放该问题的重新排序时,其相对顺序值都会相应更改。 同样,当问题由用户加载时,在任何板上出现的任何时间,都会使用更新的相对顺序进行排序(这是第一次出现从上述优先顺序中提取问题的问题)。这意味着,如果您给定板上的任何用户将问题`A`拖放到问题`B`上方的顺序进行了重新排序,每当随后将这两个问题加载到任何板(例如,可以是不同的项目板或不同的组板)中时,都将维持该排序。 -此顺序还会影响[问题列表](/docs/user/project/issues/sort.md) ,在看板上更改排序会更改发行列表中的顺序,反之亦然。 +此顺序还会影响[问题列表](/docs/user/project/issues/sort) ,在看板上更改排序会更改发行列表中的顺序,反之亦然。 ## Tips[](#tips "Permalink") diff --git a/docs/user/project/label.md b/docs/user/project/label.md index ca1efc4..a377729 100644 --- a/docs/user/project/label.md +++ b/docs/user/project/label.md @@ -4,11 +4,11 @@ 随着Issue、合并请求和Epic数量的增长,跟踪这些项目将变得越来越困难,尤其是随着您的组织从只有几个人发展到成百上千人后。这里就出现了标记,它们可以帮助您组织和标记工作,以便您可以跟踪和找到您感兴趣的工作项。 -标记是[看板](/docs/user/project/kanban.md)的关键部分,通过使用标记,您可以: +标记是[看板](/docs/user/project/kanban)的关键部分,通过使用标记,您可以: * 使用颜色和描述性标题(例如`bug` , `feature request`或`docs`对 Epic,Issue 及合并请求进行分类 * 动态过滤和管理 Epic、 Issue 及合并请求 -* [搜索 Issue 列表、合并请求和史诗](/docs/user/search.md#issues-and-merge-requests)以及[看板](/docs/user/search.md#issue-boards) +* [搜索 Issue 列表、合并请求和史诗](/docs/user/search#issues-and-merge-requests)以及[看板](/docs/user/search#issue-boards) ## 项目标记和组织标记[](#project-labels-and-group-labels "Permalink") @@ -29,7 +29,7 @@ * 通过输入搜索查询并单击搜索来查找标记,然后点击它们,您可以反复搜索并添加更多标记 2. 单击**X**或标记部分之外的任何位置,然后将应用标记 -您也可以使用[`/assign @username`快速操作](/docs/user/project/quick-actions.md)来分配标记。 +您也可以使用[`/assign @username`快速操作](/docs/user/project/quick-actions)来分配标记。 ## Label management[](#label-management "Permalink") @@ -119,7 +119,7 @@ 如果您按`Priority`排序,则将使用以下排序顺序: -1. 具有里程碑的截止日期的项目,最早分配的[里程碑](/docs/user/project/milestone.md)在此列出 +1. 具有里程碑的截止日期的项目,最早分配的[里程碑](/docs/user/project/milestone)在此列出 2. 具有里程碑的项目,没有截止日期 3. 具有较高优先级标记的项目 4. 没有优先标记的项目 diff --git a/docs/user/project/member.md b/docs/user/project/member.md index 24d2089..790e590 100644 --- a/docs/user/project/member.md +++ b/docs/user/project/member.md @@ -2,7 +2,7 @@ 您可以在所有项目中管理组和用户及其访问级别,您还可以个性化为每个项目赋予每个用户的访问级别。 -您应该具有 Maintainer 或 Owner[权限](/docs/user/permissions.md),才能将新用户添加或导入到项目中。 +您应该具有 Maintainer 或 Owner[权限](/docs/user/permissions),才能将新用户添加或导入到项目中。 要查看,编辑,添加和删除项目的成员,请转到项目的**项目设置>项目成员设置** 。 @@ -32,7 +32,7 @@ [![Search for people](/docs/img/add_user_search_people.png)](/docs/img/add_user_search_people.png) -选择用户以及您要赋予该用户的[权限级别](/docs/user/permissions.md),您可以选择多个用户。 +选择用户以及您要赋予该用户的[权限级别](/docs/user/permissions),您可以选择多个用户。 [![Give user permissions](/docs/img/add_user_give_permissions.png)](/docs/img/add_user_give_permissions.png) @@ -72,11 +72,11 @@ CODEChina 用户可以请求成为项目成员,进入到您要加入的项目 ## 与组共享项目[](#share-project-with-group "Permalink") -此外,您可以[与整个组共享一个项目](/docs/user/project/member/share.md),而不需要一个一个地添加用户。 +此外,您可以[与整个组共享一个项目](/docs/user/project/member/share),而不需要一个一个地添加用户。 ## 从项目中删除成员[](#remove-a-member-from-the-project "Permalink") -只有[Owner](/docs/user/permissions.md#group-members-permissions)权限的[用户](/docs/user/permissions.md#group-members-permissions)才能管理项目成员。 +只有[Owner](/docs/user/permissions#group-members-permissions)权限的[用户](/docs/user/permissions#group-members-permissions)才能管理项目成员。 如果要删除的成员在项目中具有直接成员资格,则可以从项目中删除用户;如果成员资格是从父组继承的,则该成员只能从父组本身中删除。 diff --git a/docs/user/project/member/share.md b/docs/user/project/member/share.md index a93416a..d372950 100644 --- a/docs/user/project/member/share.md +++ b/docs/user/project/member/share.md @@ -35,4 +35,4 @@ 可以禁用与组织共享项目以防止一个组织中的项目与另一个组共享一个项目。 -了解更多有关[使用组锁共享的信息](/docs/user/org.md#锁定与组织共享功能) \ No newline at end of file +了解更多有关[使用组锁共享的信息](/docs/user/org#锁定与组织共享功能) \ No newline at end of file diff --git a/docs/user/project/merge-request.md b/docs/user/project/merge-request.md index 70e56a9..feb849c 100644 --- a/docs/user/project/merge-request.md +++ b/docs/user/project/merge-request.md @@ -28,8 +28,8 @@ 3. 您的更改将通过 Review Apps 进行预览 4. 您要求您的网页设计师实施 5. 您要求您的经理批准 -6. 一旦批准,您的合并请求将被[squash](/docs/user/project/merge-request/squash.md) ,并[部署到暂存中](https://about.gitlab.com/blog/2016/08/26/ci-deployment-and-environments/) -7. 您的生产团队[cherry-pick](/docs/user/project/merge-request/cherry-pick.md)合并提交到生产中 +6. 一旦批准,您的合并请求将被[squash](/docs/user/project/merge-request/squash) ,并[部署到暂存中](https://about.gitlab.com/blog/2016/08/26/ci-deployment-and-environments/) +7. 您的生产团队[cherry-pick](/docs/user/project/merge-request/cherry-pick)合并提交到生产中 ## 概览[](#overview "Permalink") @@ -45,7 +45,7 @@ MR 还包含导航选项卡,从中可以查看线程上正在进行的讨论 ## 新建合并请求[](#creating-merge-requests "Permalink") -点击了解 [如何创建一个新的合并请求](/docs/user/project/merge-request/create-merge-request.md) +点击了解 [如何创建一个新的合并请求](/docs/user/project/merge-request/create-merge-request) ## 管理和查看合并请求[](#reviewing-and-managing-merge-requests "Permalink") @@ -59,5 +59,5 @@ MR 还包含导航选项卡,从中可以查看线程上正在进行的讨论 使用 CODEChina 进行合并请求的主要方法有两种: -1. 在单个存储库中使用[受保护的分支](/docs/user/project/protected-branch.md) +1. 在单个存储库中使用[受保护的分支](/docs/user/project/protected-branch) 2. 使用权威项目的分支 \ No newline at end of file diff --git a/docs/user/project/merge-request/create-merge-request.md b/docs/user/project/merge-request/create-merge-request.md index 31bf4ba..11511d8 100644 --- a/docs/user/project/merge-request/create-merge-request.md +++ b/docs/user/project/merge-request/create-merge-request.md @@ -74,7 +74,7 @@ git commit -m "My commit message" git push origin my-new-branch ``` -在输出中,GitLab 将提示您一个直接链接来创建合并请求: +在输出中,CODEChina 将提示您一个直接链接来创建合并请求: ```markdown ... @@ -90,7 +90,7 @@ remote: https://codechina.csdn.net/my-group/my-project/merge_requests/new?merg ## 从 Issue 新建合并请求[](#new-merge-request-from-an-issue "Permalink") -您也可以[直接从 issue 创建一个新的合并请求](/docs/user/project/repo/web-editor.md#create-a-new-branch-from-an-issue) 。 +您也可以[直接从 issue 创建一个新的合并请求](/docs/user/project/repo/web-editor#create-a-new-branch-from-an-issue) 。 ## 从合并请求列表页新建合并请求[](#new-merge-request-from-the-merge-requests-page "Permalink") @@ -107,7 +107,7 @@ Fork 项目在本地更改后,可以通过以下步骤从 fork 创建一个合 5. 输入凭据后,单击" **比较分支",然后继续**将本地更改与上游存储库进行比较 6. 分配用户以查看您的更改,然后点击**提交合并请求** -合并更改后,您的更改将按照规范添加到上游存储库和分支中. 合并工作后,如果您不想对上游项目做出任何其他贡献,则可以通过[删除分支关系](/docs/user/project/settings.md#removing-a-fork-relationship) ,在**项目设置> 高级设置**部分[中将 fork 与](/docs/user/project/settings.md#removing-a-fork-relationship)上游项目断开链接。 +合并更改后,您的更改将按照规范添加到上游存储库和分支中. 合并工作后,如果您不想对上游项目做出任何其他贡献,则可以通过[删除分支关系](/docs/user/project/settings#removing-a-fork-relationship) ,在**项目设置> 高级设置**部分[中将 fork 与](/docs/user/project/settings#removing-a-fork-relationship)上游项目断开链接。 ### 将补丁添加为电子邮件附件[](#adding-patches-when-creating-a-merge-request-via-e-mail "Permalink") @@ -115,8 +115,8 @@ Fork 项目在本地更改后,可以通过以下步骤从 fork 创建一个合 补丁的总大小不超过 2MB。 -如果主题的源分支不存在,那么将从存储库的 HEAD 或指定的目标分支创建源分支以应用补丁。可以使用[`/target_branch`快速操作](/docs/user/project/quick-actions.md)指定目标分支。如果源分支已经存在,则将在其顶部应用补丁。 +如果主题的源分支不存在,那么将从存储库的 HEAD 或指定的目标分支创建源分支以应用补丁。可以使用[`/target_branch`快速操作](/docs/user/project/quick-actions)指定目标分支。如果源分支已经存在,则将在其顶部应用补丁。 ## 审查和管理合并请求[](#reviewing-and-managing-merge-requests "Permalink") -提交合并请求后,可以通过 CODEChina 进行[审查和管理](/docs/user/project/merge-request/reviewing.md)。 \ No newline at end of file +提交合并请求后,可以通过 CODEChina 进行[审查和管理](/docs/user/project/merge-request/reviewing)。 \ No newline at end of file diff --git a/docs/user/project/merge-request/draft.md b/docs/user/project/merge-request/draft.md index 4a47072..1490e76 100644 --- a/docs/user/project/merge-request/draft.md +++ b/docs/user/project/merge-request/draft.md @@ -10,7 +10,7 @@ * 将`[Draft]` , `Draft:`或`(Draft)`到合并请求标题的开头,单击标题框下的" **以草稿开始标题:** ",在编辑合并请求的描述时将具有相同的效果 * **不推荐使用**将`[WIP]`或`WIP:`添加到合并请求标题的开头,**WIP**仍然有效,但我们推荐使用**Draft** -* 在合并请求的讨论中添加`/wip` [快速操作](/docs/user/project/quick-actions.md#quick-actions-for-issues-merge-requests-and-epics)注释 ,可以重复进行并切换合并请求的状态。请注意,注释中的任何其他文本都将被丢弃 +* 在合并请求的讨论中添加`/wip` [快速操作](/docs/user/project/quick-actions#quick-actions-for-issues-merge-requests-and-epics)注释 ,可以重复进行并切换合并请求的状态。请注意,注释中的任何其他文本都将被丢弃 * 将`draft:`或`Draft:`添加到针对合并请求的源分支的提交消息的开头,这不会切换合并请求的状态,并且在另一次提交中再次执行将无效 ## 移除合并请求中的 Draft/WIP 标记[](#removing-the-draft-flag-from-a-merge-request "Permalink") @@ -18,7 +18,7 @@ 与上述类似,当准备合并请求时,可以通过以下几种方式移除" `Draft`标记: * 从合并请求标题的开头删除`[Draft]` , `Draft:`或`(Draft)` ,在编辑合并请求的描述时,在标题框下单击**从标题中删除草稿:前缀** ,将具有相同的效果 -* 在合并请求的讨论中添加`/wip` [快速操作](/docs/user/project/quick-actions.md#quick-actions-for-issues-merge-requests-and-epics) 注释,可以重复进行并切换合并请求的状态。请注意,注释中的任何其他文本都将被丢弃 +* 在合并请求的讨论中添加`/wip` [快速操作](/docs/user/project/quick-actions#quick-actions-for-issues-merge-requests-and-epics) 注释,可以重复进行并切换合并请求的状态。请注意,注释中的任何其他文本都将被丢弃 * 点击靠近合并请求描述底部的*移除 WIP 状态**按钮,该按钮对至少具有 Developer 权限的用户才可见 ## 通过 WIP 过滤合并请求[](#includingexcluding-wip-merge-requests-when-searching "Permalink") diff --git a/docs/user/project/merge-request/reviewing.md b/docs/user/project/merge-request/reviewing.md index 43893fa..0e1e7ca 100644 --- a/docs/user/project/merge-request/reviewing.md +++ b/docs/user/project/merge-request/reviewing.md @@ -1,10 +1,10 @@ # 评审及管理合并请求[](#评审及管理合并请求 "Permalink") -合并请求是在项目中更改文件的主要方法,通过[创建并提交合并请求](/docs/user/project/merge-request/create-merge-request.md)来提出更改,然后将其审核并接受(或拒绝)。 +合并请求是在项目中更改文件的主要方法,通过[创建并提交合并请求](/docs/user/project/merge-request/create-merge-request)来提出更改,然后将其审核并接受(或拒绝)。 ## 评审合并请求[](#view-project-merge-requests "Permalink") -打开 **项目>合并请求**列表,可以查看项目中的所有**合并请求**,并且您可以快速按打开和关闭可用的选项卡来进行过滤,您还可以[搜索和过滤结果](/docs/user/search.md#filtering-issue-and-merge-request-lists)。 +打开 **项目>合并请求**列表,可以查看项目中的所有**合并请求**,并且您可以快速按打开和关闭可用的选项卡来进行过滤,您还可以[搜索和过滤结果](/docs/user/search#filtering-issue-and-merge-request-lists)。 [![Project merge requests list view](/docs/img/project_merge_requests_list_view.png)](/docs/img/project_merge_requests_list_view.png) @@ -73,12 +73,12 @@ Diff 视图包含以下内容: | 功能 | 描述 | | --- | --- | -| [批量编辑合并请求](/docs/user/project/bulk-edit.md) | 同时更新多个合并请求的属性 | -| [Cherry-pick 变更](/docs/user/project/merge-request/cherry-pick.md) | 只需在合并的合并请求或提交中单击**Cherry-pick**按钮,即可在页面中 Cherry-pick 任何**选择** | -| [快进合并](/docs/user/project/merge-request/fast-forward.md) | 有关线性 Git 历史记录以及接受合并请求而不创建合并提交的方法 | -| [合并请求版本](/docs/user/project/merge-request/versions.md) | 选择并比较合并请求差异的不同版本 | -| [解决冲突](/docs/user/project/merge-request/resolve-conflicts.md) |可以在界面中来解决某些合并请求冲突 | -| [Revert 更改](/docs/user/project/merge-request/revert.md) | 从合并请求中的任何提交还原更改 | +| [批量编辑合并请求](/docs/user/project/bulk-edit) | 同时更新多个合并请求的属性 | +| [Cherry-pick 变更](/docs/user/project/merge-request/cherry-pick) | 只需在合并的合并请求或提交中单击**Cherry-pick**按钮,即可在页面中 Cherry-pick 任何**选择** | +| [快进合并](/docs/user/project/merge-request/fast-forward) | 有关线性 Git 历史记录以及接受合并请求而不创建合并提交的方法 | +| [合并请求版本](/docs/user/project/merge-request/versions) | 选择并比较合并请求差异的不同版本 | +| [解决冲突](/docs/user/project/merge-request/resolve-conflicts) |可以在界面中来解决某些合并请求冲突 | +| [Revert 更改](/docs/user/project/merge-request/revert) | 从合并请求中的任何提交还原更改 | ## Tips[](#tips "Permalink") diff --git a/docs/user/project/merge-request/squash.md b/docs/user/project/merge-request/squash.md index 813ce76..7e126b2 100644 --- a/docs/user/project/merge-request/squash.md +++ b/docs/user/project/merge-request/squash.md @@ -35,7 +35,7 @@ Squash 也适用于快进合并策略,有关更多详细信息,请参见[压 这样,您的基本分支的历史记录将保留有意义的提交消息,并且: -* 在有需要的情况下, [Revert](revert.md)更为简单 +* 在有需要的情况下, [Revert](revert)更为简单 * 合并的分支将保留完整的提交历史记录 ## 合并时启用 Squash[](#enabling-squash-for-a-merge-request "Permalink") @@ -58,4 +58,4 @@ Squash 的提交具有以下元数据: ## Squash 和快进合并[](#squash-and-fast-forward-merge "Permalink") -当项目[启用](fast_forward.md#enabling-fast-forward-merges)了[快进合并设置时](fast_forward.md#enabling-fast-forward-merges) ,合并请求必须能够不 Squash 而进行快速转发以进行 Squash,这是因为 Squash 仅在接受合并请求时可用,因此即使 Squash 本身可以被认为等同于重新 Rebase,也可能需要在 Squash 之前对合并请求进行重新基准化。 \ No newline at end of file +当项目[启用](fast_forward#enabling-fast-forward-merges)了[快进合并设置时](fast_forward#enabling-fast-forward-merges) ,合并请求必须能够不 Squash 而进行快速转发以进行 Squash,这是因为 Squash 仅在接受合并请求时可用,因此即使 Squash 本身可以被认为等同于重新 Rebase,也可能需要在 Squash 之前对合并请求进行重新基准化。 \ No newline at end of file diff --git a/docs/user/project/milestone.md b/docs/user/project/milestone.md index 45169e1..70c20f0 100644 --- a/docs/user/project/milestone.md +++ b/docs/user/project/milestone.md @@ -22,7 +22,7 @@ CODEChina 中的里程碑是一种跟踪 Issue 及合并请求并在一定时期 2. 将里程碑标题设置为您的发行版,例如`Version 9.4` 3. 通过关联问题右侧的期望里程碑,将问题添加到您的发行中 -此外,您可以将里程碑与 CODEChina 的[Releases 功能](/docs/user/project/releases.md#associate-milestones-with-a-release)集成. +此外,您可以将里程碑与 CODEChina 的[Releases 功能](/docs/user/project/releases#associate-milestones-with-a-release)集成. ## 项目里程碑和组织里程碑[](#project-milestones-and-group-milestones "Permalink") @@ -32,7 +32,7 @@ CODEChina 中的里程碑是一种跟踪 Issue 及合并请求并在一定时期 ## 新建里程碑[](#creating-milestones "Permalink") -**注意:**创建里程碑需要[ Developer 或更高](/docs/user/permissions.md)级别的权限。 +**注意:**创建里程碑需要[ Developer 或更高](/docs/user/permissions)级别的权限。 ### 新建项目里程碑[](#new-project-milestone "Permalink") @@ -54,7 +54,7 @@ CODEChina 中的里程碑是一种跟踪 Issue 及合并请求并在一定时期 ## 编辑里程碑[](#editing-milestones "Permalink") -**注意:**编辑里程碑需要[ Developer 或更高的](/docs/user/permissions.md)权限级别。 +**注意:**编辑里程碑需要[ Developer 或更高的](/docs/user/permissions)权限级别。 可以通过以下步骤编辑里程碑: @@ -74,17 +74,17 @@ CODEChina 中的里程碑是一种跟踪 Issue 及合并请求并在一定时期 ## 设置里程碑[](#assigning-milestones-from-the-sidebar "Permalink") -可以为每个 Issue 及合并请求分配一个里程碑,里程碑在边栏中的每个 Issue 及合并请求页面上可见,它们在看板上也可见。您可以在页面右侧为对象分配或取消里程碑。您也可以在讨论中[快速](/docs/user/project/quick-actions.md)执行此操作。 [如前所述](#project-milestones-and-group-milestones) ,对于给定的发布或合并请求,可以选择项目里程碑和组里程碑并将其分配给对象。 +可以为每个 Issue 及合并请求分配一个里程碑,里程碑在边栏中的每个 Issue 及合并请求页面上可见,它们在看板上也可见。您可以在页面右侧为对象分配或取消里程碑。您也可以在讨论中[快速](/docs/user/project/quick-actions)执行此操作。 [如前所述](#project-milestones-and-group-milestones) ,对于给定的发布或合并请求,可以选择项目里程碑和组里程碑并将其分配给对象。 ## 按里程碑过滤 Issue 及合并请求[](#filtering-issues-and-merge-requests-by-milestone "Permalink") ### 在列表页过滤[](#filtering-in-list-pages "Permalink") -在项目 Issue、合并请求列表页面和用户的 Issue 及合并请求列表页面中,可以按组里程碑和项目里程碑进行[筛选](/docs/user/search.md#issues-and-merge-requests) . +在项目 Issue、合并请求列表页面和用户的 Issue 及合并请求列表页面中,可以按组里程碑和项目里程碑进行[筛选](/docs/user/search#issues-and-merge-requests) . ### 在看板上过滤[](#filtering-in-issue-boards "Permalink") -* 在[项目看板上](/docs/user/project/kanban.md) ,您可以在[搜索和过滤器栏中](/docs/user/search.md#issue-boards)按组里程碑和项目里程碑进行[筛选](/docs/user/search.md#issue-boards) +* 在[项目看板上](/docs/user/project/kanban) ,您可以在[搜索和过滤器栏中](/docs/user/search#issue-boards)按组里程碑和项目里程碑进行[筛选](/docs/user/search#issue-boards) ### 特殊里程碑过滤[](#special-milestone-filters "Permalink") diff --git a/docs/user/project/protected-branch.md b/docs/user/project/protected-branch.md index 339667b..4404f07 100644 --- a/docs/user/project/protected-branch.md +++ b/docs/user/project/protected-branch.md @@ -1,6 +1,6 @@ # 保护分支[](#protected-branch "Permalink") -[权限](/docs/user/permissions.md)基本上是围绕对代码仓库和分支具有读或写权限的想法定义的,为了对某些分支机加进一步的限制,可以对其进行保护。 +[权限](/docs/user/permissions)基本上是围绕对代码仓库和分支具有读或写权限的想法定义的,为了对某些分支机加进一步的限制,可以对其进行保护。 ## 概览[](#overview "Permalink") @@ -48,7 +48,7 @@ ## 新建保护分支[](#creating-a-protected-branch "Permalink") -当受保护的分支或通配符受保护的分支设置为" [**不允许任何人** **推送"时**](#using-the-allowed-to-merge-and-allowed-to-push-settings) ,只要允许 developer(和具有较高[权限级别的](/docs/user/permissions.md)用户)[**合并**](#using-the-allowed-to-merge-and-allowed-to-push-settings) ,就可以创建新的受保护分支。 +当受保护的分支或通配符受保护的分支设置为" [**不允许任何人** **推送"时**](#using-the-allowed-to-merge-and-allowed-to-push-settings) ,只要允许 developer(和具有较高[权限级别的](/docs/user/permissions)用户)[**合并**](#using-the-allowed-to-merge-and-allowed-to-push-settings) ,就可以创建新的受保护分支。 可以通过用户界面创建新分支: @@ -58,7 +58,7 @@ ## 删除保护分支[](#deleting-a-protected-branch "Permalink") -有时可能需要删除或清理受保护的分支,具有[ maintainer ](/docs/user/permissions.md)并具有[ maintainer ](/docs/user/permissions.md)用户可以通过 Web 界面手动删除受保护的分支: +有时可能需要删除或清理受保护的分支,具有[ maintainer ](/docs/user/permissions)并具有[ maintainer ](/docs/user/permissions)用户可以通过 Web 界面手动删除受保护的分支: 1. 打开**代码>分支** 2. 单击您要删除的分支旁边的删除图标 diff --git a/docs/user/project/protected-tag.md b/docs/user/project/protected-tag.md index ba6b233..6813376 100644 --- a/docs/user/project/protected-tag.md +++ b/docs/user/project/protected-tag.md @@ -2,7 +2,7 @@ 受保护的标签可控制谁有权创建标签,并防止创建后意外更新或删除。每个规则都允许您匹配单个标签名称,或使用通配符一次控制多个标签。 -此功能从[受保护的分支](/docs/user/project/protected-branch.md)演变而来。 +此功能从[受保护的分支](/docs/user/project/protected-branch)演变而来。 ## 概览[](#overview "Permalink") diff --git a/docs/user/project/quick-actions.md b/docs/user/project/quick-actions.md index c055f8d..504fbc2 100644 --- a/docs/user/project/quick-actions.md +++ b/docs/user/project/quick-actions.md @@ -52,7 +52,7 @@ ## 自动补全字符[](#autocomplete-characters "Permalink") -许多快速操作都需要一个参数,例如:用户名,里程碑和标签。与从列表中选择项目相比, [自动完成字符](/docs/user/project/autofill.md)可以使输入参数更加容易。 +许多快速操作都需要一个参数,例如:用户名,里程碑和标签。与从列表中选择项目相比, [自动完成字符](/docs/user/project/autofill)可以使输入参数更加容易。 ## 快速操作参数[](#quick-actions-parameters "Permalink") diff --git a/docs/user/project/releases.md b/docs/user/project/releases.md index 1c1f4fd..a1f495b 100644 --- a/docs/user/project/releases.md +++ b/docs/user/project/releases.md @@ -19,7 +19,7 @@ * 转到**项目> 项目简介**,在下方有发行版本信息 * 在项目的概述页面上,如果存在至少一个版本,请单击版本数 * 在公共项目上,此数字对所有用户可见 - * 在私有项目上,具有 Reporter [权限](/docs/user/permissions.md)或更高权限的用户可以看到此数字 + * 在私有项目上,具有 Reporter [权限](/docs/user/permissions)或更高权限的用户可以看到此数字 ## 创建 Release[](#create-a-release "Permalink") @@ -116,7 +116,7 @@ 每个版本都有说明,您可以添加任何您喜欢的文本,但是我们建议您添加一个变更日志来描述发行版本的内容。这可以帮助用户快速扫描您发布的每个版本之间的差异。 -**注意:** [Git 的标记消息](https://git-scm.com/book/en/v2/Git-Basics-Tagging)和发行说明描述无关;说明支持[Markdown](/docs/user/markdown.md) 。 +**注意:** [Git 的标记消息](https://git-scm.com/book/en/v2/Git-Basics-Tagging)和发行说明描述无关;说明支持[Markdown](/docs/user/markdown) 。 ### 发布资产[](#release-assets "Permalink") diff --git a/docs/user/project/repo.md b/docs/user/project/repo.md index 4d06adf..dc3fb4c 100644 --- a/docs/user/project/repo.md +++ b/docs/user/project/repo.md @@ -1,14 +1,14 @@ # 代码仓库[](#repository "Permalink") -[代码仓库](https://git-scm.com/book/en/v2/Git-Basics-Getting-a-Git-Repository)是用于将代码库存储在 CODEChina 中并通过版本控制对其进行更改的存储库。代码仓库是[项目](/docs/user/project.md)的一部分,它具有许多其他功能。 +[代码仓库](https://git-scm.com/book/en/v2/Git-Basics-Getting-a-Git-Repository)是用于将代码库存储在 CODEChina 中并通过版本控制对其进行更改的存储库。代码仓库是[项目](/docs/user/project)的一部分,它具有许多其他功能。 ## 新建一个代码仓库[](#create-a-repository "Permalink") -要创建一个新的代码仓库,您需要做的就是[创建一个新项目](/docs/basic/create-project.md)或 fork 一个现有项目。 +要创建一个新的代码仓库,您需要做的就是[创建一个新项目](/docs/basic/create-project)或 fork 一个现有项目。 创建新项目后,您可以通过界面或通过命令行添加新文件, 要从命令行添加文件,请遵循创建新项目时在屏幕上显示的说明。 -> **重要提示:**出于安全原因,强烈建议您在使用命令行时[通过 SSH 与 CODEChina 连接](/docs/ssh.md) 。 +> **重要提示:**出于安全原因,强烈建议您在使用命令行时[通过 SSH 与 CODEChina 连接](/docs/ssh) 。 ## 文件[](#files "Permalink") @@ -22,17 +22,17 @@ 用户界面允许您执行许多 Git 命令,而无在命令行中执行命令。您可以通过用户界面很容易的实现以下操作: -* [新建文件](/docs/user/project/repo/web-editor.md#create-a-file) -* [上传文件](/docs/user/project/repo/web-editor.md#upload-a-file) -* [文件模板](/docs/user/project/repo/web-editor.md#template-dropdowns) -* [新建目录](/docs/user/project/repo/web-editor.md#create-a-directory) -* [新建合并请求](/docs/user/project/repo/web-editor.md#tips) -* [查找文件](/docs/user/project/repo/file-find.md) -* [blame](/docs/user/project/repo/blame.md)) +* [新建文件](/docs/user/project/repo/web-editor#create-a-file) +* [上传文件](/docs/user/project/repo/web-editor#upload-a-file) +* [文件模板](/docs/user/project/repo/web-editor#template-dropdowns) +* [新建目录](/docs/user/project/repo/web-editor#create-a-directory) +* [新建合并请求](/docs/user/project/repo/web-editor#tips) +* [查找文件](/docs/user/project/repo/file-find) +* [blame](/docs/user/project/repo/blame)) ### 查找文件[](#find-files "Permalink") -使用[文件查找器](/docs/user/project/repo/file-find.md)在代码仓库中搜索文件。 +使用[文件查找器](/docs/user/project/repo/file-find)在代码仓库中搜索文件。 ### 支持的语言标记[](#supported-markup-languages-and-extensions "Permalink") @@ -43,7 +43,7 @@ | 标记语言 | 扩展名 | | --- | --- | | 纯文本 | `txt` | -| [Markdown](/docs/user/markdown.md) | `mdown`, `mkd`, `mkdn`, `md`, `markdown` | +| [Markdown](/docs/user/markdown) | `mdown`, `mkd`, `mkdn`, `md`, `markdown` | | [reStructuredText](https://docutils.sourceforge.io/rst.html) | `rst` | | AsciiDoc | `adoc`, `ad`, `asciidoc` | | [Textile](https://textile-lang.com/) | `textile` | @@ -61,7 +61,7 @@ 有关优先级的一些注意事项: 1. 当`README`文件和`index`文件同时存在时, `README`文件将始终优先 -2. 如果存在多个具有不同扩展名的文件,则按字母顺序排列,但不带扩展名的文件例外,该扩展名始终优先。例如, `README.adoc`将优先于`README.md` ,而`README.rst`将优先于`README` +2. 如果存在多个具有不同扩展名的文件,则按字母顺序排列,但不带扩展名的文件例外,该扩展名始终优先。例如, `README.adoc`将优先于`README` ,而`README.rst`将优先于`README` ### Jupyter Notebook files[](#jupyter-notebook-files "Permalink") @@ -92,17 +92,17 @@ ## 分支[](#branches "Permalink") -有关详细信息,请参见[分支](/docs/user/project/repo/branches.md) 。 +有关详细信息,请参见[分支](/docs/user/project/repo/branches) 。 ## 提交[](#commits "Permalink") [提交更改时](https://git-scm.com/book/en/v2/Git-Basics-Recording-Changes-to-the-Repository) ,您会将这些更改引入分支机构。通过命令行,您可以在提交之前多次提交。 * **提交消息:**提交消息对于标识正在更改的内容以及更重要的原因至关重要. 在 GitLab 中,您可以将关键字添加到提交消息中,以执行以下操作之一: - * **交叉链接问题和合并请求:** [交叉链接](/docs/user/project/issues/crosslinking.md#from-commit-messages)非常适合跟踪工作流程中与之相关的内容. 如果您在提交消息中提到问题或合并请求,它们将显示在各自的线程上 -* ** Cherry-pick 提交:**您可以直接从界面 [cherry-pick](/docs/user/project/merge-request/cherry-pick.md) -* **Revert 提交:**可以将提交从界面[还原](/docs/user/project/merge-request/revert.md#reverting-a-commit)到所选分支 -* **签署提交:**使用 GPG [签署您的提交](/docs/user/project/repo/gpg-sign.md) + * **交叉链接问题和合并请求:** [交叉链接](/docs/user/project/issues/crosslinking#from-commit-messages)非常适合跟踪工作流程中与之相关的内容. 如果您在提交消息中提到问题或合并请求,它们将显示在各自的线程上 +* ** Cherry-pick 提交:**您可以直接从界面 [cherry-pick](/docs/user/project/merge-request/cherry-pick) +* **Revert 提交:**可以将提交从界面[还原](/docs/user/project/merge-request/revert#reverting-a-commit)到所选分支 +* **签署提交:**使用 GPG [签署您的提交](/docs/user/project/repo/gpg-sign) ## 项目和仓库大小[](#project-and-repository-size "Permalink") diff --git a/docs/user/project/repo/blame.md b/docs/user/project/repo/blame.md index 81f42f6..5bce93b 100644 --- a/docs/user/project/repo/blame.md +++ b/docs/user/project/repo/blame.md @@ -20,10 +20,10 @@ ## 与 git 协作[](#associated-git-command "Permalink") -在`git`的命令行中,文件的`blame`则等效命令为`git blame `。例如,如果你想找到`README.md`在本地目录中的文件`blame`有关信息,可以运行以下命令: +在`git`的命令行中,文件的`blame`则等效命令为`git blame `。例如,如果你想找到`README`在本地目录中的文件`blame`有关信息,可以运行以下命令: ```markdown -git blame README.md +git blame README ``` 您将看到类似于以下内容的输出,其中包括 UTC 格式的提交时间: diff --git a/docs/user/project/repo/branches.md b/docs/user/project/repo/branches.md index 911a3ef..d449e38 100644 --- a/docs/user/project/repo/branches.md +++ b/docs/user/project/repo/branches.md @@ -4,9 +4,9 @@ 将更改推送到新分支后,您可以: -* 创建[合并请求](/docs/user/project/merge-request.md) +* 创建[合并请求](/docs/user/project/merge-request) * 执行内联代码审查 -* 与团队[讨论](/docs/user/discussions.md)实施情况 +* 与团队[讨论](/docs/user/discussions)实施情况 有关使用 CODEChina 管理分支的更多信息,请参见: @@ -21,9 +21,9 @@ 创建新项目时 ,系统会将`master`设置为代码仓库的默认分支。您可以在项目的**项目设置>仓库>默认分支**下选择另一个分支作为项目的默认分支。 -通过[ Issue 关闭模式](/docs/user/project/issues/manage.md#closing-issues-automatically)直接从合并请求中[关闭 Issue](/docs/user/project/issues/manage.md#closing-issues-automatically)时,目标是项目的**默认分支** 。 +通过[ Issue 关闭模式](/docs/user/project/issues/manage#closing-issues-automatically)直接从合并请求中[关闭 Issue](/docs/user/project/issues/manage#closing-issues-automatically)时,目标是项目的**默认分支** 。 -项目初始化时还对默认分支进行了[保护](/docs/user/project/protected-branch.md#protected-branches),以防止意外删除和强制推送。 +项目初始化时还对默认分支进行了[保护](/docs/user/project/protected-branch#protected-branches),以防止意外删除和强制推送。 ## 对比[](#compare "Permalink") @@ -40,7 +40,7 @@ [![Delete merged branches](/docs/img/delete_merged_branches.png)](/docs/img/delete_merged_branches.png) -此功能允许合并的分支被批量删除,作为此操作的一部分,只有已合并[但未受保护的](/docs/user/project/protected-branch.md)分支才会被删除。 +此功能允许合并的分支被批量删除,作为此操作的一部分,只有已合并[但未受保护的](/docs/user/project/protected-branch)分支才会被删除。 这在清理那些合并请求时未自动删除的旧分支时非常好用。 diff --git a/docs/user/project/repo/file-find.md b/docs/user/project/repo/file-find.md index 2ddfd4c..4304729 100644 --- a/docs/user/project/repo/file-find.md +++ b/docs/user/project/repo/file-find.md @@ -6,7 +6,7 @@ [![Find file button](/docs/img/file_finder_find_button_v12_10.png)](/docs/img/file_finder_find_button_v12_10.png) -如果您喜欢使用快捷键,我们还支持[键盘快捷键](/docs/user/shortcutkey.md) ,您可以从项目中的*任何地方*调用它。 +如果您喜欢使用快捷键,我们还支持[键盘快捷键](/docs/user/shortcutkey) ,您可以从项目中的*任何地方*调用它。 在** Issue ** , **合并请求** , **里程碑**甚至项目设置中,按`t`键启动文件搜索功能。 diff --git a/docs/user/project/repo/gpg-sign.md b/docs/user/project/repo/gpg-sign.md index 819069f..3e12bed 100644 --- a/docs/user/project/repo/gpg-sign.md +++ b/docs/user/project/repo/gpg-sign.md @@ -173,7 +173,7 @@ git config --global commit.gpgsign true ## 验证提交[](#verifying-commits "Permalink") -1. 在项目或[合并请求](/docs/user/project/merge-request.md)中,切换到" **提交"**选项卡,签名的提交将显示包含" Verified"或" Unverified"的徽章,具体取决于 GPG 签名的验证状态 +1. 在项目或[合并请求](/docs/user/project/merge-request)中,切换到" **提交"**选项卡,签名的提交将显示包含" Verified"或" Unverified"的徽章,具体取决于 GPG 签名的验证状态 [![Signed and unsigned commits](/docs/img/project_signed_and_unsigned_commits.png)](/docs/img/project_signed_and_unsigned_commits.png) @@ -203,4 +203,4 @@ git config --global commit.gpgsign true ## 拒绝未签名的提交[](#rejecting-commits-that-are-not-signed-premium "Permalink") -您可以将您的项目配置为拒绝不是通过[推送规则进行](/docs/user/project/push-rules.md) GPG 签名的提交 +您可以将您的项目配置为拒绝不是通过[推送规则进行](/docs/user/project/push-rules) GPG 签名的提交 diff --git a/docs/user/project/repo/history.md b/docs/user/project/repo/history.md index 5bdb784..3697fad 100644 --- a/docs/user/project/repo/history.md +++ b/docs/user/project/repo/history.md @@ -8,10 +8,10 @@ Git 文件历史记录提供与文件关联的提交历史记录的信息,您 ## 在 git 中使用[](#associated-git-command "Permalink") -如果要从`git`查看文件历史记录,则可以使用`git log `命令。例如,如果要在本地目录中找到有关`README.md`文件的`history`信息,请运行以下命令: +如果要从`git`查看文件历史记录,则可以使用`git log `命令。例如,如果要在本地目录中找到有关`README`文件的`history`信息,请运行以下命令: ```markdown -git log README.md +git log README ``` 您将看到类似于以下内容的输出,其中包括 UTC 格式的提交时间: diff --git a/docs/user/project/repo/reduce-repo-size.md b/docs/user/project/repo/reduce-repo-size.md index 593b04f..8e6fdb0 100644 --- a/docs/user/project/repo/reduce-repo-size.md +++ b/docs/user/project/repo/reduce-repo-size.md @@ -11,13 +11,13 @@ * [`git filter-branch`](https://git-scm.com/docs/git-filter-branch). * [BFG](https://rtyley.github.io/bfg-repo-cleaner/). -**危险:**重写代码仓库历史记录是一种破坏性操作,在开始之前,请确保备份您的代码仓库。备份存储库的最佳方法是[导出项目](/docs/user/project/import.md#exporting-a-project-and-its-data) 。 +**危险:**重写代码仓库历史记录是一种破坏性操作,在开始之前,请确保备份您的代码仓库。备份存储库的最佳方法是[导出项目](/docs/user/project/import#exporting-a-project-and-its-data) 。 ## 在从代码仓库历史记录中净化文件[](#purge-files-from-repository-history "Permalink") 为了使克隆项目更快,建议重写分支和标签以删除不需要的文件。 -1. 使用受支持的程序包管理器或从源代码[安装`git filter-repo`](https://github.com/newren/git-filter-repo/blob/main/INSTALL.md) +1. 使用受支持的程序包管理器或从源代码[安装`git filter-repo`](https://github.com/newren/git-filter-repo/blob/main/INSTALL) 2. 使用`--bare`克隆代码仓库的新副本: @@ -63,7 +63,7 @@ git push origin --force --all ``` - [受保护的分支](/docs/user/project/protected-branch.md)将导致此操作失败。要继续的话,您必须删除分支保护,推送,然后重新启用受保护的分支。 + [受保护的分支](/docs/user/project/protected-branch)将导致此操作失败。要继续的话,您必须删除分支保护,推送,然后重新启用受保护的分支。 6. 要从标记的 Release 中删除大文件,请强制将更改推送到CODEChina上的所有标记: @@ -71,7 +71,7 @@ git push origin --force --tags ``` - [受保护的标签](/docs/user/project/protected-tag.md)将导致此操作失败. 要继续,您必须删除标签保护,推送,然后重新启用受保护的标签. + [受保护的标签](/docs/user/project/protected-tag)将导致此操作失败. 要继续,您必须删除标签保护,推送,然后重新启用受保护的标签. 7. 手动执行项目整理 @@ -81,7 +81,7 @@ 要减少代码仓库的大小,必须删除 CODEChina 内部引用包含大文件的提交。在完成这些步骤之前,请[从存储库历史记录中清除文件](#purge-files-from-repository-history) . -除了[分支](/docs/user/project/repo/branches.md)和标签(这是一种 Git 引用)之外,系统还会自动创建其他引用,[代码仓库清理](#repository-cleanup)可用于从 CODEChina 中删除它们. +除了[分支](/docs/user/project/repo/branches)和标签(这是一种 Git 引用)之外,系统还会自动创建其他引用,[代码仓库清理](#repository-cleanup)可用于从 CODEChina 中删除它们. 以下为内部参考文献: @@ -91,9 +91,9 @@ 这意味着在获取时通常不包含它们,这使得获取速度更快。另外, `refs/keep-around/*`是隐藏的 refs,以防止与讨论相关的提交被删除并且根本无法被获取。但是,可以从项目导出内的 Git 捆绑包访问这些引用: -1. 使用受支持的程序包管理器或从源代码[安装`git filter-repo`](https://github.com/newren/git-filter-repo/blob/main/INSTALL.md) +1. 使用受支持的程序包管理器或从源代码[安装`git filter-repo`](https://github.com/newren/git-filter-repo/blob/main/INSTALL) -2. [从项目中](/docs/user/project/import.md#exporting-a-project-and-its-data)生成一个新的[导出](/docs/user/project/import.md#exporting-a-project-and-its-data)并下载 +2. [从项目中](/docs/user/project/import#exporting-a-project-and-its-data)生成一个新的[导出](/docs/user/project/import#exporting-a-project-and-its-data)并下载 3. 使用`tar`解压缩备份: diff --git a/docs/user/project/repo/web-editor.md b/docs/user/project/repo/web-editor.md index f8de0fb..d9603eb 100644 --- a/docs/user/project/repo/web-editor.md +++ b/docs/user/project/repo/web-editor.md @@ -58,9 +58,9 @@ 选择这些选项之一后,将基于项目的默认分支(默认为`master`创建新的分支或分支与合并请求. 分支名称将基于 Issue 的标题,并作为前缀具有其内部 ID。因此,上面的示例屏幕快照将创建一个名为`1-webpack`的分支。 -当您在一个空的项目中单击**创建分支**按钮时,CODEChina 会自动创建一个`master`分支, `README.md`提交一个空白的`README.md`文件,并根据 Issue 标题创建并将您重定向到新分支(如果您的项目已经配置了)。 +当您在一个空的项目中单击**创建分支**按钮时,CODEChina 会自动创建一个`master`分支, `README`提交一个空白的`README`文件,并根据 Issue 标题创建并将您重定向到新分支(如果您的项目已经配置了)。 -创建分支后,您可以编辑代码仓库中的文件以解决此 Issue。当基于新创建的分支创建合并请求时,描述字段将自动显示[ Issue 关闭模式](/docs/user/project/issues/manage.md#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 将自动关闭。 ### 从项目页新建分支[](#create-a-new-branch-from-a-projects-dashboard "Permalink") diff --git a/docs/user/project/settings.md b/docs/user/project/settings.md index 3762f04..a18bb40 100644 --- a/docs/user/project/settings.md +++ b/docs/user/project/settings.md @@ -1,8 +1,8 @@ # 项目设置[](#settings "Permalink") -**注意:**只有项目 maintainer [有权](/docs/user/permissions.md)访问项目设置。 +**注意:**只有项目 maintainer [有权](/docs/user/permissions)访问项目设置。 -您可以通过导航到项目的主页并点击**设置**来调整[项目](/docs/user/project.md)设置。 +您可以通过导航到项目的主页并点击**设置**来调整[项目](/docs/user/project)设置。 ## 常规设置[](#general-settings "Permalink") @@ -12,7 +12,7 @@ 调整项目的名称,描述,头像,默认分支和主题: -项目描述还部分支持[标准 Markdown](/docs/user/markdown.md#standard-markdown-and-extensions-in-gitlab) ,您可以使用[强调](/docs/user/markdown.md#emphasis) , [链接](/docs/user/markdown.md#links)和[换行符](/docs/user/markdown.md#line-breaks)为项目描述添加更多上下文。 +项目描述还部分支持[标准 Markdown](/docs/user/markdown#standard-markdown-and-extensions-in-gitlab) ,您可以使用[强调](/docs/user/markdown#emphasis) , [链接](/docs/user/markdown#links)和[换行符](/docs/user/markdown#line-breaks)为项目描述添加更多上下文。 #### 合规性框架[](#compliance-framework-premium "Permalink") @@ -28,7 +28,7 @@ 对于您的代码仓库,您可以设置例如公共访问,存储库功能,文档,访问权限等等。要从您的项目中执行此操作,请转到**"项目设置"** >" **常规设置"** ,然后展开" **可见性","项目功能","权限"**部分。 -现在,您可以更改项目可见性,如果将" **项目可见性"**设置为公开,则可以将某些功能的访问权限限制为" **仅项目成员"** 。 此外,您可以选择[允许用户请求访问权限](/docs/user/project/member.md#project-membership-and-requesting-access)的选项。 +现在,您可以更改项目可见性,如果将" **项目可见性"**设置为公开,则可以将某些功能的访问权限限制为" **仅项目成员"** 。 此外,您可以选择[允许用户请求访问权限](/docs/user/project/member#project-membership-and-requesting-access)的选项。 **警告:**如果降低项目的可见性级别,则该操作将取消该项目的所有分支的链接。 @@ -36,13 +36,13 @@ | Option | 更多访问限制选项 | Description | | --- | --- | --- | -| **Issues** | ✓ | 激活 GitLab 问题跟踪器 | -| **Repository** | ✓ | 启用 [仓库](/docs/user/project/repo.md) 功能 | -| **合并请求** | ✓ | 启用[合并请求](/docs/user/project/merge-request.md)功能; 另请参阅[合并请求设置](#merge-request-settings) | +| **Issues** | ✓ | 激活 Issue 跟踪器 | +| **Repository** | ✓ | 启用 [仓库](/docs/user/project/repo) 功能 | +| **合并请求** | ✓ | 启用[合并请求](/docs/user/project/merge-request)功能; 另请参阅[合并请求设置](#merge-request-settings) | | **Forks** | ✓ | 允许 fork 项目 | | **Git 大文件存储** |   | 允许使用大文件 | | **Packages** |   | Supports configuration of a package registry functionality | -| **Wiki** | ✓ | 启用单独的[文档](/docs/user/project/wiki.md)系统 | +| **Wiki** | ✓ | 启用单独的[文档](/docs/user/project/wiki)系统 | | **指标仪表板** | ✓ | 控制对指标仪表板的访问 | 一些功能取决于其他功能: @@ -65,16 +65,16 @@ #### 禁用邮件通知[](#disabling-email-notifications "Permalink") -项目 Owner 可以通过选中" **禁用电子邮件通知"**复选框来**禁用**与项目相关的所有[电子邮件通知](/docs/user/account/email-notify.md#gitlab-notification-emails)。 +项目 Owner 可以通过选中" **禁用电子邮件通知"**复选框来**禁用**与项目相关的所有[电子邮件通知](/docs/user/account/email-notify#gitlab-notification-emails)。 ### 合并请求设置[](#merge-request-settings "Permalink") 设置项目的合并请求设置: -* 设置合并请求方法(合并提交, [快速合并](/docs/user/project/merge-request/fast-forward.md) ) -* 添加合并请求[描述模板](/docs/user/project/description-template.md#description-templates) +* 设置合并请求方法(合并提交, [快速合并](/docs/user/project/merge-request/fast-forward) ) +* 添加合并请求[描述模板](/docs/user/project/description-template#description-templates) * 启用合并请求批准 -* 启用 [只有全部讨论内容解决后才允许合并](/docs/user/discussions.md#only-allow-merge-requests-to-be-merged-if-all-threads-are-resolved) +* 启用 [只有全部讨论内容解决后才允许合并](/docs/user/discussions#only-allow-merge-requests-to-be-merged-if-all-threads-are-resolved) * 默认启用`合并后删除分支` * 配置建议的更改提交信息 @@ -93,7 +93,7 @@ #### 归档项目[](#archiving-a-project "Permalink") -归档项目后,所有用户都将其设为只读,并表明该项目已不再处于主动维护状态。也可以取消归档已归档的项目,只有项目 Owner 才[有权](/docs/user/permissions.md)归档项目。 +归档项目后,所有用户都将其设为只读,并表明该项目已不再处于主动维护状态。也可以取消归档已归档的项目,只有项目 Owner 才[有权](/docs/user/permissions)归档项目。 归档项目后,存储库,问题,合并请求和所有其他功能均为只读,归档的项目也隐藏在项目列表中。 @@ -106,7 +106,7 @@ #### 取消项目归档[](#unarchiving-a-project "Permalink") -取消归档项目会删除对项目的只读限制,并使其在项目列表中可用。只有项目 Owner 才[有权](/docs/user/permissions.md)取消归档项目。 +取消归档项目会删除对项目的只读限制,并使其在项目列表中可用。只有项目 Owner 才[有权](/docs/user/permissions)取消归档项目。 要查找已归档的项目: @@ -124,7 +124,7 @@ #### 重命名一个项目[](#renaming-a-repository "Permalink") -**注意:**只有项目维护者才[有权](/docs/user/permissions.md#project-members-permissions)重命名代码仓库。不要与项目名称混淆,也可以从[常规项目设置中](#general-project-settings)进行更改。 +**注意:**只有项目维护者才[有权](/docs/user/permissions#project-members-permissions)重命名代码仓库。不要与项目名称混淆,也可以从[常规项目设置中](#general-project-settings)进行更改。 项目的存储库名称定义其 URL(您用于通过浏览器访问该项目的 URL)及其在安装服务器的文件磁盘上的位置。 @@ -139,11 +139,11 @@ #### 转移项目[](#transferring-an-existing-project-into-another-namespace "Permalink") -**注意:**只有项目 Owner 才[有权](/docs/user/permissions.md)转移项目。 +**注意:**只有项目 Owner 才[有权](/docs/user/permissions)转移项目。 -在以下情况下,您可以将现有项目转移到[组织中](/docs/user/org.md) : +在以下情况下,您可以将现有项目转移到[组织中](/docs/user/org) : -* 您至少对该组具有** maintainer ** [权限](/docs/user/permissions.md#project-members-permissions) +* 您至少对该组具有** maintainer ** [权限](/docs/user/permissions#project-members-permissions) * 您至少是要转让的项目的** Owner ** * 将项目转移到的组必须允许创建新项目 @@ -158,7 +158,7 @@ #### 删除项目[](#remove-a-project "Permalink") -**注意:**只有项目所有者和管理员才[有权](/docs/user/permissions.md#project-members-permissions)删除项目. +**注意:**只有项目所有者和管理员才[有权](/docs/user/permissions#project-members-permissions)删除项目. 删除项目: @@ -172,7 +172,7 @@ #### 删除 fork 项目关系[](#removing-a-fork-relationship "Permalink") -Fork 是为您不是项目成员的项目做贡献的好方法,如果您想自己使用 fork,而无需将[合并请求](/docs/user/project/merge-request.md)发送到上游项目,则可以安全地删除 fork 关系。 +Fork 是为您不是项目成员的项目做贡献的好方法,如果您想自己使用 fork,而无需将[合并请求](/docs/user/project/merge-request)发送到上游项目,则可以安全地删除 fork 关系。 **注意:**删除后,将无法恢复 fork 关系。您将不再能够将合并请求发送到源,并且如果有人 fork 了您的项目,他们的分支也将失去关系。 @@ -182,4 +182,4 @@ Fork 是为您不是项目成员的项目做贡献的好方法,如果您想自 2. 在" **删除 fork 关系"下** ,单击删除按钮 3. 按照说明键入项目的路径,以确认删除操作 -**注意:**只有项目 Owner [有权](/docs/user/permissions.md#project-members-permissions)删除 fork 关系。 \ No newline at end of file +**注意:**只有项目 Owner [有权](/docs/user/permissions#project-members-permissions)删除 fork 关系。 \ No newline at end of file diff --git a/docs/user/project/time-track.md b/docs/user/project/time-track.md index 5aa3dc1..c77230d 100644 --- a/docs/user/project/time-track.md +++ b/docs/user/project/time-track.md @@ -15,7 +15,7 @@ ## 如何更新数据[](#how-to-enter-data "Permalink") -时间跟踪可以如下两个[快速操作](/docs/user/project/quick-actions.md) : `/spend`和`/estimate` +时间跟踪可以如下两个[快速操作](/docs/user/project/quick-actions) : `/spend`和`/estimate` 快速操作既可以用于 Issue 或合并请求的正文中,也可以用于 Issue 或合并请求的注释中。 diff --git a/docs/user/project/webide.md b/docs/user/project/webide.md index adc2944..ca1b40d 100644 --- a/docs/user/project/webide.md +++ b/docs/user/project/webide.md @@ -72,7 +72,7 @@ Web IDE 当前支持以下`.editorconfig`设置: ## 编辑Markdown[](#markdown-editing "Permalink") -在 Web IDE 中编辑 Markdown 文件时,可以通过单击文件编辑器上方的" **预览 Markdown"**选项卡来预览更改. Markdown 预览支持[GFM](/docs/user/markdown.md#gitlab-flavored-markdown-gfm)。 +在 Web IDE 中编辑 Markdown 文件时,可以通过单击文件编辑器上方的" **预览 Markdown"**选项卡来预览更改. Markdown 预览支持[GFM](/docs/user/markdown#gitlab-flavored-markdown-gfm)。 您还可以通过将任何本地图像直接粘贴到 Markdown 文件中来上传它们,该图像将上传到同一目录,默认情况下命名为`image.png` 。 如果已经存在相同名称的另一个文件,则将数字后缀自动添加到文件名。 diff --git a/docs/user/project/wiki.md b/docs/user/project/wiki.md index a5681d9..14c3f0a 100644 --- a/docs/user/project/wiki.md +++ b/docs/user/project/wiki.md @@ -12,7 +12,7 @@ ## 新建 Wiki [](#creating-a-new-wiki-page "Permalink") -**注意:**需要 developer [权限](/docs/user/permissions.md) +**注意:**需要 developer [权限](/docs/user/permissions) 通过单击可在所有 Wiki 页面中找到的" **新页面"**按钮来创建新页面。 @@ -20,7 +20,7 @@ 您可以通过在标题中使用" /"指示子目录来为 Wiki 页面指定完整路径,任何丢失的目录将自动创建。例如, `docs/my-page`的标题将创建一个 Wiki 页面,其路径为`/wikis/docs/my-page` 。 -输入页面名称后,就该填写其内容了. Wiki 支持 Markdown,RDoc,AsciiDoc 和 Org。对于基于 Markdown 的页面,所有[Markdown 功能](/docs/user/markdown.md)均受支持,对于链接,则存在一些[特定](/docs/user/markdown.md#wiki-specific-markdown)于[Wiki 的](/docs/user/markdown.md#wiki-specific-markdown)行为。 +输入页面名称后,就该填写其内容了. Wiki 支持 Markdown,RDoc,AsciiDoc 和 Org。对于基于 Markdown 的页面,所有[Markdown 功能](/docs/user/markdown)均受支持,对于链接,则存在一些[特定](/docs/user/markdown#wiki-specific-markdown)于[Wiki 的](/docs/user/markdown#wiki-specific-markdown)行为。 在 Web 界面中,提交消息是可选的,但是 Wiki 是基于 Git 的,并且需要提交消息,因此如果您不输入消息,则会为您创建一条。 @@ -54,7 +54,7 @@ Wiki 页面作为文件存储在 Git 代码仓库中,因此某些字符具有 ## 编辑 Wiki [](#editing-a-wiki-page "Permalink") -**注意:**需要 developer [权限](/docs/user/permissions.md) +**注意:**需要 developer [权限](/docs/user/permissions) 要编辑页面,只需单击" **编辑"**按钮,然后您可以更改其内容;完成后,单击" **保存更改"**以使更改生效。 @@ -64,7 +64,7 @@ Wiki 页面作为文件存储在 Git 代码仓库中,因此某些字符具有 ## 删除 Wiki [](#deleting-a-wiki-page "Permalink") -**注意:**需要 maintainer [权限](/docs/user/permissions.md) +**注意:**需要 maintainer [权限](/docs/user/permissions) 仅在编辑页面时才能找到" **删除"**按钮,单击它并确认您要删除页面。 @@ -102,7 +102,7 @@ Wiki 页面随时间的变化记录在 Wiki 的 Git 存储库中,您可以通 根据您要使用的标记语言,您在本地添加到 Wiki 的文件必须具有以下受支持的扩展名之一,否则当推送到 CODEChina 时将不会显示这些文件: -* Markdown 扩展名: `.mdown` , `.mkd` , `.mkdn` , `.md` , `.markdown` +* Markdown 扩展名: `own` , `.mkd` , `.mkdn` , `` , `.markdown` * AsciiDoc 扩展名: `.adoc` , `.ad` , `.asciidoc` * 其他标记扩展名: `.textile` , `.rdoc` , `.org` , `.creole` , `.wiki` , `.mediawiki` , `.rst` diff --git a/docs/user/search.md b/docs/user/search.md index 9f9990a..4930753 100644 --- a/docs/user/search.md +++ b/docs/user/search.md @@ -28,9 +28,9 @@ 2. 在出现的下拉菜单中,选择您要过滤的属性: * 作者 * 指派人 - * [里程碑](/docs/user/project/milestone.md) + * [里程碑](/docs/user/project/milestone) * Release - * [标签](/docs/user/project/label.md) + * [标签](/docs/user/project/label) * 我的反应 * 机密 * Epic @@ -98,13 +98,13 @@ ## 待办事项[](#to-do-list "Permalink") -可以通过"待办事项"和"完成"来搜索您的[待办事项列表](/docs/user/todo.md) 。您可以按项目,作者,类型和操作[过滤](/docs/user/todo.md#filtering-your-to-do-list)它们。另外,您可以按[**标签优先级**](/docs/user/project/label.md#label-priority) , **最后创建**和**最早创建**对其进行排序。 +可以通过"待办事项"和"完成"来搜索您的[待办事项列表](/docs/user/todo) 。您可以按项目,作者,类型和操作[过滤](/docs/user/todo#filtering-your-to-do-list)它们。另外,您可以按[**标签优先级**](/docs/user/project/label#label-priority) , **最后创建**和**最早创建**对其进行排序。 ## 项目[](#projects "Permalink") 您可以从导航中项目菜单栏去搜索和发现项目,方法是依次点击**项目>浏览项目** , 在" **按名称过滤** "字段上,输入要查找的项目或组织名称即可。 -你也可以去找你的项目[ Star ](/docs/basic/create-project.md#star-a-project) ( **加星标的项目** ),并**探索**所有的公共和内部项目 GitLab.com 可用,从中你可以通过可视性筛选,通过**趋势** ,最好与**大多数明星**评分,或他们的**全部** . +你也可以去找你的项目[ Star ](/docs/basic/create-project#star-a-project) ( **加星标的项目** ),并**探索**所有的公共和内部项目 GitLab.com 可用,从中你可以通过可视性筛选,通过**趋势** ,最好与**大多数明星**评分,或他们的**全部** . 您还可以按**名称** , **最后创建** , **最旧创建** , **最后更新** , **最新更新** , **所有者**对搜索结果中的项目进行排序,并选择隐藏或显示**已归档的项目** 。 @@ -118,7 +118,7 @@ ## 看板[](#issue-boards "Permalink") -在[看板](/docs/user/project/kanban.md) 中,您可以按**作者** , **指派人** , **里程碑**和**标签**过滤 Issue。您还可以从键入时加载的字段中**按名称过滤** 。 +在[看板](/docs/user/project/kanban) 中,您可以按**作者** , **指派人** , **里程碑**和**标签**过滤 Issue。您还可以从键入时加载的字段中**按名称过滤** 。 当您要添加**Issue**到看板中以便在看板中搜索时,请点击屏幕右上角的**添加 Issue**按钮,除了按**名称**过滤它们之外,您还可以从中找到一个模式窗口**作者** , **受让人** , **里程碑**和**标签** ,选择多个问题以添加到您选择的列表中。 diff --git a/docs/user/shortcutkey.md b/docs/user/shortcutkey.md index 0f3215d..869bc65 100644 --- a/docs/user/shortcutkey.md +++ b/docs/user/shortcutkey.md @@ -78,7 +78,7 @@ ### Web IDE[](#web-ide "Permalink") -使用[Web IDE](/docs/user/project/webide.md)编辑文件时,可以使用以下快捷方式: +使用[Web IDE](/docs/user/project/webide)编辑文件时,可以使用以下快捷方式: | 快捷键 | 说明 | | --- | --- | @@ -87,7 +87,7 @@ ### 分支图[](#repository-graph "Permalink") -以下快捷键在查看项目[分支图](/docs/user/project/repo.md#repository-graph)页面时可用(导航至**代码> 分支图** ): +以下快捷键在查看项目[分支图](/docs/user/project/repo#repository-graph)页面时可用(导航至**代码> 分支图** ): | 快捷键 | 说明 | | --- | --- | @@ -100,7 +100,7 @@ ### Wiki[](#wiki-pages "Permalink") -在查看[Wiki](/docs/user/project/wiki.md)时,可以使用以下快捷键: +在查看[Wiki](/docs/user/project/wiki)时,可以使用以下快捷键: | 快捷键 | 说明 | | --- | --- | @@ -108,7 +108,7 @@ ### 搜索过滤[](#filtered-search "Permalink") -以下快捷键在使用[搜索过滤](/docs/user/search.md))时可用: +以下快捷键在使用[搜索过滤](/docs/user/search))时可用: | 快捷键 | 说明 | | --- | --- | diff --git a/docs/user/todo.md b/docs/user/todo.md index de5510e..680693f 100644 --- a/docs/user/todo.md +++ b/docs/user/todo.md @@ -28,7 +28,7 @@ * 你是作者 * 是由您将其设置为在 pipeline 成功后自动合并的 -待办事项触发器不受[通知电子邮件设置的影响](/docs/user/account/email-notify.md) 。 +待办事项触发器不受[通知电子邮件设置的影响](/docs/user/account/email-notify) 。 **注意:**当用户不再有权访问与待办事项相关的资源(例如 Issue,合并请求,项目或组织)时,出于安全原因,相关的待办事项将在一小时内删除。为了防止用户的权限被错误地收回导致数据丢失,删除操作会延迟处理。 -- GitLab