How to create and edit pages

本文向新参与者介绍了编辑现有页面和创建新页面的过程.

Editing an existing page

要编辑页面:

  1. 如果您使用的是MDN Web文档的只读版本(https://developer.mozilla.org),请在文章标题中的Wiki中单击" 编辑 ". 这会将您带到该站点的可编辑Wiki版本(https://wiki.developer.mozilla.org),但实际上并没有打开编辑界面.
  2. 单击维基页面文章标题中的" 编辑"按钮.
  3. 然后使用编辑界面重新加载页面,您可以在其中直接添加或删除信息.
  4. 添加段落,删除文本,插入标题,以及执行编写和编辑中涉及的更多基本功能.

有关使用MDN的内置编辑器的更多信息,请参见MDN编辑器指南中的Editor UI元素 指南 .

Preview changes

要查看所做的更改,请执行以下操作:

  • 单击页面顶部或底部的编辑功能内的预览按钮.
  • 这将打开预览页面,在新窗口或选项卡中显示您的修订.
  • 每次您单击此按钮时,它都会使用最新更改刷新预览页面.

小心! 预览页面不会保存您的进度. 保存工作之前,请勿关闭编辑选项卡.

Revision comment

预览更改后,您将需要保存修订 . 保存之前,在编辑框下方找到修订注释框,并留下注释以告知其他贡献者您进行更改的原因. 例如,您可能已经添加了一个新部分,更改了一些词以使术语更加一致,重写了一段以澄清语言,或者删除了多余的信息.

Table of Contents

文章的"在此页面上"部分是自动生成的指向页面标题的链接列表. 这些文字可以通过标题进行编辑. 通过选择"编辑页面标题和属性",更改"目录"下拉菜单的值,也可以删除目录或减少其链接数.

Tags

您可以在编辑部分下方添加或删除描述页面内容和目的的标签. 请参阅如何正确标记页面 ,以获取有关要应用哪些标记的信息.

Review needed?

如果专家或经验丰富的撰稿人应审阅您的编辑,请请求进行技术审阅(针对代码,API或技术)和/或进行编辑审阅(针对散文,语法和内容),并确保在选中之前选中适当的框.您保存.

Attach files

附加文件需要特殊的用户权限. 有关详细信息,包括如何请求上传特权,请参阅MDN编辑器中的附件 .

Publish, Discard, or Keep editing

当您完成编辑并对预览满意时,请单击页面标题右侧页面底部绿色" 发布"按钮来发布您的工作和评论. 如果您希望继续工作,请点击发布并继续编辑 ,它会发布您的更改并使编辑界面保持打开状态.

如果您改变主意,则可以通过单击红色的" 放弃"按钮来放弃编辑. 请注意,放弃更改将永久丢弃它们.

在"修订注释"字段中按Enter键等效于单击" 发布并继续编辑" .

注意:如果尝试保存,但更改被视为无效而被拒绝,并且您认为内容适合MDN,请向MDN管理团队发送电子邮件以寻求帮助.

Getting page-creation permissions

出于安全原因,新创建的帐户无法创建新页面. 如果尝试这样做,将会看到一个页面,指示您如何创建页面. 有两种选择:

  • 要求为您创建页面. 为此,请提交文档请求问题 ,标题为"创建页面:<页面标题>". 如果您知道该模板的放置位置,请在模板的URL字段中填写您希望该页面转到MDN的位置. 在注释文本中,包括有关为何需要创建此页面的信息.
  • 请求页面创建特权. 如果您请求页面创建特权,并且已将它们授予您,则可以按照此处的说明添加新页面. 要请求这些特权,请向MDN管理员小组发送您的请求. 包括您的用户名,以及为什么您希望能够创建新页面. 例如,您正在记录一个涉及许多新页面的新API,或者您想在词汇表中添加新术语. 您还应该对本网站的内容做出有益的贡献,并且已经有一段时间了. 这段时间的长短以及其他因素被综合考虑.

Creating a new page

拥有页面创建权限后,即可开始创建页面.

如果您不知道在哪里放置新文章, 请不要担心. 将其放置在任何地方,我们将找到它,将其移至其所属位置或将其合并到现有内容中. 最有意义的事情. 不用担心使其完美. 我们有乐于助人的侏儒,他们可以使您的内容整洁,漂亮.

有几种创建新页面的方法:

与大多数Wiki一样,可以创建指向尚不存在的页面的链接. 例如,作者可能在创建API的所有成员的列表之前创建这些成员的页面. 在MDN上,指向不存在的页面的链接通常以红色显示.

要通过"缺少页面"链接创建页面,请执行以下操作:

  1. 登录到MDN,并具有页面创建权限. 如果未登录,则单击"缺少页面"链接将导致404(找不到页面)错误.
  2. 点击"缺少页面"链接. 如果您具有页面创建权限,则将打开" MDN编辑器" UI ,准备好创建缺少的页面.
  3. 编写页面内容,然后保存.

要创建新页面而不链接另一个页面 ,请在浏览器的URL字段中输入唯一的页面名称. 例如,如果输入:

https://wiki.developer.mozilla.org/en-US/docs/FooBar

MDN创建一个标题为" FooBar"的新页面,打开编辑器以添加新内容. 请参阅本文的" 编辑现有页面"部分,以获取有关如何使用编辑器模式的信息.

创建新页面而不链接另一个页面:

  1. 登录并具有页面创建权限.
  2. 在浏览器的" URL"字段中输入以下内容:
https://wiki.developer.mozilla.org/en-US/docs/new

MDN创建一个新页面,并在其中放置标题,打开编辑器以向该页面添加新内容. 有关使用编辑器模式的信息,请参阅" 编辑现有页面" .

Subpage of an existing page

要在页面层次结构中创建要位于现有页面下方的页面:

  1. 如果需要,通过单击文章标题中的" 在Wiki编辑"来导航到Wiki站点.
  2. 在"父"页面上,点击" 高级"菜单(工具栏中的齿轮图标),然后点击" 新建"子页面 .
  3. 将打开一个用于创建新文档的编辑器视图.
  4. 标题字段中为此文档添加标题.
  5. 如果需要,请更改" 子弹"字段. 例如,如果标题很长,则较短的URL似乎合适. 该字段由编辑器自动填充,用下划线代替标题中的空格,仅更改URL的最后一部分.
  6. 在" 目录"字段中,选择要在页面目录中显示的标题级别. 如果不需要,则选择"无目录".
  7. 在编辑器窗格中写入页面内容,保存更改. 有关使用编辑器模式的更多信息,请参阅" 编辑现有页面" .

Clone of an existing page

如果有一个现有页面,您希望将其格式用作新页面的基础,则可以"克隆"该页面,然后更改其内容.

  1. 如果需要,通过单击文章标题中的" 在Wiki编辑"来导航到Wiki站点.
  2. 在原始页面上,点击高级菜单(工具栏中的齿轮图标),然后点击克隆此页面 . 将打开一个编辑器视图,用于创建新文档.
  3. 更改页面标题 ,以适合新内容. 当您更改" 标题"字段时," 子弹"字段会自动更新.
  4. 根据需要更改Slug字段的路径部分,以将新文档放置在文档层次结构中的其他位置. 在大多数情况下,这是不需要的. 克隆的页面通常具有与原始页面相似的内容,并且需要位于相似的位置.
  5. 在" 目录"字段中,选择要在此页面的目录中自动显示的标题级别. 如果不需要,则选择"无目录".
  6. 将内容写在编辑器窗格中,保存更改. 有关使用编辑器模式的更多信息,请参考编辑现有页面 .

这有点混合. 您可以在另一个页面上创建一个链接,然后单击刚刚插入的链接以创建新页面:

  1. 输入新页面的名称,在现有页面的文本中有意义的任何位置.
  2. 突出显示此新名称,然后单击"链接"图标( 在编辑器的工具栏中. 将打开"更新链接"对话框,在"链接到"字段中带有突出显示的文本.
  3. 默认情况下, " / en-US / docs /"插入到URL字段的开头. 在" / en-US / docs /"之后输入页面名称 . 页面名称不必与链接文本相同.
  4. 点击OK ,创建并插入链接.

如果该页面尚不存在,则链接显示为红色. 如果该页面确实存在,则链接显示为蓝色. 如果您要创建一个新页面,但是您想要的页面标题已经被获取,请检查是否有必要在此处编辑和改进页面是否有意义. 否则,请为您的新页面考虑一个唯一的标题,并为其创建一个链接. 请参阅页面命名指南以获取指导.

要在新页面中添加内容,请在保存并关闭编辑器后单击刚刚创建的红色链接. 新页面将在编辑器模式下打开,使您可以开始书写. 有关使用编辑器模式的更多信息,请参阅" 编辑现有页面" .

Refreshing page content

出于性能原因,有时需要缓存页面,从而妨碍了KumaScript宏的MDN支持以及来自其他页面的内容集成. 页面是从其源构建的,并且此输出被缓存以供将来请求. 从那时起,任何宏(模板)或集成(使用宏Page )都不会反映出以后对该宏,其输出或集成材料的内容所做的更改.

  • 要手动更新页面,请强制刷新Web浏览器. MDN检测到此情况,触发页面重建,获取更新的宏输出,并整合页面内容.
  • 您还可以配置页面以定期自动重建. 除非您希望页面经常更新,否则不要这样做. 有关详细信息,请参见页面再生 .

See also