Help:VisualEditor/User guide/zh

 如果您想要不實際編輯文章來試用視覺化編輯器，[ 本頁]可讓您隨意的進行測試. &#32; 在該頁面您不須擁有帳號便能使用視覺化編輯器.

入門指南：視覺化編輯器的工具列
center|950px|alt=視覺化編輯器的工具列螢幕截圖

border|950px|center

编辑参考文献
{| cellpadding="15"
 * colspan=2 |

决定使用的是哪个系统

 * 您的wiki可能使用三种注脚系统之一. 右侧显示的是最简单的系统，其中“”菜单不包含任何引文模板.  如果您的维基使用的是这套系统，那么您所需要了解的关于脚注的资讯在这个页面上.
 * border|center|200px
 * colspan=2 |
 * The second system has the same type of "" menu, but with several popular citation templates set up for quick access. 如果您的wiki使用该系统，那么您将在找到更多详情
 * border|center|200px
 * colspan=2 |
 * border|center|100px
 * 在第三个系统中，您再次通过按引用按钮开始. 然后会打开一个对话框，其中包括使用 citoid 服务的自动引用过程.  如果您的wiki使用此系统，您可以在找到更多详情
 * border|center|400px
 * colspan=2 |
 * border|center|100px
 * 在第三个系统中，您再次通过按引用按钮开始. 然后会打开一个对话框，其中包括使用 citoid 服务的自动引用过程.  如果您的wiki使用此系统，您可以在找到更多详情
 * border|center|400px
 * colspan=2 |
 * 在第三个系统中，您再次通过按引用按钮开始. 然后会打开一个对话框，其中包括使用 citoid 服务的自动引用过程.  如果您的wiki使用此系统，您可以在找到更多详情
 * border|center|400px
 * colspan=2 |
 * colspan=2 |

编辑现有的参考文献

 * 要编辑现有参考文献，请在它出现在文本中的位置按下它（通常为括号中的数字）. 您将看到用于创建此引用的模板的“”图标（书签）或图标（和名称）.  在任何一种情况下，按下“编辑”按钮都会打开一个对话框，您可以在其中编辑参考.
 * border|400px|center
 * colspan=2 |
 * For the "" icon, pressing "Edit" opens the Reference dialog. To start changing the reference information, press on it.
 * colspan=2 |
 * For the "" icon, pressing "Edit" opens the Reference dialog. To start changing the reference information, press on it.
 * For the "" icon, pressing "Edit" opens the Reference dialog. To start changing the reference information, press on it.

许多维基都使用模板来格式化参考以达到统一的参考格式标准. 如果 wiki 上的某个模板尚不支持引用菜单或未包含在常用模板中，当您要在模板编辑器中编辑该目标时会发现它的内容变为蓝色.

如果模板被使用，并且您点击参考资料信息，那么图标（拼图块）将显示一些信息. 点击“编辑”按钮以在模板迷你编辑器对话框中编辑模板内容.
 * border|center|400px
 * colspan=2 |
 * 如果在您点击参考资料后出现了一个用于标准模板引用的图标（在右侧有一个例子），那么点击“编辑”将打开模板迷你编辑器对话框.
 * border|center|400px
 * colspan=2 |
 * Inside the template mini-editor, you can add or remove types of information or change current content. Only fields (template parameters) that have content will show, initially. To add fields, press on "" at the bottom of the mini-editor.
 * border|center|400px
 * colspan=2 |
 * 完成后点击“”即可.
 * border|center|150px
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * 完成后点击“”即可.
 * border|center|150px
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

复用现有的参考资料

 * 如果页面有包含其他参考，如果这个参考适合你所印证的文段，你可以重新选择其进行参考引用.
 * 如果页面有包含其他参考，如果这个参考适合你所印证的文段，你可以重新选择其进行参考引用.

要复用一个现有参考资料，将您的光标放置在您希望添加用于那个引用的新参考资料（数字）的正文处. 然后点击“”菜单上的“复用参考资料”项.

(Note: If your wiki has the third footnote system described above, you'll see a "Re-use" tab, in a dialog, instead of a "Re-use" item on the "" menu.)
 * border|200px|center
 * colspan=2 |
 * 如果这里有很多参考，你能看见一个标签为“$input”的搜索栏，通过其可以只列出符合你需要的参考. 选择你所需要的参考.
 * border|400px|center
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

添加新的参考资料

 * 要使用“”菜单添加引用，在您希望添加它的文本位置上放置您的光标即可. 然后在菜单中选择适当的引用类型.
 * border|200px|center
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

使用“基础”引用

 * 如果你选中基础參考文獻项目，你将看到如图所示的内容.  在参考编辑器中，你能添加，修改或格式化你的引用.
 * 如果你选中基础參考文獻项目，你将看到如图所示的内容.  在参考编辑器中，你能添加，修改或格式化你的引用.

你能将参考归类到一个你指定的组中，然后在“”工具选定只显示该组的参考项.
 * border|400px|center
 * colspan=2 |
 * 如果您要在新引用中使用模板，请点击引用编辑器“”工具栏菜单中的 图标（拼图）.
 * border|center|200px
 * colspan=2 |
 * 接着，选择你需要的模板，添加并编辑它.
 * colspan=2 |
 * 接着，选择你需要的模板，添加并编辑它.
 * 接着，选择你需要的模板，添加并编辑它.
 * 接着，选择你需要的模板，添加并编辑它.

当您完成修改您的新模板后，点击“”返回参考编辑器，再点击“”返回您正在编辑的页面.
 * border|center|400px
 * colspan=2 |
 * 如果页面没有包含显示参考列表，你可以添加一个到你希望其显示的位置上.
 * 如果页面没有包含显示参考列表，你可以添加一个到你希望其显示的位置上.
 * 如果页面没有包含显示参考列表，你可以添加一个到你希望其显示的位置上.

将光标移动到你希望显示参考的位置（一般在页面的底部），开启“”目录并点击“”（表示为三本书本）按钮.
 * border|center|200px
 * colspan=2 |
 * 如果你参见了参考组，你可以在对话框中选择你希望参考列表需要显示的参考组.
 * 如果你参见了参考组，你可以在对话框中选择你希望参考列表需要显示的参考组.
 * 如果你参见了参考组，你可以在对话框中选择你希望参考列表需要显示的参考组.

参考资料列表对话框中的最后一部就是点击“”.
 * border|center|400px
 * colspan=2 |
 * colspan=2 |

使用标准引用模板

 * 如果您的 wiki 支持引用菜单，则这样添加引用很方便. （添加额外引用模板到您的本地wiki的指导说明在可用. ）
 * border|200px|center
 * colspan=2 |
 * 选择模板图标会进入可编辑所选模板的小型模板编辑器. 在显示最常用模板时强烈推荐的模板会用星号标记出来，其中有些并非必须的. 不会显示未使用的参数.
 * border|430px|center
 * colspan=2 |
 * 要添加附加参数，请在小型模板编辑器中往下滚动到“”选项，并点击它.
 * border|430px|center
 * colspan=2 |
 * 要添加附加参数，请在小型模板编辑器中往下滚动到“”选项，并点击它.
 * 要添加附加参数，请在小型模板编辑器中往下滚动到“”选项，并点击它.
 * 要添加附加参数，请在小型模板编辑器中往下滚动到“”选项，并点击它.

当您完成时点击“”.
 * border|200px|center
 * }

正在编辑图片以及其他媒体档案
{| cellpadding="15"
 * colspan=2 |
 * colspan=2 |

编辑图片

 * 要添加新的圖像（或其它媒體文件）至頁面中，單擊“”工具欄中的「」圖標. 圖像将添加到光标所在位置.
 * border|200px|center
 * colspan=2 |
 * 點擊“”圖標，打開一個對話框，可自動搜索維基共享資源與你正在編輯的頁面有關的媒體文件.
 * colspan=2 |
 * 點擊“”圖標，打開一個對話框，可自動搜索維基共享資源與你正在編輯的頁面有關的媒體文件.
 * 點擊“”圖標，打開一個對話框，可自動搜索維基共享資源與你正在編輯的頁面有關的媒體文件.

你可以查看其他媒體文件，通過更改對話框裏的搜索框的文本.

要选择文件，点击器缩略图即可.

该操作将图片插入到您正在编辑的页面上.
 * border|center|500px
 * colspan=2 |
 * 媒體對話框允許您添加或編輯媒體介紹，它可以包含格式與連結.
 * border|center|400px
 * colspan=2 |
 * 您还可以在媒体对话框中添加替换文本标题，这样可以帮助使用屏幕阅读器或禁用图像显示的用户.
 * border|center|400px
 * colspan=2 |
 * 您还可以在“”窗口中设置图像的各种参数，包括对齐方式、类型和尺寸.
 * border|center|400px
 * colspan=2 |
 * 當你完成後，點擊“”關閉對話框並返回到頁面編輯器.
 * border|center|150px
 * colspan=2 |
 * For an existing image, you can add or edit a caption or other settings by pressing on the image, then pressing on the "" icon that appears below the picture.
 * border|center|400px
 * colspan=2 |
 * 當你完成後，點擊“”關閉對話框並返回到頁面編輯器.
 * border|center|150px
 * colspan=2 |
 * For an existing image, you can add or edit a caption or other settings by pressing on the image, then pressing on the "" icon that appears below the picture.
 * colspan=2 |
 * For an existing image, you can add or edit a caption or other settings by pressing on the image, then pressing on the "" icon that appears below the picture.
 * For an existing image, you can add or edit a caption or other settings by pressing on the image, then pressing on the "" icon that appears below the picture.
 * For an existing image, you can add or edit a caption or other settings by pressing on the image, then pressing on the "" icon that appears below the picture.

You can resize an existing image by pressing on it, then moving the resize icon (the two-headed arrow on one or both bottom corners).

你还可以将一个图片拖放到页面上的位置或更低的位置上.
 * center|360px
 * }

编辑模板
The powerful MediaWiki template system lets you insert dynamic content, text from other pages, and much more. For a detailed explanation and examples, see the Templates help page.

In the VisualEditor you can search for a relevant template, add an invocation or transclusion on the page you’re editing and, if needed, add custom content using parameters.

Insert new template
{| cellpadding="15"
 * 要添加新目标到页面中，请把光标放在待插入的目标位置后点击工具栏“$insert”菜单中的“$template”（如拼图样的图标）按钮，以添加模板. Then open the menu and select "[[File:OOjs_UI_icon_puzzle-ltr.svg]] ". Alternatively, type two curly brackets {{ to open the same dialog.
 * border|300px|center
 * 输入你要添加的模板的名称，点击“”.
 * VisualEditor_Template_Search.png
 * colspan=2 |
 * 您还可以编辑页面上已有的模板. 当您按下模板以选择它时，它会变成蓝色，并且会出现一个带有“$template”图标（拼图）的框.  然后按“$edit”链接. When you select the template you want to edit, it turns blue, and a box appears displaying "[[File:OOjs_UI_icon_puzzle-ltr.svg]] ". Then select the "" link  or double click on the template itself to open the template.
 * VisualEditor_Template_Context_Menu.png
 * colspan=2 |
 * 阅读时看不到有些模板. 在可视化编辑器中，隐藏的模板显示为拼图图标. The name of the template will be shown next to the puzzle icon and both will be grayed out.
 * VisualEditor_Hidden_Templates.png
 * VisualEditor_Template_Context_Menu.png
 * colspan=2 |
 * 阅读时看不到有些模板. 在可视化编辑器中，隐藏的模板显示为拼图图标. The name of the template will be shown next to the puzzle icon and both will be grayed out.
 * VisualEditor_Hidden_Templates.png
 * 阅读时看不到有些模板. 在可视化编辑器中，隐藏的模板显示为拼图图标. The name of the template will be shown next to the puzzle icon and both will be grayed out.
 * VisualEditor_Hidden_Templates.png


 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

模板参数名

 * You’ll see this dialog box when you’re adding a new template or editing one already in place. What you see in the box depends on whether the template in question contains, helpful metadata added by other editors to make it easier to edit templates in the Visual Editor.
 * You’ll see this dialog box when you’re adding a new template or editing one already in place. What you see in the box depends on whether the template in question contains, helpful metadata added by other editors to make it easier to edit templates in the Visual Editor.

When a template contains TemplateData, the VisualEditor can use it to present annotated fields for you to fill in.

For templates that have some community-provided TemplateData, the VisualEditor displays a list of the named parameters and, often, descriptions and instructions explaining the meaning and required format for each parameter’s values.
 * Template_parameters_in_VisualEditor.png
 * colspan="2" |
 * For an existing template, you can edit the parameters shown in the dialog, and you can add parameters by pressing "", at the very bottom of the dialog.
 * Template_parameter_list_in_VE_(old_UI).png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Adding undocumented parameters

 * If you’re inserting or editing a template whose author hasn’t laid out its parameters in TemplateData, it has what we call “undocumented” or “unnamed parameters”. In these cases, you should consult the page for the template itself.  There you can learn how to correctly employ and work with all of the template’s parameters.  This includes learning the exact names of the parameters as written by the template author.
 * If you’re inserting or editing a template whose author hasn’t laid out its parameters in TemplateData, it has what we call “undocumented” or “unnamed parameters”. In these cases, you should consult the page for the template itself.  There you can learn how to correctly employ and work with all of the template’s parameters.  This includes learning the exact names of the parameters as written by the template author.

If you find in the documentation that the template expects parameters without have names, fill in numbers as placeholders for the parameter names using the undocumented parameter input, then add next to the values you want to provide as you normally would.

Example: * first unnamed parameter: “1” * first unnamed parameter’s value: “en_US” * second unnamed parameter: “2” * second unnamed parameter’s value: “yes”

If you accidentally include nonexistent, misspelled or erroneous parameters, the values you enter for those parameters won’t show up on the page you’re editing.
 * Template_without_TemplateData_in_VisualEditor_(old_UI).png
 * colspan=2 |
 * colspan="2" |
 * colspan="2" |
 * colspan="2" |

Autogenerated parameters

 * In this example, the template in question lacks TemplateData but it was possible to autogenerate the parameters. This means that the undocumented parameters have already been added for you, but the names may not be easily understandable and the dialog cannot display any directions or descriptions. As a result the dialog box provides a link to the template’s documentation, which should help you deduce and fill in the template’s various parameters.
 * Autogenerated_parameters_in_the_VisualEditor.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Editing multi-part template content

 * During editing, you may open template content consisting of multiple templates or a single template linked to some wikitext. This differs from the nested templates described below. In this case, the templates are better visualized as being stacked or connected.
 * During editing, you may open template content consisting of multiple templates or a single template linked to some wikitext. This differs from the nested templates described below. In this case, the templates are better visualized as being stacked or connected.

This content often contains “unbalanced templates,” templates which are incomplete on their own and need to be paired with some wikitext or another template in order to function.
 * Multi-part_template_content_in_the_VisualEditor.png
 * colspan=2 |
 * colspan="2" |
 * colspan="2" |
 * colspan="2" |

Nested templates

 * Templates can include other templates as the value for parameters. You’ll recognize it when you see a parameter whose value contains the double curly braces denoting a template.
 * Templates can include other templates as the value for parameters. You’ll recognize it when you see a parameter whose value contains the double curly braces denoting a template.

The VisualEditor can’t present this template within a template (a nested template) using the editor’s easy-to-use interface, so if you want to nest a template yourself, you’ll need to understand how to add the template by hand in wikitext into the appropriate parameter field.
 * Embedded_template_in_VisualEditor.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Completing your edit
Then you can preview your edit and make sure it looks the way you want and expect.
 * 当您完成时，点击“”以关闭对话框并返回到页面编辑器.
 * 当您完成时，点击“”以关闭对话框并返回到页面编辑器.

You may also see an error message, which (like the other TemplateData mentioned above) is community-provided content and may vary in usefulness. You may need to consult the template’s own documentation to get to the bottom of some errors. If you’re still having trouble, consider posting about your problem on the template’s talk page.
 * border|center|150px
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Editing on mobile

 * When editing a template on a page using the VisualEditor on a mobile device, you’ll see that the sidebar starts out hidden. You can make it visible by pressing the “Show/hide options” button.
 * When editing a template on a page using the VisualEditor on a mobile device, you’ll see that the sidebar starts out hidden. You can make it visible by pressing the “Show/hide options” button.


 * VisualEditor_template_editing_on_mobile.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

替换模板

 * When you insert a template in a wiki page, its content and appearance are reevaluated every time the page loads, based on the template code and the values of its parameters. This means if someone updates the code of a template, then every page which uses that template will also get updated when they publish.
 * When you insert a template in a wiki page, its content and appearance are reevaluated every time the page loads, based on the template code and the values of its parameters. This means if someone updates the code of a template, then every page which uses that template will also get updated when they publish.

There’s another, much less common way to use templates, though, and that’s to substitute a template. Doing this permanently includes the template content just as it appears at the moment you insert it. It will not update if the template code is later changed.

Most users won’t ever need to resort to substitution. Substitution is typically only useful when you need to capture the exact appearance of one version of a template, such as when content is under development and needs evaluation.

To substitute a template in the VisualEditor, insert a template using the name syntax. (Autocomplete doesn’t work in this case.) Then press the blue “Add template” button.

When you’re finished, press “Insert”, which will insert the template content as you see it.
 * SUBST_in_VE.png
 * }

键盘快捷键
有许多编者习惯使用快捷键辅助编辑，VisualEditor的快捷键能帮助编者比起逐个点击工具栏按钮更快地进行编辑操作.