翻译正在进行中。

注意:几乎所有的MDN贡献者都会做的两件事,也是MDN上两个最基本的工作——编辑已有的页面或者新建一个页面。这篇文章会介绍这两个最基本的功能。

编辑一个已存在的页面

编辑页面很简单:

  • 只需要点击页面右上角的 Edit(编辑)按钮。
  • 页面会重新加载具有规定格式的选项,你可以直接在页面上新增或者删除内容。
  • 你可以新增段落,删除文本,插入标题,并且执行更多涉及编写和编辑的功能。通过查看Editor UI elements来获得更多关于MDN内置编辑器的信息。

预览修改

查看你修改的内容:

  • 点击文章标题上方的"Preview changes"(预览修改)按钮(在编辑模式下)。
  • 这会在新窗口或新标签页中打开一个修改过的预览页。
  • 每次点击按钮,预览页都会刷新到最新的状态。

注意!预览页面并不会保存你的修改内容,所以记住不要关闭你的编辑页面。

版本注释

当预览更改之后,你将需要保存你的修改版本。在保存之前,查看页面文章下方的版本注释栏,留下一些注释信息来告诉其它贡献者你为什么要去修改它。例如,你可能新增加了一个章节,或修改了一些文字来使得术语表述的更加一致,亦或重构了一个段落使其语言更加本地化,或者就是删除了一些冗余信息。

目录

一篇文章的“在本文中”部分是自动生成的页面上标题的链接列表。这些链接的措词可以通过编辑标题进行编辑。也可以通过选择“编辑页面标题和属性”和改变“TOC”下拉列表的值,从而删除目录,或减少链接数量。

标签

你可以新增或删除编辑区域下面的一些描述页面内容或者功能的标签。查看 如何正确标记页面 来了解标签是如何提供信息的。

复核是必须的吗?

保存之前,为了确保信息的准确性,你可以勾选技术复核(针对代码,API,或技术),编辑复核(针对文章,语法,和内容),或模板复核(针对KumaScript code)的选择框,来让专家或有经验的贡献者复核你的编辑信息。

附件

如果你想将某个文件附加到一个现有的页面中来添加插图或作进一步说明的话,你可以在页面底部输入。{ {OptimizeImagesNote(1)} }

保存,放弃更改,继续编辑

当你完成编辑,并很开心地预览完修改后,你可以点击标题右边或者文章底部的的绿色按钮“保存修改”来保存你的工作和注释。如果你想要继续编辑,可以选择点击按钮“发布并继续编辑”来保证在保存编辑的同时不离开编辑模式。

如果你改变主意,你也可以点击页面右侧的红色按钮“放弃更改”来放弃你的编辑,注意放弃更改是不可撤销返回的。

在版本注释区域点击 Enter 键和点击按钮“保存并继续编辑”具有相同的效果。

注意:当你尝试保存你编辑好的页面时发现你的编辑被视为无效操作而被拒绝了,若你编辑好的内容又确实是适合MDN的,此时你可以向MDN admin team发送邮件来获得帮助。

新建一个页面

找不到在哪里新建一个页面?别担心!你可以在任何地方新建一个页面,如果这个页面是有意义的话,我们会找到它并把它归档或者合并到合适的类别下。你也不用过多担心它不够完美,我们有热心的志愿者来帮你打理,让你的文章保持干净美观。 

下面是一些新建页面的方法:

获取新建页面的许可

出于对安全的考虑,新的志愿者是没有权限新建页面的。如果你尝试这样做,你将看到一个页面,指导你如何创建新页面。有以下两种可选的方式:

  • 请别人帮你创建。为此,请您提供一份用于提出 bug 的申请书,并且以 "Create page: <页面标题>" 为主题。如果您知道该页面应该放在 MDN 中的什么位置,请确保填写好一个 URL 来描述该位置。您还应该注明您为何需要创建该页面。
  • 申请页面创建权限。如果您申请了页面创建权限且得到了授权,您可以根据下述的指南自行创建新页面。为了请求该权限,请您将申请书通过电子邮件发送给 MDN 管理团队。请确保申请书的内容涵盖了您的用户名、你想申请页面创建权限的原因(比方说:您正在编制一份新的 API 文档,该文档涉及许多新页面,又或者您想添加一些新条目到术语表)。您还应该曾经为该网站的内容作出过许多有益贡献,并且成为贡献者应该已经有一段时日了(至于这段时日有多久,这并没有一个固定期限,因为还需要同时考虑其他的因素)。

“缺失页面”链接

和许多维基站点一样,在 MDN 也有可能创建一个链接,它指向一个尚不存在的页面。例如:一个作者可能创建了一个清单页面,该页面涵盖了某个API的所有成员,而这些成员对应的页面还没创建好。在 MDN,指向到缺失页面的链接通常显示为红色。

从“缺失页面”链接创建对应的页面:

  1. 确认已登录进 MDN。(若未登录就点击“缺失页面”链接,会得到一个404(找不到页面)的错误。)
  2. 点击“缺失页面”链接。如果你拥有页面创建权限,MDN编辑器界面会自动打开,准备好让你创建缺失的页面。
  3. 编写页面内容,然后保存。

无链接的新页面

键入以下 URL 到您的浏览器地址栏,以便创建一个没有链接到其他页面的新页面。

https://developer.mozilla.org/en-US/docs/new

MDN 创建新页面时有一个地方专门用来填写标题,打开编辑器后您就可以添加内容到这个新页面。请参考本文中编辑一个已存在的页面的小节来学习如何使用编辑器模式。

已存在页面的子页面

在页面层次结构中的现有页面下创建页面:

  1. 在“父”页面,点击高级菜单(工具栏中的齿轮按钮),然后点击“新建子页面”。一个编辑器视图被打开来创建新文档。
  2. 在标题栏键入文档标题。
  3. 需要的话,更改 Slug 字段(例如,若标题太长而你又想用较短的URL)。该字段由编辑器自动填充,替换掉标题处的空白下划线。这样的话,你可以更改文档对应的URL的最后一部分。
  4. 在 TOC 字段,选择你想自动显示在页面目录中的标题级别,或者如果一个都不需要的话可以选择”无目录“。
  5. 在编辑框中编写页面内容,然后保存您的修改。请参考本文中编辑一个已存在页面的小节来学习如何使用编辑器模式。

克隆一个已存在的页面

如果你想应用一个已经存在的页面的版式,你可以“克隆”这个页面并且修改其内容。

  1. 在原页面中,点击高级菜单(工具栏中的齿轮按钮),然后点击“克隆此文章”。一个编辑器视图被打开来创建新文档。
  2. 更改这篇文章的标题以便适合新的内容,当你在更改标题时,slug 字段会自动更新。
  3. 如果需要,更改部分 slug 字段的路径,然后把新的文档放入文件夹的另一处。

从现有页面链接到新页面

你可以在一个现有页面创建一个链接,然后点击这个链接来创建一个新页面:

  1. 在现有页面的随便某个位置输入新页面的名字(具有一定意义的)
  2. 将名字设置为高亮显示并在编辑工具栏点击链接图标。 
  3. "/en-US/docs/" 会被默认添加到URL的开头。在 "/en-US/docs/" 后输入此页面的名字。
  4. 点击“OK”来创建和插入这个链接。

如果这个页面不存在,这个链接将会用红色显示。如果这个页面存在,这个链接将会用蓝色显示。如果你想创建一个新的页面,但是你想创建页面的标题被占用了,

文档标签和贡献者

标签: 
 此页面的贡献者: runyul, Ykw, LemonGirl, feitill, swpuLeo, qson, akd3b, nickzone, maksyuki, ziyunfei, sweetliu
 最后编辑者: runyul,