帮助:可视化编辑器

可视化编辑器（英语：Visual Editor，缩写：VE）是本wiki的一种编辑器。不同于默认的源代码编辑器，使用可视化编辑器不需要学习任何wikitext。可视化编辑器会把正在编辑的页面显示成接近于正常阅读页面的样子。这份指南提供带插图的、一步步的编辑器介绍。

需要注意，可视化编辑器仍在开发中，因此有一些已知的限制和bug，比如：可视化编辑器无法在讨论页中使用；编辑大型页面时，可视化编辑器可能会比源代码编辑器慢很多，甚至完全无法加载。也因为编辑器还在开发中，你需要复查你的更改，以保证一切显示为你想要的样子。

本指南可能会滞后于新更新的发布。

可用性

可视化编辑器可用于以下类型页面（命名空间）：

• 条目（主空间）
• 用户页
• 分类页
• 文件页

讨论页中无法使用可视化编辑器，只能使用源代码编辑器替代。

第一步：启用可视化编辑器

本wiki默认启用可视化编辑器。注册之后，你可以在自己的参数设置中检查可视化编辑器的启用状态。你也需要一个支持可视化编辑的浏览器，你家最新的Chrome、Edge、Firefox或者Safari，无论是手机还是电脑，都支持可视化编辑。

参数设置中也可以禁用可视化编辑器，这样“编辑”标签就会打开源代码编辑器。

也可以通过在地址栏链接的后面加上 ?veaction=edit 启用可视化编辑器。没有选择启用可视化编辑器的用户同样可以这样做。

打开可视化编辑器

点击页面顶端的“编辑”标签会打开可视化编辑器。

几秒后编辑器就会打开，很长的页面需要消耗更多时间。

点击“编辑源代码”标签将以传统的wikitext源代码编辑器编辑。

---

也可以点击章节标题右侧的“编辑”链接来打开可视化编辑器。

起步：可视化编辑器工具栏

可视化编辑器工具栏在编辑时贴靠在页面顶部（或条目标题之上），包括一些类似图标：

---

撤销或重做你的更改。

---

标题下拉菜单：可以让你更改段落格式。把鼠标指针放在段落中（不需要选择文本），然后点击此菜单中的任意一项，段落样式就改好了。标准的章节标题是“标题”格式，子章节是“标题2”、“标题3”…以此类推。页面文本的一般格式是“段落”。

---

格式化：点击“A”打开菜单。

• “粗体”（B）选项：将选中的文本改为粗体。
• “斜体”（I）选项：将选中的文本改为斜体。
• “移除”选项：移除所选文本的所有格式。
• “更多”选项：展开菜单，显示更多格式。
• “上标”（x^I）选项：将选中的文本变得更小，并将其略微提高。
• “下标”（x_I）选项：将选中的文本变得更小，并将其略微降低。
• “删除线”（S）选项：在选中文本的中部添加一条实线。
• “代码”（{}）选项：将选中的文本变为等宽字体，并添加边框和边距来区分周围的文本。
• “下划线”（U）选项：在选中文本的下方添加一条实线。
• “语言”（文A）选项：标记选中文本的语言（如希伯来语）和书写方向（如从右到左）。
• “大”（A^▲）选项：增大所选文本，不建议使用。在确实需要更改文本大小时建议用{{Resize}}或{{Font}}，或者直接改CSS。
• “小”（A^▼）选项：缩小所选文本，不建议使用。在确实需要更改文本大小时建议用{{Resize}}或{{Font}}，或者直接改CSS。
• “更少”选项：收起展开的菜单。

如果没有选择文本，在点击“A”打开菜单，选择格式后，该格式会应用到你开始输入的文本，无论光标位于何处。

---

链接工具：这个锁链图标是链接工具。点击它之后（一般会先选择一些文本）会打开“链接”对话框。

---

引用菜单：“引证”菜单用于添加行内引用（也称“脚注”、“参考”等）。

---

列表和缩进：头两项可以把文本格式化为“无序列表”和“有序列表”，后两项可以增加或减少列表项的缩进。

---

插入：“插入”下拉菜单的选项在不同的项目中可能存在差异。下面是可能在此菜单中出现的所有选项：

• “图像与媒体”选项（山的照片）：打开“媒体”对话框。
• “模板”选项（一片拼图）：插入模板。
• “表格”选项：插入表格。
• “备注”选项（圆中间的感叹号）：插入读者不可见的注释，只能在编辑模式中看见，用感叹号图标表示。
• “图库”选项（照片集）：插入图库（一系列图像的组合）。
• “您的签名”选项：插入你的签名，包含你的用户名、用户页和用户讨论页的链接和签名时间戳。
• “参考资料列表”选项（三本书）：打开一个对话框，可以指定读者所见的页面参考资料的显示位置。每个页面一般只用指定一次。

如果要移除插入的图像或模板，只需要选择要移除的项目，并在按下键盘的Delete键。如需移除表格，请选择表格并点击出现在屏幕上的红色“删除”按钮。

---

插入特殊符号：“特殊字符”（Ω）按钮：点击后会在工具栏下方显示包含许多特殊字符的对话框。点击一个字符就会将其插入到光标之后。特殊字符包括一些标准符号、变音、字母和数学符号。

---

编辑提示下显示页面的所有编辑提示。

---

页面选项菜单（三条平行横线）下有一些用来调整页面设置的选项：

• “分类”选项中可以添加分类、设置页面排序方式（在分类中的显示位置）。
• “页面设置”选项中可以将页面设为重定向、调整目录的显示设置、禁用标题旁边编辑链接以及将页面定义为消歧义页面。
• “高级设置”选项中可调整搜索引擎对页面检索的设置，显示用于添加新部分的选项卡和显示的标题。
• “语言”选项显示链接到该页面的其他语言的页面列表。
• “使用的模板”选项中列出了此页面上使用的每个模板及其链接。

菜单下的“选项”选项也可以打开位于默认位置的“选项”对话框。此外，页面选项菜单中也可以用从右至左视图，或从左至右视图来查看页面。点击“查找和替换”会打开一个对话框，可以在其中输入词语或正则表达式，并根据设置的选项查找/替换它们。

---

切换编辑器按钮（铅笔）可以用来在可视化编辑和源代码编辑模式之间切换，不会丢失你所做出的更改。

保存更改

在完成编辑后，点击工具栏上的蓝色“保存更改…”按钮，就会开始保存编辑流程。要取消所有更改，只需要关闭标签页或按Esc键。

---

点击“保存更改…”按钮会打开一个对话框，可以在文本框中写下此次编辑的摘要，将此次编辑标记为小编辑，或将此页面加入你的监视列表。摘要文本框与源代码编辑器中的“摘要：”字段相同。

可以使用“复核您的更改”按钮在保存之前检查你的更改，以确认页面是否和你预期的一样。这与源代码编辑器的“显示预览”按钮相似。

点击“继续编辑”按钮（✗）会返回编辑界面。你可以在之后保存并发布更改。

编辑链接

点击工具栏上的“链接”按钮（锁链）可以添加链接，也可以用键盘快捷键Ctrl+K（Mac是⌘ Command+K）添加。

选中（高亮）了文本后再按“链接”按钮的话，选中的文本会变为链接。如果链接只有一个词，可以选中那个词或者直接把光标放在词中，再点击链接按钮时该词就会变为链接。

---

使用按钮或快捷方式时，编辑器会打开一个对话框，可以在其中输入链接。

可视化编辑器会尝试查找与选中文本相似的页面，以便快速添加内部链接。

---

在输入或选择链接之后，按下↵ Enter或对话框中的“完成”按钮，创建链接的过程就完成了。链接会立即在编辑器中显示，但和本次编辑中的其他改动一样，在发布编辑之前链接不会保存。

---

创建指向其他网站的链接（外部链接）的方法差不多：选择“外部链接”标签，并在文本框中输入URL。

---

没有标签的外部链接长这样：[1]。可以通过将光标放置在任意字词以外（例如在空格之后）来添加这种链接。点击按钮或按快捷键打开链接工具，在框中键入URL，然后按“完成”按钮插入链接。

---

如果需要更改或删除现有链接，先点击链接文本，会出现编辑链接的对话框。也可以使用Ctrl+K快捷键。选中的链接会带有蓝色背景和边框。

在编辑对话框中可以更改链接指向。点击对话框右上角的“删除”按钮可以移除链接。点击对话框中的链接可以在新窗口中打开它。（可以用来检查外链）

要退出链接标签（文本显示为链接）或在此链接之后继续编写，可以摁→：

• 按一次将退出链接编辑对话框，并将光标放在链接元素的末尾（蓝色框，用于编辑此元素）。
• 按两次会将光标放在链接的元素之后，准备输入文本的其余部分。

如需编辑已存在链接的标签，请将光标移动到链接标签内，并输入新标签。但如果你需要替换整个标签，请注意：

• 如果选中（高亮）了整个链接标签，输入文本后链接会被删除。
• 一种不会删除链接的方法是，将光标放置在链接标签中，并按← Backspace和Delete键（把标签删除了就好），删除标签后，链接位置会有窄的蓝色链接区域。现在就可以输入新标签了，链接也会被保留。
• 或者直接点击“更改文本”按钮并输入新标签，这样也可以替换整个标签。

也可以添加指向分类页、文件页等的链接，只需要在前面输入带命名空间前缀的页面名就行。不像源代码编辑器，这里不用带前置冒号。

编辑参考资料

本wiki使用最简单的脚注体系，在引证菜单下没有引用模板。

编辑现有参考资料

编辑现有参考资料时，在文本中参考资料出现的位置点击它（通常为中括号包裹的数字），会出现包含“参考资料”的弹出窗口。点击弹出窗口中的“编辑”按钮会打开一个对话框，可在其中编辑参考资料。

---

按下“编辑”按钮会打开“参考资料”对话框，在这里面编辑参考信息。

编辑文本框中的内容就可以了，也可以用工具栏或快捷键对输入的文本进行格式化。

---

应用更改

在编辑完成后点击“应用更改”按钮。

复用现有参考资料

如果页面包含其他参考资料，并且它适合你需要印证的文段，你可以重新使用它进行参考引用。

复用参考资料时，将光标放置在文中你希望添加新参考（数字）的位置，然后在引证菜单中点击“复用”。

---

在“参考资料”对话框中找到你希望复用的参考资料，并选择它。如果有很多参考资料，可以使用搜索框（标签为“在当前所有引述内搜索”）来列举出包含特定文本的参考。

添加新参考资料

要使用引证菜单添加引用，将光标放置在你希望添加引用的地方，然后点击“基本”。

使用“基本”引用

使用基本引用会显示这个对话框，在参考资料表编辑器中可以添加引用文本，也可以做一些格式化。

可将参考归类到一个你指定的组中，虽然一般情况下这项留空。参考归类到一个组之后，在“参考资料列表”工具里可以选择显示特定引用组。

---

在参考资料对话框中可以给引用里添加模板，点击编辑器工具栏中插入菜单下的模板项（一片拼图）会打开模板编辑器。

然后寻找你希望使用的模板，并添加、编辑它，和编辑正文中的模板一样。（更多关于编辑模板的信息请参考下面的#编辑模板章节。）

在完成模板编辑后，按“应用更改”来回到参考资料编辑器，再按一次“应用更改”会返回正在编辑的页面。

---

如果页面中不存在参考资料列表（比如你正在添加页面的第一个参考资料），你需要设定参考资料列表及其文本在哪儿显示给读者。

将光标放在希望显示参考资料的位置（通常在页面底部），打开“插入”菜单并点击“参考资料列表”选项（三本书）。

---

如果使用了多组参考资料（比较少见），可以在此对话框中选择特定组。只有属于该组的参考资料才会显示在设置的列表中。

设置参考资料列表的最后一步是点击“应用更改”。

编辑图像和其他媒体文件

编辑图像

要在页面中添加新图像（或其他类型的媒体文件），打开“插入”菜单并点击“图像与媒体”选项（山的照片）。图像会添加至光标所在的位置。

---

按下“图像与媒体”后打开的对话框会自动搜索wiki上和正在编辑的页面相关的媒体文件。（这也就是为什么强烈建议上传文件时给它取个相关的名字，“抹岚Potato_duang家-2022-01-01.png”比“Screenshot-2022.01.01-18:45:15.png”不知道好找到哪里去了）

更改对话框搜索框中的文本可以改变搜索结果。

点击图像缩略图就能选择文件。

选择的文件会放置在正在编辑的页面中。

---

在选择的图像插入页面后，另一对话框会打开。此对话框中可以添加、编辑图像描述。图像描述可以包含格式和链接。

---

也可以在媒体对话框中设置替代文本。替代文本会在图像无法加载时显示，它可以帮助网络环境不好的用户、禁用图像显示的用户，和使用屏幕阅读器的用户。

---

在对话框的“高级”界面中可以设置多种图像参数，包括图像如何对齐、图像类型和尺寸。

---

完成后，点击“插入”关闭对话框并返回正在编辑的页面。

插入

---

在现有图像上点击，并按下弹出窗口中的“编辑”按钮也会打开媒体对话框，这样就可以添加、更改该图像的描述和其他设置。

点击现有图像并拖动调整图标（一个或两个底角上的双向箭头，⤢/⤡）可调整图像尺寸。

图像也可以拖放到页面上更高/更低的位置。

上传图像

在媒体对话框的“上传”标签页内可以上传图像，还可以将图像拖动到编辑器内，或从剪贴板中粘贴图像。

---

点击“选择一个文件”按钮并选择你电脑中的图像。可以输入文件名，或将图像拖进此框内。如果直接将图像拖进编辑器中，或者从剪切板中粘贴了一张图像，该标签页会自动打开。

---

你需要描述此图像并给其添加分类，这样其他人可以才能找到它。

---

一切完成后，图像会插入到页面中。

添加媒体图库

要添加新媒体图库（画廊）的话，打开“插入”菜单并点击“图库”选项（照片集）。若没有在菜单中看见此选项，代表wiki尚未提供可视化编辑器的此项功能。

---

选择现有图库可以编辑此图库。在弹出的“图库”窗口中按下“编辑”按钮，会打开图库编辑器，图库中所有图像都包含在其中。

图库编辑器有两个标签页：“图像”标签页可以添加图像，编辑每个图像的描述和替代文本；“选项”标签页可以设置图库的显示模式、标题、图像尺寸等应用于整个图库的设置。

拖动图库编辑器中的图像可以给图像排序。

点击“应用更改”按钮后会退出图库编辑器。现在你应该可以在页面中看见你做出的更改了，图库也会这样显示给读者。

请记住，退出图库编辑器不会发布您的更改。与使用可视化编辑器进行的其他更改一样，必须发布整个页面才能发布你的作品。

编辑模板

MediaWiki强大的模板系统可以在页面中插入动态内容、来自其他页面的文本等等。模板的详细解释和示例可参见模板帮助页面。

在可视化编辑器中，你可以搜索相关模板，在正在编辑的页面中添加调用或嵌入，并在需要时使用参数给模板添加自定义内容。

插入新模板

要在页面中添加新模板的话，先把光标放置在你希望插入模板的位置，然后在“插入”菜单下选择“模板”。在编辑器中输入两个左大括号（{{）也会打开同一对话框。

在对话框的搜索框中输入模板名称或相关关键字，找到你需要的模板。下拉菜单中会显示在名称或描述中包含搜索项的结果。即使你不知道模板的确切名称，这应该也能帮助你找到想要的模板。

如果使用关键字找不到模板，可以在wiki中查找包含类似内容的页面（比如要写聚落就可以查看其它聚落的条目），并查看/编辑该页面的源代码，以确认其包含哪些模板。找到所需模板的名称后，就能把它输入到搜索框，并插入它。

---

也可以编辑页面上的现存模板。点击你希望编辑的模板后，模板会变蓝，并且会弹出以“模板”作为的标题的窗口。点击弹出窗口的“编辑”按钮或双击模板本身来打开模板编辑对话框。

---

有些模板在阅读时不可见。在可视化编辑器中，此类隐藏模板依旧会显示，你可以点击并编辑或删除他们。模板名称会显示在拼图图标旁边，并且图标和名称都会显示为灰色。

模板参数

在添加新模板或编辑现存模板时会看见此对话框。在对话框中看见的内容取决于模板是否包含模板数据。模板数据是其他编者为模板添加的有用元数据，可以帮助可视化编辑器编辑模板。

在模板包含模板数据时，可视化编辑器可以根据它生成带注释的字段，以供填写。

对于具有社群提供的模板数据的模板，可视化编辑器会显示命名参数的列表，通常还有模板描述，以及解释每个参数/参数值的含义、填写格式等的说明。

---

这里显示的模板不含模板数据，可视化编辑器根据模板源代码内容生成了一些参数。这些参数可能不容易理解，也可能含有同一参数的多个别名。对话框中含有指向模板文档页的链接。阅读文档可以获取模板可能含有的参数的信息，以及应该给参数填写何值。

也可以添加未记录的参数，如果输入了不受模板支持的参数，该参数会被忽略。对于编号参数，参数名应该是数字。第一个编号参数的名称是1，第二个是2，以此类推。

---

在编辑现存模板时，可以修改对话框中显示的参数，也可以通过点击对话框底部的“⧼visualeditor-dialog-transclusion-add-param⧽”添加参数。

---

当模板嵌入其他模板时，这些子模板将出现在显示它们的参数中。可以在参数字段中编辑或删除它们。

按照添加参数的步骤添加新的子模板。可能需要检查模板文档，以确保子模板受支持。嵌套模板只能以wikitext形式编辑，可视化编辑器尚未提供功能（参见phab:T52182）。

完成编辑

完成后，点击“应用更改”（或“插入”）关闭对话框并返回编辑页面。

应用更改

替换引用模板

在wiki中插入模板时，页面在每次加载中，模板都会根据其代码和参数值重构其内容和外观。这意味着模板的代码更新后，使用该模板的所有页面也会跟着更新。

不过还有另一种不常见的使用模板的方法，就是替换引用模板。这样做可以永久保留模板内容，就像插入时所显示的那样。如果模板代码稍后被更改，被替换引用的模板也不会更新。

多数用户永远都不会使用此功能，替换引用通常只在需要捕获模板的一个版本的确切外观时有用，例如当内容正在开发并需要评估时。

在模板需要被替换引用时，在模板名前输入subst:（包括冒号）。

自动补全不会与subst:一起工作。如果希望使用自动补全，那就先找到你希望使用的模板，再在模板名称前添加subst:。

然后点击“添加模板”按钮。

像往常一样，添加参数，点击“插入”。在点击“应用更改”之后，模板就会在页面中展开。

移除模板

在可视化编辑器中移除模板非常方便，只需要点击模板，并按← Backspace或Delete键，模板就会被删除。

编辑列表

可视化编辑器可以创建列表，或者更改现存列表的格式。有两种列表：无序（项目符号）列表和有序（数字编号）列表。

要创建列表，只需要打开工具栏的“结构”下拉菜单（图标是三条左边带点的平行横线），并根据需要使用头两项中的一项。或者，如果已经在单独的行上输入了列表，那就选中（高亮）此列表，然后点击菜单中的任意一项。

也可以用类似于写wikitext的方式直接在页面中生成列表：创建无序列表时在行首输入“*”，有序列表在行首输入“#”或“1.”，并加一个空格，就会自动生成对应类型的列表。

---

行星的分类：

• 类地行星
• 巨行星
  • 气态巨行星
  • 冰巨行星

---

内太阳系行星：

1. 水星
2. 金星
3. 地球
4. 火星

此处显示的是两种类型的列表：无序（项目符号）和有序（数字编号）。

---

行星的分类：

• 类地行星
• 巨行星
• 气态巨行星
• 冰巨行星

如果需要改变现存列表项的缩进等级，先选中需要更改的列表项。

---

行星的分类：

• 类地行星
• 巨行星
  • 气态巨行星
  • 冰巨行星

然后使用结构菜单中的后两项，或者按Tab ↹。（Tab ↹增加缩进等级，⇧ Shift+Tab ↹减少）

这里显示了增加缩进的结果。

---

太阳系的行星：

• 类地行星，4颗
  1. 水星
  2. 金星
  3. 地球
  4. 火星
• 气态巨行星，2颗
  1. 木星
  2. 土星
• 冰巨行星，2颗
  1. 天王星
  2. 海王星

如果列表的缩进等级不同，甚至可以混合有序和无序列表。

编辑表格

可视化编辑器可以插入、更改表格。

你甚至可以把你电脑上的逗号分隔值（.csv）文件拖进可视化编辑器里来导入表格。

---

点击插入菜单下的表格项后，可视化编辑器会向页面中插入默认的4乘4空表格。

现在可以使用“表格”弹出窗口，可以在表格顶部添加标题。

---

在单元格上点击一次会选中它。

---

点击两次可以编辑单元格内容。另一种方法是选中单元格后按↵ Enter。

点击其他地方结束编辑单元格。

---

点击出现在表格行/列前的箭头，可以选择删除此行/列。

---

合并单元格：选择数个单元格，然后在表格窗口中选择“合并”。

---

合并单元格只会保留一个单元格的文本，其他的都会在合并后被删除。如果发现希望保留的文字被删掉了，就撤销并把它们移/复制出来，再重新合并。

---

也可以分割先前合并的单元格，拆分后，合并前单元格的所有内容都会保留在第一个单元格中。可以根据需要，将文本复制粘贴到其他单元格。

编辑分类

要编辑分类，在工具栏的“页面选项”菜单（三条平行横线）下点击“分类”选项。

---

点击“分类”选项后会打开一个对话框，里面列出了页面现在的分类，可以在此添加、删除分类。

也有一个改变页面默认排序关键字的选项，它决定了页面与同一分类中的其他页面一起列出时的显示位置。

举个例子：条目“George Washington”（乔治·华盛顿）的默认排序关键字是“Washington, George”。在“美国总统”分类中，此条目列在字母“W”而不是“G”下面。

---

要为页面添加分类，请在“添加分类”一项中输入分类名。在输入时，编辑器会搜索匹配的现存分类，也可以添加一个尚不存在的分类。没有为分类创建页面时，页面分类会显示为红色链接。

寻找条目分类可查看wiki的分类索引。

---

点击现有分类并按下弹出窗口中的“移除”按钮（垃圾桶）可删除分类。

此窗口中也可以为该分类设置特定排序关键字，它会覆盖默认排序关键字。

---

完成后，点击“应用更改”按钮来返回页面编辑器。

应用更改

编辑页面设置

要编辑页面设置，在工具栏的“页面选项”菜单（三条平行横线）下点击“页面设置”选项。

---

点击“页面设置”选项后会打开一个包含几种设置的对话框。

---

激活“重定向该页面至”复选框并输入目标页面名称，可使本页面重定向至目标页面，阅读此页面的读者会被带到目标页面。

底部的选项表示当目标页被重命名时不更新该重定向，很少使用。

---

可以通过选择“显示目录”按钮组中的任意一项来更改目录的显示设置。默认是“需要时”，在页面有3个及以上标题时会显示目录。

---

也可以设置章节标题旁的编辑链接的显示状态。

---

完成设置后点击“应用更改”按钮来返回页面编辑器。

应用更改

编辑其他特殊项目

可视化编辑器尚未完全支持如诗、描述列表和<div>…</div>等类型的项目。

---

多数情况下，可以编辑现存项目，但不能在可视化编辑器中插入新的。

在完全支持它们之前，你可以从另一个页面复制，或直接用源代码编辑器写wikitext。

在可视化编辑器和源代码编辑器之间切换

点击工具栏右侧“切换编辑器”（铅笔图标）下的“源代码编辑”选项切换到源代码编辑器。

---

切换后会显示页面当前版本和你在可视化编辑器中的编辑结果之间的差异。如果点击了“放弃编辑”，就只会看见源代码编辑器。

向下滑动就能看见wikitext编辑区域。

---

也可以从源代码编辑器切换到可视化编辑器，只需要点击源代码编辑器工具栏右边的“切换编辑器”菜单，并选择“可视化编辑”。

键盘快捷键

许多编者习惯于直接输入维基文本，特别是粗体、斜体和wiki链接。键盘快捷键能帮助编者——比起逐个点击工具栏按钮——更快地进行编辑操作。下表列出了可视化编辑器的常用快捷键。

操作	Windows/Linux 快捷键	Mac快捷键
粗体	Ctrl+B	⌘ Cmd+B
斜体	Ctrl+I	⌘ Cmd+I
插入链接	Ctrl+K	⌘ Cmd+K
复制	Ctrl+C	⌘ Cmd+C
剪切	Ctrl+X	⌘ Cmd+X
粘贴	Ctrl+V	⌘ Cmd+V
撤销	Ctrl+Z	⌘ Cmd+Z
重做	Ctrl+V	⌘ Cmd+V

点击工具栏中“帮助”菜单（图标为问号）下的“键盘快捷键”选项可查看完整键盘快捷键。

参见

• 维基百科上的可视化编辑器帮助文档（中文，英文）
• MediaWiki wiki上的帮助文档