blob: 5b2c6762f3c451d1e196afd4e7247d2a5b4346aa (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
---
title: 写作内容
slug: MDN/User_guide/Writing
tags:
- 写作内容
translation_of: Archive/Meta_docs/Writing_content
---
<p>在MDN上经常会有一些东西需要加进来和更新。不管是一个全新出彩API的文档或者一个旧API的细微修改，你会找到很多可以出力的机会。关于怎么使用编辑器，和我们为了自动化结构与内容格式使用的宏系统的细节，请参看<a href="/en-US/docs/Project:MDN/Contributing/Editor_guide" style="line-height: 1.5;" title="/en-US/docs/Project:MDN/Contributing/Editor_guide">MDN editor guide</a>。</p>
<h2 id="编辑一个已经存在的页面">编辑一个已经存在的页面</h2>
<p>如果你找到一个想去修正的页面，简单点击右上方的“编辑”按钮。这会打开一个 <span style="line-height: 1.5;">WYSIWYG编辑器来帮助你修改页面内容。</span></p>
<p>有很多原因你会去编辑一个已经存在的页面：</p>
<ul>
<li>你发现一个错误或者错字。</li>
<li>你想把某件事重述让人更容易理解。</li>
<li>页面的布局或者格式混乱。</li>
<li>API的文档发生了变化，文档需要相应作出更新。</li>
<li>你想要增加一些信息，关于一个API在多个浏览器的性能表现差异。</li>
<li>你想要增加或者改进一个代码范例</li>
<li>文章是一个存根，或者仅仅丢失了一些重要的细节。</li>
</ul>
<h2 id="增加一个新页面">增加一个新页面</h2>
<p>这是个大的任务！<span style="line-height: 1.5;">在MDN上</span><span style="line-height: 1.5;">添加一个新的页面会让Web爱上你，拥抱你。这里有一些显而易见的原因，包括给未文档化的API做文档，增加一个新的教程或者?做一个主题的指南。</span></p>
<p>当你登陆后，按以下步骤去创建一个新的页面在MDN上:</p>
<dl>
<dt>
点击一个 "missing page" 链接</dt>
<dd>
当你浏览MDN的时候，你会偶然发现有些链接的页面还不存在。很多时候，当我们创建文章，我们会把需要创建的页面链接加进去，即使它们还没做好。这有助于我们跟踪那些最终需要完成的事，虽然有时候会花一些时间回过去完成它们。你可以随意去做！只要点击这些链接，你会直接进入新网页的编辑器。</dd>
<dt>
</dt>
<dt>
创建一个子页面</dt>
<dd>
在每篇文章的最右上角是“This Page“下拉菜单。菜单里面有”New sub-page“选项。点击这个选项会打开一个页面编辑器，在这个新的页面在站点层次上的父页面是你选择”New sub-page“那个页面。只需填写标题和标签，就可以开始写正文了。</dd>
<dt>
创建一个副本</dt>
<dd>
你也可以克隆一个已经存在的页面，使用“This page“下拉菜单的”Clone this page“选项。点击该选项会复制当前页面，其父页面和当前页面完全相同。接着页面上会打开编辑器，你就可以设置页面的标题和标签，然后编辑页面的内容。给一个现有站点参考区域增加一个新的页面，通常是一个好的方式。比如，这会给你内容布局的样式。</dd>
<dt>
创建一个链接到还没存在的页面，然后点击它</dt>
<dd>
这有点儿混合模式。因为每个页面应该被某处链接到，你可以从给一个新的文章创建一个已有页面的链接开始，然后保存页面。你可以点击你刚刚插入的链接，接着在打开的编辑器中写新的文章。</dd>
</dl>
<p> </p>
<p> </p>
<div class="note">
<p><b>注意：如果你没有登录，当你想要查看未存在的文章时，会跳出404错误提示，而不是跳出新页面的编辑器。</b></p>
</div>
<h2 id="寻找信息">寻找信息</h2>
<p style="margin-left: 40px;">有很多信息没有出现在这里。有时候这些信息你很难搜寻到，但你恰好很需要用到，这里有一些提示来帮助你。</p>
<dl>
<dt>
模块化所有者列表</dt>
<dd>
Mozilla的项目在一个“模块所有者”基础上进行；每一个重要的组件都有一个或者多个所有者负责它的进展。这些所有者往往是信息的最好来源--至少是个好的方式找到对的人来讨论。</dd>
<dt>
Mozilla源交叉参考</dt>
<dd>
MXR（Mozilla cross-reference的缩写）能让你得到所有Mozilla工程的源代码（有些事例除外，比如Firefox OS是托管在Github上）。代码和有关评论常常是信息的重要资源。</dd>
<dt>
Mozilla wiki</dt>
<dd>
The Mozilla wiki（常被称作“wikimo“）是过程和设计的一些笔记，草稿，计划和初步的方案等。尽管看起来一团糟，但也是宝贵的知识库。</dd>
</dl>
|
