web-editor.md 6.8 KB
Newer Older
Lab机器人's avatar
Lab机器人 已提交
1
# 文件编辑[](#文件编辑 "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
2

Lab机器人's avatar
Lab机器人 已提交
3
有时,直接从 CODEChina 界面进行快速更改要比克隆项目并使用 Gi​​t 命令行工具更容易。接下来,我们重点介绍如何从文件浏览器创建新文件,目录,分支或标记,以上所有这些操作都可以通过一个下拉菜单获得。
Lab机器人's avatar
readme  
Lab机器人 已提交
4

Lab机器人's avatar
Lab机器人 已提交
5
## 创建文件[](#create-a-file "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
6

Lab机器人's avatar
Lab机器人 已提交
7
在项目的文件页面中,单击分支下拉列表右侧的" +"按钮,从下拉列表中选择**新文件** 
Lab机器人's avatar
readme  
Lab机器人 已提交
8

Lab机器人's avatar
Lab机器人 已提交
9
[![New file dropdown menu](/docs/img/web_editor_new_file_dropdown.png)](/docs/img/web_editor_new_file_dropdown.png)
Lab机器人's avatar
readme  
Lab机器人 已提交
10

Lab机器人's avatar
Lab机器人 已提交
11
**文件名**框中输入文件名,然后在编辑器区域中添加文件内容;添加描述性提交消息并选择一个分支,分支字段将默认为您在文件浏览器中查看的分支;如果输入新的分支名称,将出现一个复选框,允许您在提交更改后启动新的合并请求。
Lab机器人's avatar
readme  
Lab机器人 已提交
12

Lab机器人's avatar
Lab机器人 已提交
13
当您完成新文件的内容后,请单击底部的" **提交更改** "。
Lab机器人's avatar
readme  
Lab机器人 已提交
14

Lab机器人's avatar
Lab机器人 已提交
15
### 文件模板[](#template-dropdowns "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
16

Lab机器人's avatar
Lab机器人 已提交
17
启动新项目时,新项目可能也需要一些通用文件,CODEChina 将在仓库中提示您新建这些文件。
Lab机器人's avatar
readme  
Lab机器人 已提交
18

Lab机器人's avatar
Lab机器人 已提交
19
[![First file for your project](/docs/img/web_editor_template_dropdown_first_file.png)](/docs/img/web_editor_template_dropdown_first_file.png)
Lab机器人's avatar
readme  
Lab机器人 已提交
20

Lab机器人's avatar
Lab机器人 已提交
21
当单击`LICENSE``.gitignore`等时,将显示一个下拉列表,为您提供适合您的项目的模板。
Lab机器人's avatar
readme  
Lab机器人 已提交
22

Lab机器人's avatar
Lab机器人 已提交
23
[![MuLan license selected](/docs/img/web_editor_template_dropdown_mulan_license.png)](/docs/img/web_editor_template_dropdown_mulan_license.png)
Lab机器人's avatar
readme  
Lab机器人 已提交
24

Lab机器人's avatar
Lab机器人 已提交
25
许可证,更新日志,贡献指南等文件也都可以通过项目页面上的按钮添加。
Lab机器人's avatar
readme  
Lab机器人 已提交
26

Lab机器人's avatar
Lab机器人 已提交
27
## 上传文件[](#upload-a-file "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
28

Lab机器人's avatar
Lab机器人 已提交
29
当内容为文本时,创建文件将十分方便。但是,这不适用于二进制数据,例如图像,PDF 或其他文件类型,在这种情况下,您可以选择上传文件。
Lab机器人's avatar
readme  
Lab机器人 已提交
30

Lab机器人's avatar
Lab机器人 已提交
31
在项目的文件页面中,单击分支下拉列表右侧的" +"按钮,从下拉菜单中选择**上传文件**
Lab机器人's avatar
readme  
Lab机器人 已提交
32

Lab机器人's avatar
Lab机器人 已提交
33
弹出上传对话框后,有两种方法可以上传文件:可以在弹出窗口中拖放文件;也可以使用**点击上传**链接,选择要上传的文件后,将显示文件预览。
Lab机器人's avatar
readme  
Lab机器人 已提交
34

Lab机器人's avatar
Lab机器人 已提交
35
输入提交消息,选择一个分支,并在准备好后单击**上传文件**
Lab机器人's avatar
readme  
Lab机器人 已提交
36

Lab机器人's avatar
Lab机器人 已提交
37
## 新建目录[](#create-a-directory "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
38

Lab机器人's avatar
Lab机器人 已提交
39
为了使代码仓库中的文件井井有条,您可以创建一个目录将相关的文件都归类到同一个目录中。
Lab机器人's avatar
readme  
Lab机器人 已提交
40

Lab机器人's avatar
Lab机器人 已提交
41
在项目的文件页面中,单击分支下拉列表右侧的" + "号,从下拉菜单中选择 **新建目录**
Lab机器人's avatar
readme  
Lab机器人 已提交
42

Lab机器人's avatar
Lab机器人 已提交
43
在新目录对话框中,输入目录名称,提交消息并选择目标分支,单击**创建目录**完成新建目录操作。
Lab机器人's avatar
readme  
Lab机器人 已提交
44

Lab机器人's avatar
Lab机器人 已提交
45
## 新建分支[](#create-a-new-branch "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
46

Lab机器人's avatar
Lab机器人 已提交
47
有多种方法可从 CODEChina 的界面创建分支。
Lab机器人's avatar
readme  
Lab机器人 已提交
48

Lab机器人's avatar
Lab机器人 已提交
49
### 从 Issue 创建一个新分支[](#create-a-new-branch-from-an-issue "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
50

Lab机器人's avatar
Lab机器人 已提交
51
如果您的开发工作流程要求每个合并请求都存在 Issue,则可以直接从该 Issue 快速创建分支,以加快流程。新分支及其以后的合并请求将被标记为与此问题相关,合并后将自动关闭 Issue。您可以在 Issue 说明下方看到 **创建合并请求**下拉列表。
Lab机器人's avatar
readme  
Lab机器人 已提交
52

Lab机器人's avatar
Lab机器人 已提交
53
**注意:**如果已经有一个具有相同名称的分支或一个引用的合并请求,或者您的项目具有活动的 Fork 关系,则不会看到 **创建合并请求**按钮。如果您想显示此按钮,则可能的解决方法是删除项目的 fork 关系,删除后,Fork 关系将无法恢复,您将不再能够将合并请求发送到源仓库。
Lab机器人's avatar
readme  
Lab机器人 已提交
54

Lab机器人's avatar
Lab机器人 已提交
55
该下拉列表包含选项**创建合并请求和分支**以及**创建分支** 
Lab机器人's avatar
readme  
Lab机器人 已提交
56

Lab机器人's avatar
Lab机器人 已提交
57
[![New Branch Button](/docs/img/web_editor_new_branch_from_issue_v_12_6.png)](/docs/img/web_editor_new_branch_from_issue_v_12_6.png)
Lab机器人's avatar
readme  
Lab机器人 已提交
58

Lab机器人's avatar
Lab机器人 已提交
59
选择这些选项之一后,将基于项目的默认分支(默认为`master`创建新的分支或分支与合并请求. 分支名称将基于 Issue 的标题,并作为前缀具有其内部 ID。因此,上面的示例屏幕快照将创建一个名为`1-webpack`的分支。
Lab机器人's avatar
readme  
Lab机器人 已提交
60

Lab机器人's avatar
Lab机器人 已提交
61
当您在一个空的项目中单击**创建分支**按钮时,CODEChina 会自动创建一个`master`分支, `README.md`提交一个空白的`README.md`文件,并根据 Issue 标题创建并将您重定向到新分支(如果您的项目已经配置了)。
Lab机器人's avatar
readme  
Lab机器人 已提交
62

Lab机器人's avatar
Lab机器人 已提交
63
创建分支后,您可以编辑代码仓库中的文件以解决此 Issue。当基于新创建的分支创建合并请求时,描述字段将自动显示[ Issue 关闭模式](/docs/user/project/issues/manage.md#closing-issues-automatically) `Closes #ID` ,其中`ID`为 Issue 的 ID,一旦合并请求被合并, Issue 将自动关闭。
Lab机器人's avatar
readme  
Lab机器人 已提交
64

Lab机器人's avatar
Lab机器人 已提交
65
### 从项目页新建分支[](#create-a-new-branch-from-a-projects-dashboard "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
66

Lab机器人's avatar
Lab机器人 已提交
67
如果要在创建新的合并请求之前对多个文件进行更改,则可以预先创建一个新的分支。在项目页的" + "号下拉列表中选择 **新建分支** "。
Lab机器人's avatar
readme  
Lab机器人 已提交
68

Lab机器人's avatar
Lab机器人 已提交
69
[![New branch dropdown](/docs/img/web_editor_new_branch_dropdown.png)](/docs/img/web_editor_new_branch_dropdown.png)
Lab机器人's avatar
readme  
Lab机器人 已提交
70

Lab机器人's avatar
Lab机器人 已提交
71
输入新的**分支名称** ,更改**从模板创建**字段以选择该新分支将来自哪个分支、标记或提交 SHA(可选)。如果您开始键入现有的分支或标签,则此字段将自动完成。单击**创建分支** ,您将返回到该新分支上的文件列表页。
Lab机器人's avatar
readme  
Lab机器人 已提交
72

Lab机器人's avatar
Lab机器人 已提交
73
[![New branch page](/docs/img/web_editor_new_branch_page.png)](/docs/img/web_editor_new_branch_page.png)
Lab机器人's avatar
readme  
Lab机器人 已提交
74

Lab机器人's avatar
Lab机器人 已提交
75
现在,您可以根据需要更改任何文件。当您准备好将更改合并回 master 分支时,可以使用页面顶部的"创建合并请求"按钮,在创建分支或修改文件后,该按钮将会在页面显示一段时间。
Lab机器人's avatar
readme  
Lab机器人 已提交
76

Lab机器人's avatar
Lab机器人 已提交
77
## 新建 Tag[](#create-a-new-tag "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
78

Lab机器人's avatar
Lab机器人 已提交
79
Tag 可用于标记主要的里程碑,例如 Release 版本,候选版本等等。您可以从分支或提交 SHA 创建 Tag,在项目的文件页面上,从下拉列表中选择" **新建标签** "。
Lab机器人's avatar
readme  
Lab机器人 已提交
80

Lab机器人's avatar
Lab机器人 已提交
81
给标签起一个名字,例如`v1.0.0` 。选择您要从中创建此新标签的分支或 SHA,您可以选择添加一条消息及 Release说明(可选),发行说明支持 Markdown 格式,您也可以上传附件。单击**创建标签** ,创建成功后将返回标签列表页。
Lab机器人's avatar
readme  
Lab机器人 已提交
82

Lab机器人's avatar
Lab机器人 已提交
83
## 提示[](#tips "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
84

Lab机器人's avatar
Lab机器人 已提交
85
创建或上传新文件或创建新目录时,均可触发新的合并请求,而不是直接提交给 master。在**目标分支**字段中输入新的分支名称,您会注意到出现一个复选框,标有**通过这些更改启动新的合并请求** ,提交更改后,您将进入新的合并请求表单。
Lab机器人's avatar
readme  
Lab机器人 已提交
86

Lab机器人's avatar
Lab机器人 已提交
87
如果你*不*希望使用您的主电子邮件地址通过 Web 编辑器创建的提交,您可以从**用户设置>编辑个人资料**页面选择使用其他的链接的电子邮件地址。