跳转到内容

帮助:编辑

This page is semi-protected.
来自维基教科书,为开放世界而开放的书籍
(从 Wikibooks:REFS 重定向)

维基教科书是一个 wiki,这意味着任何人都可以轻松地编辑任何未受保护的页面,并将这些更改立即保存到该页面。在您第一次编辑后,您就成为维基教科书编辑!若要请求对受保护页面的更改,您可以将您的建议添加到讨论页。如果您只是想尝试一下,请在 沙盒 中进行操作。

编辑维基教科书页面非常容易。只需点击维基教科书页面顶部的“编辑”选项卡。这将带您到一个新页面,其中包含一个文本框,其中包含原始页面的可编辑文本。完成后,在编辑框下方的一个小字段中写一个简短的编辑摘要。您可以使用速记来描述您的更改,完成更改后,按“显示预览”按钮查看更改后的外观。您还可以通过按下“显示更改”按钮查看您编辑的页面与页面之前版本之间的差异。如果您对看到的内容满意,请大胆地按下“保存页面”按钮。您的更改将立即对其他维基教科书用户可见。

当您转到编辑页面并选择“编辑”选项时,您会看到的内容。

编辑页面的组成

编辑页面包含以下部分

编辑工具栏

编辑文本框上方的编辑工具栏可帮助您生成维基标记,即用于在维基页面上设置文本样式的指令。在编辑页面时看到的编辑文本框上方的编辑工具栏中,如果您点击“帮助”,则可以查看维基标记可以实现的效果。另一种了解如何生成特定效果的方法是,点击包含您希望复制的效果的页面上的“编辑”,然后查看使用了哪些标记。

名称 标记 显示
基本
粗体
Make text '''bold'''
使文本加粗
斜体
Make text ''italic''
使文本倾斜
下划线
Make text<u>underlined</u>
使文本下划线
删除线
<s>Strike out</s> text
删除 文本
链接
Link to [[Help:Contents|a page]], [[#Sections|a section of a page]] or an [http://www.wikimedia.org external page].
链接到 页面页面的某个部分外部链接
嵌入 文件
[[File:Vector toolbar insert image button.png]]
插入 参考文献
Example text<ref>It is a note!</ref>
示例文本[1]
签名
Thanks guys --~~~~
谢谢大家 --Example 2005年11月27日 (星期日) 07:46 (UTC)[回复]
高级
标题 不同级别的标题的下拉列表
== Level 2 (Section heading) ==
=== Level 3 ===
==== Level 4 ====
===== Level 5 =====
二级标题 (章节标题)
三级标题
四级标题
五级标题
文本类型 不同类型的文本或编程代码的下拉列表
<tt>Teletype text</tt>, <code>inline code</code>, <source lang="text">generic source code</source>
电传打字机文本, 内联代码,
generic source code
插入无序 列表 项目
* Bulleted list item
  • 无序列表项目
插入有序 列表 项目
# Numbered list item
  1. 有序列表项目
文本缩进
:Indented line
缩进行
忽略维基标记
<nowiki><math>2^3</math></nowiki>
<math>2^3</math>
插入新行
 example <br /> text
示例
文本
大文本
<big>Big text</big>
大文本
小文本
<small>Small text</small>
小文本
上标文本
<sup>Superscript text</sup>
上标文本
上标文本
<sub>Subscript text</sub>
下标文本
插入图片 图库
<gallery>
File:Example.jpg|Caption1
File:Example.jpg|Caption2
</gallery>
插入 表格 (打开一个配置窗口,选择行和列的数量以及其他一些选项)
{| class="wikitable"
|-
! Header text
|-
| Example
|}
标题文本
示例
页面 重定向
#REDIRECT [[WB:HELP]]
#REDIRECT WB:HELP
查找和替换 打开查找和替换窗口

编辑摘要

一个编辑摘要是对维基教科书页面编辑的简短说明。当你编辑一个页面时,在主编辑框下方和“保存页面”按钮上方有一个小的文本输入框,它被标记为“编辑摘要”。编辑摘要显示在更改列表中(如 页面历史记录监视列表),以及 差异页面的顶部。

填写“编辑摘要”框,或者在 部分编辑 的情况下添加一些内容,这是一个良好的做法,因为它可以帮助其他人理解你编辑的意图。为了避免意外地留下空白的编辑摘要,如果你创建了账户,可以在你的 用户偏好设置 中的“编辑”选项卡中选择“在输入空白编辑摘要时提醒我”。

始终提供编辑摘要

始终提供编辑摘要被认为是一种良好的做法,但在 还原 其他编辑者的操作时,或者如果你删除了任何文本时,这一点尤其重要;否则,人们可能会质疑你编辑的动机。

准确的摘要可以帮助其他编辑决定是否值得他们检查更改,以及如果他们选择检查更改,则了解更改的内容。对于“微不足道的更改”,摘要不那么重要,但像“修正拼写”这样的摘要即使在那种情况下也是有帮助的。

良好摘要的特征

  • 总结。总结更改,即使只是简短地总结;即使是简短的摘要也比没有摘要要好。
  • 解释。如果存在其他编辑可能不清楚更改原因的合理可能性,请说明更改的原因。
  • 缩写。有经验的用户,尤其是那些需要进行大量编辑的用户,通常会使用缩写来节省时间;例如,“rv” 代表“还原”,或者维基教科书政策和相关页面的快捷方式,例如“WB:WIW” 代表 维基教科书:什么是维基教科书 (参见 维基教科书:快捷方式)。缩写应该谨慎使用,尽管它们可以为一位编辑节省时间,但它们可能会让读者花费更多时间来弄清楚它们的含义,它们可能对没有经验的用户来说很令人困惑,但对于诸如格式和语法更改之类的微不足道的编辑来说,它们通常是可以接受的。
  • 讨论页面。在编辑 讨论页面 时,考虑将你的评论复制到编辑摘要中,尤其是在评论很短的情况下;这可以让用户非常有效地检查最近更改、页面历史记录和用户贡献。它还可以减轻服务器的负载。
  • 文本和编辑摘要之间的和谐。确保重要的信息不仅包含在编辑摘要中。这尤其适用于讨论页面。只看到文本的读者可能会错过这些重要信息,然后他们可能会做出不恰当的回应,而这并非他们的错。尽量防止误解。如果一个编辑需要比编辑摘要框中所能容纳的更多的解释,请使用讨论页面,并在编辑摘要中输入“参见讨论”或“参见讨论”。
  • 避免误导性摘要。提到一个更改而没有提到另一个更改可能会误导那些认为另一个更改更重要的人;添加“以及其他更改”以涵盖其他更改。
  • 避免不合适的摘要。编辑应该解释他们的编辑,但在编辑或还原他人作品时,不要过于批评或苛刻。这可能会被视为不礼貌,并导致紧张或不好的感觉,从而使协作变得更加困难。解释你做了哪些更改,并引用相关的政策、指南或良好写作原则,但尽量不要以可能被视为攻击的方式针对他人。

属性

  • 限制为 200 个字符。编辑摘要框可以容纳一行 200 个字符。如果你试图输入或粘贴更多内容,只会显示前 200 个字符——其余部分将被丢弃。例如,尝试在一个已经包含 195 个字符的摘要中添加 10 个新字符(在结尾或中间)将导致插入前 5 个新字符,而忽略后 5 个字符。
  • 可以预览“显示预览”按钮 也提供了编辑摘要的预览,以便于检查链接。
  • 保存后无法更改。保存页面后,无法更改编辑摘要。
  • 不会出现在搜索结果中搜索功能 无法搜索编辑摘要,它们也不会被外部搜索引擎索引。
  • 维基链接始终呈现;其他维基文本编码被忽略。编辑摘要中的文本将呈现内部链接,包括 管道链接跨维基链接,即使它们包含在 <nowiki> 和 </nowiki> 之间。因此,将维基文本复制到编辑摘要框中可能比从预览中复制文本更可取,除非想要节省空间。其他维基文本编码不会被解释。
  • URL。当将外部链接从预览中复制到编辑摘要框时,根据操作系统的不同,会复制“可打印版本”,即它通常呈现的方式,此外,在括号之间,会复制 URL;因此,与维基文本中的信息相同,但格式不同,以及可能出现的顺序号。

微不足道更改复选框

选中微不足道更改框表示当前版本和先前版本之间只存在表面差异。例如,包括排版校正、格式和展示性更改、文本的重新排列而没有更改内容等。微不足道更改是指编辑认为不需要审查,而且永远不会成为争议主题的更改,例如将“teh”更改为“the”。这种类型的编辑在其页面的 修订历史记录 中用一个小写加粗的“m”字符(m)标记。

相反,重大更改是指应该审查以确保其被所有相关编辑接受的更改。因此,任何影响页面含义的更改都不是微不足道的,即使该更改只涉及一个词;例如,添加或删除“not”会改变句子的含义,这是一个重大更改。

因为编辑可能会选择在审查 最近更改 时忽略微不足道的更改,所以重大更改和微不足道更改之间的区别很重要。登录的用户甚至可以设置他们的偏好,不显示微不足道的更改。如果存在其他编辑可能对更改提出异议的可能性,最好不要将该更改标记为微不足道的。

未登录维基教科书的 用户 不允许将更改标记为微不足道的,因为存在破坏的可能性。能够将更改标记为微不足道是注册的众多原因之一。

一个经验法则是,只包含拼写校正、格式更改或文本重新排列而没有更改内容的编辑应该被标记为微不足道的更改。

何时将更改标记为微不足道更改

  • 拼写和语法校正。
  • 简单格式(例如,大小写、标点符号或将非英语单词正确地添加斜体,如folie des grandeurs)。
  • 不会改变页面含义的格式(例如,移动图片、将一个段落分成两个段落——如果这不是有争议的话)。
  • 明显的客观错误(例如,将“尼克松于 1874 年辞职”更改为“尼克松于 1974 年辞职”)。
  • 修复布局错误。
  • 添加或校正 维基链接,或修复页面中已经存在的断开的引用。
  • 删除 破坏 和涂鸦。

需要注意的事项

  • 对源文本的任何更改,即使它不会影响页面在 HTML 中的呈现(例如,如果它涉及添加空格或换行符),仍然会被数据库视为更改。
  • 将重大更改标记为微不足道的更改被认为是失礼的行为,尤其是在更改涉及删除部分文本的情况下。
  • 还原 页面在大多数情况下不可能被视为微不足道的。当页面的状态存在争议时,尤其是在 编辑战 正在酝酿时,最好不要将任何编辑标记为微不足道的。还原明显的破坏行为是该规则的例外情况。
  • 如果您不小心将编辑标记为次要编辑,而实际上它是主要编辑,则应进行第二次编辑,或进行虚拟编辑,并在虚拟编辑的编辑摘要中指出之前的编辑是主要的。 为了这个目的进行的微不足道的编辑,只需打开编辑框并保存(不进行任何更改)是行不通的; 在行尾添加空格或在页面末尾添加空行也不行——在这种情况下,编辑将被取消,编辑摘要将被丢弃。 但是,例如,可以在两个单词之间添加一个额外的空格。 这将保留在维基文本中并被记录为更改,尽管在渲染时它不会更改页面的外观。
  • 可能值得通过讨论页面或向贡献者发送消息来传达有关什么是次要编辑的任何分歧,注意避免口水战(“我认为你的更改有点超过次要编辑——也许是我太敏感了?”)。 这方面存在灰色地带,许多贡献者会感谢关于他们是否做对的反馈。
  • 将您的更改标记为次要更改会影响它在某些 编辑者的观察列表 中的显示方式。 例如,如果您将您的讨论页面评论标记为“次要”,那么较少的编辑者可能会注意到您的评论。

例外情况

管理员审阅者 可以半自动地撤销页面最后一位编辑的编辑; 所有此类 回滚 撤销都由维基软件标记为次要更改。 回滚功能的预期用途是用于破坏行为的情况,在这种情况中,撤销任何破坏行为都应被视为次要行为(并且可以在最近更改列表中忽略)。

显示预览按钮

在编辑框下方是显示预览按钮。 按下此按钮将显示页面在未实际保存时的样子。 强烈建议您在保存之前使用它。 这使您可以先检查页面看起来的样子,并确保您没有犯任何错误。 它还可以避免多次保存的需要。 在短时间内多次保存同一个页面会让人难以检查发生了哪些变化,并会阻塞 页面历史记录

如果您一直在对页面进行小的更改,那么在移动、拆分或合并页面部分之前保存页面会有所帮助。 差异显示不善于显示段落移动,如果随后移动了部分,则不会清楚地显示小的更改。

仅保存一次也是避免 编辑冲突 的一种方式,因为人们不会在 最近更改 上看到页面,因此他们不太可能尝试与您同时编辑它。

如果您已登录,您可以设置您的 偏好设置 以在编辑框之前而不是之后显示预览。 如果您选择此选项,当您在编辑页面时单击“显示预览”按钮时,预览将显示在编辑框上方。 请参见 帮助:帐户管理#偏好设置

使用显示预览还可以防止您的登录超时,这将意味着您的编辑将不会归因于您的用户名。 定期单击预览将重启计时器,以便您保持登录状态。 此外,如果您不再登录,显示预览会让您意识到这一点,以便您之后登录并保存您的工作。 您可以通过查看您的用户名是否出现在您按下预览时右上角来检查这一点。 如果您未登录,请在单独的窗口中打开 Special:UserLogin(右键单击“登录”并点击“在新窗口中打开链接”或类似操作)。 登录后,返回您的编辑并再次点击“预览”以确保一切正常。 请注意,这将清除次要编辑和观察复选框,因此请确保在最终保存页面之前再次适当地设置它们。

在进行主要编辑时使用此功能时,请考虑将内容复制到您的 剪贴板 中。 在极少数情况下,维基教科书服务器会发生故障,您可能会丢失您的工作。

按下“显示预览”时,还会获得 编辑摘要 的预览; 因此(例如)可以检查链接。

书籍页面的构成

部分

部分 是通过创建其标题来创建的,如下所示。

==Section==

===Subsection===

====Sub-subsection====

不要在一侧仅使用一个等号 (=标题=) 。 这会导致部分标题与页面的名称(标题)一样大。

部分的标题名称(包括子部分)应在页面上保持唯一。 在页面上多次使用相同的标题会导致问题

  • 指向部分的 内部链接 (wikilink) ,其形式为 [[Pagename#Section heading]],将仅链接到页面上第一个具有该名称的部分,这可能不是链接的预期目标。 请参见 部分链接,了解如何链接到部分。
  • 当编辑具有重复名称的部分时,编辑历史记录摘要 将不明确哪个部分被编辑。
  • 在编辑部分后保存页面时,编辑器的浏览器可能会导航到错误的部分。

目录 (TOC)

对于每个具有超过三个部分标题的页面,都会自动从部分标题生成目录 (TOC),除非

  • (对于用户) 偏好设置 设置为将其关闭
  • (对于页面) 魔术字__NOTOC__(在单词的两侧各带有两个下划线) 被添加到页面中

定位 TOC

当以下任何一个__FORCETOC____TOC__(在单词的两侧各带有两个下划线) 被放置在维基文本中时,即使页面具有少于四个标题,也会添加 TOC。

使用__FORCETOC__,TOC 将放置在第一个部分标题之前。 使用__TOC__,它将放置在此代码放置的相同位置。 TOC 之前可能有一些介绍性文本,称为“导言”。 虽然通常在 TOC 之后使用标题更可取,但__TOC__可用于避免被迫插入一个毫无意义的标题只是为了正确定位 TOC,即不要太低。

浮动 TOC

在某些情况下,TOC 可以使用 {{TOC right}} 或 {{TOC left}} 向右或向左浮动,当它对页面的布局有利,或当默认 TOC 挡住其他元素时。 在将默认 TOC 更改为浮动 TOC 之前,请考虑以下指南

  1. 如果页面会受到更改的不利影响,请不要浮动 TOC。
  2. 浮动 TOC 时,请检查如果用户隐藏 TOC,页面布局是否会受到损害。
  3. 长列表可能会创建非常长的 TOC。 TOC 的长度不应超过必要长度,无论它是浮动还是未浮动。 通过隐藏嵌套子部分,而不是使用浮动 TOC,可以限制 TOC 的深度以减少 TOC 的长度(见下文)。
  4. 默认 TOC 放置在第一个标题之前,但在任何介绍性文本之后(除非由页面的编辑者更改)。 如果介绍性摘要足够长,以至于普通用户必须向下滚动才能看到 TOC 的顶部,您可以浮动 TOC,使其出现在页面顶部的更近位置。
  5. 浮动宽 TOC 会为低分辨率用户生成一列窄文本。 如果 TOC 的宽度超过用户可见屏幕的 30%(大约是维基教科书左侧导航栏的两倍),那么它不适合浮动。(百分比假设典型用户设置。)
  6. 如果 TOC 位于其他浮动图像或框的附近,则只要流动的文本列的宽度不低于平均用户可见屏幕宽度的 30%,就可以浮动它。
  7. 左侧浮动的 TOC 可能会影响项目符号或编号列表。

限制 TOC 的深度

当页面具有非常大量的子部分(如本页)时,可能需要从 TOC 中隐藏较低级别的子部分。 您可以使用 {{TOC|limit=n}} 指定应显示的最低级别部分的限制,其中 n 是应显示的最低级别部分标题两侧使用的 = 符号的数量(例如,3 表示显示 === 部分 ===,但隐藏 ==== 部分 ====)。 limit=n 参数也可以以相同的方式传递给 {{TOC left}} 或 {{TOC right}}。

链接到 TOC

您可以使用以下方式创建指向 TOC 的链接

部分与独立页面

独立页面的优点

  1. 此处链接 功能
  2. 独立的 编辑历史记录
  3. 一些 模板 限制每个页面适用
  4. 重命名时的自动 重定向
  5. 加载一个小的页面比加载一个大的页面更快——但读者更有可能只使用一个部分还是浏览主题的多个部分?——请参见合并页面的优点
  6. 一个小的页面比一个大的页面更容易导航——但请参见上文
  7. 可以分别放入 类别

一个带部分的组合页面的优点

  1. 加载一个合并的页面比加载多个分割的页面更快、更方便
  2. 在一个大型页面或其维基文本中使用本地搜索功能进行搜索比使用网站搜索引擎或网络搜索引擎搜索多个页面更快,并且具有优势。
  3. 自动目录提供了方便的导航。
  4. 与多个可能独立编辑的页面相比,概念的编辑连贯性更高。
  5. 避免了与每个部分相关的项目的重复。

链接可以让读者一键访问其他维基教科书页面、其他维基媒体项目和外部网站。

维基链接内部链接将页面链接到英语维基教科书中的另一个页面。

  • [[首页]] 给出 首页 (链接到首页,标签为首页)。
  • [[首页|主页]] 给出 主页 (链接到首页,标签为主页)。
  • [[首页]]s 给出 首页,就像 [[首页|首页]] 一样: 首页
  • [[首页|主页]]s 给出 主页,就像 [[首页|主页]] 一样: 主页
  • [[首页]]'s 给出 首页's (标点符号不会附加到链接)。
  • [[首页]]<nowiki>s</nowiki> 给出 首页s。
  • [[首页]]''s'' 给出 首页s
  • ''[[首页]]s'' 给出 首页s。
  • [[食谱|食]]谱<nowiki>s</nowiki> 给出 食谱s。

带有指定标签的链接被称为 "管道",因为使用了管道符号(|)。对于某些类型的链接,如果在管道符号后没有标签,则会自动生成标签(从而节省您的输入)。请参阅下面的管道链接

链接目标区分大小写,除了第一个字符(因此 微积分 链接到 微积分,但 CAlculus 不链接)。

如果维基链接的目标不存在,则会以红色显示,被称为红色链接。如果点击红色链接,用户将被带到一个页面,在这个页面上,用户可以创建使用红色链接标题的页面。可以使用哪些页面链接到此页面功能来检测指向特定(不存在)标题的红色链接。

如果链接的目标与链接所在的页面相同(自链接),则会以粗体显示,如帮助:编辑

尝试以普通方式链接到文件页面、分类页面或跨语言链接将产生不同的效果:它会将图像放置在页面上,将页面添加到分类中,或在页面的边缘创建一个跨语言链接。要覆盖此行为,请添加一个初始冒号,例如 [[:File:Mediawiki.png]][[:Category:Help]][[:fr:Help:Contents]]

管道链接是一个内部链接跨维基链接,其中链接目标和链接标签都已指定。这在链接目标和链接标签不相等的情况下是必要的,同时链接标签也不等于链接目标,最后一个词没有扩展。这允许在页面文本中链接一个单词或短语,而不是使用“参见”,即使措辞与目标页面的名称不完全一致。使用合适的浏览器,并根据设置的偏好设置,您仍然可以看到链接目标:当您将鼠标悬停在链接上时,名称会显示在悬停框中,也会显示在状态栏中。

例如:[[帮助:目录|帮助]] 将显示为 帮助

如果在管道链接中,"|" 之后的文字为空,它将被转换为左边页面名称的简写形式,如下所示

  1. 第一个冒号 (:) 之前的任何单词,以及冒号本身,都将被移除。此单词可能是一个命名空间前缀(例如 "Help:")或一个跨维基前缀(例如 "commons:")。
  2. 如果结尾有括号中的文字,它将被移除。
  3. 如果没有括号,但有一个逗号,逗号及其后的所有内容都将被移除。
  4. 链接将使用任何使用的案例。

就像使用四个波浪号添加签名一样,在预览中,结果已经显示在预览本身中,但在编辑框中还没有显示转换。按下“显示更改”以查看维基文本中的更改。

冒号

  • [[帮助:模板|]] 被转换为 [[帮助:模板|模板]],它被渲染为 模板
  • [[编程:C++|]] 被转换为 [[编程:C++|C++],它被渲染为 C++ - 即使 "Programming:" 不是一个命名空间,快捷方式仍然有效。
  • [[w:Key Largo (film)|]] 被转换为 [[w:Key Largo (film)|Key Largo]],它被渲染为 Key Largo

案例

  • [[w:pipeline (Unix)|]] 被转换为 [[w:pipeline (Unix)|pipeline]],它被渲染为 pipeline
  • [[w:Pipeline (Unix)|]] 被转换为 [[w:Pipeline (Unix)|]],它被渲染为 Pipeline

逗号

  • [[commons:Boston, Massachusetts|]] 被转换为 [[commons:Boston, Massachusetts|Boston]],它被渲染为 Boston

可以使用相对链接链接到子页面,而无需提供完整的页面名称。以下示例展示了我们如何从假设的Snappy Title/Logical section链接到各个页面。请注意,可以通过追加另一个斜杠来隐藏链接标题中的完整页面名称。为了获得更大的灵活性,请像往常一样使用管道链接

链接目标的完整页面名称 相对链接 显示为
Snappy Title [[../]] Snappy Title
Snappy Title/Sister page [[../Sister page]] Snappy Title/Sister page
Snappy Title/Sister page [[../Sister page/]] Sister page
Snappy Title/Logical section/interesting topic [[/interesting topic]] Snappy Title/Logical section/interesting topic
Snappy Title/Logical section/interesting topic [[/interesting topic/]] interesting topic

注意,子页面的第一个字符区分大小写。

外部链接使用绝对URL直接链接到任何网页。外部链接的形式为 [http://www.example.org link name] (结果为 link name),其中链接名称与 URL 之间用空格隔开。没有链接名称的链接显示为编号:[http://www.example.org] 变成 [1]。没有方括号的链接将完整显示:http://www.example.org

特殊:链接搜索 查找链接到给定网站的所有页面。

外部链接语法也可以用来链接到维基教科书中无法通过维基链接访问的特定页面版本,例如页面历史记录、编辑视图、页面的旧版本、两个版本之间的差异等等。

要显示没有箭头图标的链接,请将外部链接语法放在<span class="plainlinks">...</span>标签之间。

要链接到同一页面中的某个部分,您可以使用[[#部分名称|显示的文字]],要链接到另一个页面中的某个部分,您可以使用[[页面名称#部分名称|显示的文字]].

实际上,部分标题指向目标页面上的一个“锚点”。可以使用模板 {{anchor|锚点名称}} 来定义除显式部分标题之外的锚点。但是,[[#top]][[#toc]] 是保留名称,分别链接到页面的顶部和目录。

如果维基链接是 重定向(例如,如果 Help:About 重定向到 Wikibooks:Welcome,那么 Help:About#General Information 将链接到 Wikibooks:Welcome 的“一般信息”部分),那么节链接仍然有效。还可以将节链接放在重定向中。例如,WB:LINK 重定向到 Help:Editing#Links。请注意,显式节链接将覆盖重定向中的任何节链接,因此 WB:LINK#Interwiki links 将跳转到本页面的“跨维基链接”部分。还可以使用 # 语法将锚链接添加到 外部链接跨维基链接 中。

跨语言链接是指从英语维基教科书的任何页面到其他语言维基教科书中几乎等效或完全等效页面的链接。

跨语言链接采用以下形式

[[language code:Title]]

其中 language code 是根据 ISO 639-1 规定的两位字母代码。(参见 所有可用语言维基教科书的完整列表。英语是“en”,日语是“ja”等等)。例如,在有关 微积分 的英语语言书籍中,该书籍在许多其他维基上都有,跨语言链接可能如下所示

[[ja:解析学基礎]]
[[nl:Analyse]]
[[zh:微积分学]]

注意:这些链接被特殊处理,不会显示在正文中,而是显示在特殊侧边栏部分中,按语言名称列出“其他语言”。从技术上讲,它们可以放在页面的任何位置;放置不会改变呈现页面的链接的外观,除了顺序。但是,惯例是将它们放在维基文本的底部。

项目 长格式 快捷方式
维基百科 [[wikipedia:]] [[w:]]
维基词典 [[wiktionary:]] [[wikt:]]
维基新闻 [[wikinews:]] [[n:]]
维基语录 [[wikiquote:]] [[q:]]
维基文库 [[wikisource:]] [[s:]]
维基物种 [[wikispecies:]] [[species:]]
维基versity [[wikiversity:]] [[v:]]
维基旅行 [[wikivoyage:]] [[voy:]]

跨维基链接是指链接到其他维基媒体项目网站上的页面,例如 维基百科 或其他语言的维基教科书。其他网站列在 跨维基映射 中。这些链接与 维基链接 具有相同的 [[...]] 语法(见上文),但带有一个指定目标网站的前缀。例如,[[w:Help:Contents]] 链接到维基百科上的“Help:Contents”页面。链接可以像维基链接一样使用管道。请记住,如果要将 跨语言链接 显示在文本中出现的位置,则它前面应该有一个冒号;否则它将在页面侧边栏中列出(只有当它是其他语言维基教科书中最接近的对应页面时才合适)。

跨维基链接(像外部链接一样)以比普通维基链接略微淡的蓝色显示。MediaWiki 不会检测这些目标页面是否存在,因此它们永远不会以红色显示。主要维基媒体项目的跨维基链接显示在右侧。

有些人更喜欢使用模板,将上述跨维基链接语法包装在一些漂亮的格式中 - {{Wikipedia}},{{Wikipediapar}},{{Wikipedia-inline}},{{Wikiversity}},{{Wikisource}},{{Wikiquote}},{{Wikivoyage}} 等等。

参考资料

参考资料展示了对支持断言的可信来源的 引用脚注添加了解释性材料,如果添加的信息写成正文会分散注意力,则它会很有用。

插入参考资料

单个参考资料或脚注的引用

在页面中引用的地方,输入脚注或参考资料,如下所示

<ref>Excel For Dummies,第一版,Hungry Minds, Inc.,1980.</ref>

您可以在脚注或参考资料中以通常的方式包含格式和链接。如果存在 <references/> 列表,则该参考资料将在底部显示在该列表中。

创建参考资料或脚注列表

在您想要显示脚注或参考资料文本的位置(通常是在页面的末尾,位于 注释参考资料 部分),插入标签

<references/>

模板 {{reflist}} 是一种替代方法,主要用于存在许多脚注的情况。

同一参考资料或脚注的多次引用

要多次引用同一参考资料或脚注,请使用 <ref> 标签的 name 参数对其进行标识。

在其中一个引用点(选择第一个是有意义的),输入参考资料,如下所示

<ref name="Perry">Perry's Handbook,第六版,McGraw-Hill Co.,1984.</ref>

然后在所有其他引用点,只需输入

<ref name="Perry"/>

您可以自由选择任何脚注名称,但要遵守一些规则。脚注名称是内部的,在查看页面时不会显示在任何地方。脚注名称区分大小写,并且可能不是数字整数。名称和组应保持简单,并限制在标准英文字母和数字范围内。

使用模板插入参考资料文本

许多 模板(例如通用的 {{citation}},或更具体的 {{cite book}},{{cite web}} 等等)可用于以更结构化的方式格式化 <ref></ref> 标签之间的文本。这些列在 Category:Citation templates 中。它们的用法是可选的:它们确实有助于一致的格式,但另一方面,它们会使编辑更加繁琐。

参考资料的外观

正文中的 <ref> 标签将转换为自动编号的上标,如下所示

Excel For Dummies 的唯一参考资料。[1] Perry's Handbook 的第一个参考资料。[2] Perry's Handbook 和另一本相关书籍的第二个参考资料。[2][3] 需要参考资料的陈述。Linux in a Nutshell 的唯一参考资料。[4] 以及 Perry's Handbook 的第三个参考资料。[2]

单击编号的上标将直接跳转到相应脚注或参考资料的文本。

<references/> 标签将展开以显示脚注或参考资料的文本及其对应的数字,如下所示

  1. Excel For Dummies,第一版,Hungry Minds, Inc.,1980。
  2. a b c Perry's Handbook,第六版,McGraw-Hill Co.,1984。
  3. 核化学工程(第二版),McGraw-Hill Co.,1981。
  4. Linux in a Nutshell,O'Reily Co.,2003。

对于单个引用,单击箭头 () 将跳转到正文中引用的位置。对于多个引用,跳转回正文的链接通过字母上标 (a, b, c 等等) 进行区分。单击字母上标将跳转到正文中相应的引用。

单独的参考资料和脚注列表

有时将解释性脚注与参考文献分开会很方便。这可以通过“group”参数来实现。

This part of the text requires clarification,<ref group="note">Listed separately from the citation</ref> whereas the entire text is cited.<ref>Citation.</ref>

;Notes
<references group="note"/>

;References
{{reflist|close=1}}

文本的这一部分需要澄清,[注释 1] 而整个文本都被引用了。 [1]

注释
  1. 与引用分开列出
参考文献
  1. 引用。

请注意,目前,此类脚注本身不能包含引用链接。

脚注也可以通过在{{reflist}} 模板末尾使用“close”参数列出文本的每个部分,如上面的方框所示。

列表定义的参考文献

该软件还允许在参考文献列表中定义命名参考文献,而不是在主文本中。这使得编辑页面更容易,尤其是在引用较多的部分。例如

The quick brown fox jumps over the lazy dog.<ref name="LazyDog"/>

<references>
<ref name="LazyDog">This is the lazy dog reference.</ref>
</references>

敏捷的棕色狐狸跳过懒惰的狗。 [1]

  1. 这是懒狗的参考文献。

这也可以通过使用{{reflist}} 模板与 |refs= 参数来完成。如果需要,可以使用 |group= 参数对模板的参考文献进行分组。

How razorback-jumping frogs<ref name="Batteries" group="note"/> can level six piqued gymnasts.<ref name="JumpingFrogs"/>

;Notes
{{reflist|group="note"|
refs=
<ref name="Batteries" group="note">Batteries not included.</ref>
}}
;References
{{reflist|
refs=
<ref name="JumpingFrogs">This is the jumping frogs reference.</ref>
}}

如何让跳跃的razorback青蛙 [注释 1] 能让六个挑剔的体操运动员平级。 [1]

注释
  1. 电池不包含在内。
参考文献
  1. 这是跳跃青蛙的参考文献。

列表

有三种类型的列表:无序列表有序列表定义列表

wikitext 渲染
* Unordered lists are easy to do:
** start every line
* with a star
** more stars mean
*** deeper levels
  • 无序列表很容易做
    • 每行开头
  • 用一个星号
    • 更多星号意味着
      • 更深层级
* A newline
* in a list  
marks the end of the list.
Of course
* you can
* start again.
  • 换行符
  • 在列表中

标志着列表的结束。当然

  • 你可以
  • 重新开始。
# Numbered (ordered) lists are good
## very organized
## easy to follow
  1. 编号(有序)列表很好
    1. 非常有条理
    2. 易于遵循
* You can also
** break lines
** like this
  • 你也可以
    • 换行
    • 像这样
; Definition lists
; item : definition
; semicolon plus term
: colon plus definition
定义列表
项目
定义
分号加上术语
冒号加上定义
* Or create mixed lists
*# and nest them
*#* like this
*#*; definitions
*#*: work:
*#*; apple
*#*; banana
*#*: fruits
  • 或者创建混合列表
    1. 并将它们嵌套
      • 像这样
        定义
        工作
        苹果
        香蕉
        水果

为简单起见,维基标记中的列表项不能超过一段。接下来的空行将结束列表并在有序列表中重置计数器。用空行分隔无序列表项可能会在您的屏幕上看起来大致正常,但它会创建许多单独的单项列表,这对于使用屏幕阅读器的人来说是一个问题,会导致残疾人无法访问。

其他项目

常见任务

恢复

在维基教科书中,恢复意味着撤消一个或多个编辑的效果,这通常会导致页面恢复到之前存在的某个版本。更广泛地说,恢复也可能指任何完全或部分逆转其他编辑者的操作的行为。

此页面包含有关执行恢复的技术信息。但是,应该记住,恢复其他编辑者的善意行为(与破坏行为相反)如果过度进行,则被认为是破坏性的,甚至可能导致恢复者被阻止编辑。

手动恢复

在某些情况下(例如,如果破坏者添加或删除了文本,并且此后进行了不相关的建设性编辑),撤消过去编辑的最简单方法可能是简单地编辑当前页面,删除错误添加的文本或恢复错误删除的文本(这可以从页面的过去版本复制粘贴)。但是,从您要恢复的更改之前还原页面的特定旧版本可能更方便。为此

  • 单击页面顶部的“历史记录”选项卡以显示页面历史记录
  • 单击您要恢复的早期版本的日期和时间。您将看到类似于以下内容的短语:“这是此页面的旧修订版,由***.***.***.***(讨论)于2024年1月24日15:47编辑。它可能与当前修订版有很大差异。”
    • 重要提示:破坏行为的情况下,花时间确保您恢复到没有破坏行为的最后一个版本;可能存在多个连续的破坏行为编辑,或者它们可能散布在建设性编辑之间。
  • 单击编辑选项卡,就像您通常编辑页面一样。(在编辑框上方,您将看到类似于以下内容的警告:“您正在编辑此页面的旧修订版。如果您保存它,自那时以来的任何更改都将被删除。”)如果编辑需要注册帐户,请先登录,或在讨论页面上留言。
  • 完成编辑摘要字段(缩写“rv”可以用来代表“恢复”;编辑摘要“rvv”表示“恢复破坏行为”)。
  • 保存页面。
  • 如果在您想要恢复的更改之后进行了建设性编辑,请返回页面历史记录以查找这些编辑,并在合理的情况下手动重做它们。

如果恢复破坏行为,请检查破坏页面用户的贡献历史。如果此用户正在破坏许多页面,请报告他们

撤消

MediaWiki 软件有时可以让编辑者轻松地恢复(或“撤消”)页面历史记录中的单个编辑,而不会同时撤消自那时以来的所有建设性更改。为此,请查看页面历史记录差异以查看该编辑,然后单击相关编辑旁边的“撤消”。该软件将尝试创建一个编辑页面,其中包含一个页面版本,其中已删除了不需要的编辑,但保留了所有后续编辑。有一个默认的编辑摘要,但在保存之前可以修改它。

也可以撤消几个连续的编辑,即使它们相互冲突:查看要删除的差异(通过在历史记录中选择两个极端版本并单击“比较选定的版本”),然后单击“撤消”链接。

此功能消除了手动重做在被恢复的编辑之后进行的有用更改的必要性。但是,如果撤消编辑会导致与后续编辑冲突,则它将失败。例如,如果一个编辑添加了一段,而后续编辑修改了该段,则无法自动撤消之前的编辑。在这种情况下,您必须确定如何手动解决问题。

回滚

管理员审阅者 授予了回滚功能访问权限,他们还有额外的链接,这些链接

  • 只出现在顶层编辑旁边
  • 恢复所有由最后一位编辑者进行的顶层后续编辑
  • 立即生效,无需中间确认差异页面
  • 添加自动编辑摘要mExample (讨论) 的编辑恢复到 Example2 的最后一个版本”,将编辑标记为次要

回滚链接出现在用户贡献页面、用户观察列表历史记录页面差异页面上。请注意,在最后一种情况下,回滚链接可能会造成误导,因为恢复不一定是到显示的旧版本(差异页面可能会显示编辑的组合结果,包括其他编辑者的一些编辑或回滚按钮将恢复的部分编辑)。要查看回滚按钮将恢复的更改,请查看将最后一个编辑者最后一次版本与上一个编辑者最后一次版本进行比较的特定差异。

回滚比撤消快得多,因为它

  • 允许在不查看修订列表或差异的情况下进行恢复
  • 不需要加载编辑页面并将 wikitext 发送回服务器
  • 不需要单击保存按钮

另一方面,它不像撤消那样通用,因为它不允许指定要撤消的编辑。您可能希望恢复的编辑多于或少于回滚的编辑,或者不包括最后一个编辑的编辑。它也不允许在自动编辑摘要中添加说明,并且应该只用于恢复明显的破坏行为。

回滚善意编辑,没有说明,可能会被误解为“我认为你的编辑不比破坏行为好,恢复它不需要说明”。一些编辑者对这种被认为的轻视很敏感;如果您使用回滚功能不是为了破坏行为(例如,因为由于页面大小过大,撤消不切实际),最好在书籍的讨论页面或您恢复其编辑的用户的话题页面上留下说明。

如果有人在您单击“回滚”链接之前编辑或回滚了页面,或者如果没有之前的编辑者,您将收到错误消息。

重定向

重定向 页面会导致导航到给定标题的读者直接跳转到另一个页面。读者首先访问的页面被称为重定向 页面。

重定向的语法

如果页面的维基文本以以下内容开头,则该页面将被视为重定向页面:#REDIRECT后面跟着一个有效的 维基链接跨维基链接。通常会在链接前留一个空格。(注意,"REDIRECT" 的一些替代大写形式也是可能的。) 按钮位于 编辑工具栏 中,可用于生成此语法。

请注意,重定向只有在链接指向同一个项目(英文维基教科书)上的一个现有的正常页面(而不是 特殊页面)时才会按预期工作(即直接将读者带到目标页面)。在其他情况下,通常使用软重定向 - 请参阅 下文

示例

  • #REDIRECT [[Help:Tracking changes]](重定向到 Help:Tracking changes 页面)
  • #REDIRECT [[Help:Tracking changes#Preferences]](重定向到 Help:Tracking changes 页面的 "Preferences" 部分)
  • #REDIRECT [[fr:Help:Tracking changes]](显示为指向法语维基教科书上的 Help:Tracking changes 页面的重定向,但不会作为真正的重定向工作;这被称为“软重定向”)

出现在重定向链接后的任何文本都将在显示中被忽略,但可以用于添加类别、注释等。

请注意,重定向链接必须是明确的 - 它不能包含 变量模板 等。

重定向到 类别 页面时,请在目标页面名前加上冒号,以防止重定向显示在类别中。(从一个类别页面到另一个类别页面的重定向应该使用软重定向 - 请参阅 下文。)重定向到 文件 页面也需要冒号。

重定向的外观

如果重定向目标是英文维基教科书上的现有页面,那么如果读者通过 维基链接URL 导航到重定向页面,他们将被直接带到目标页面。但是,浏览器仍然显示重定向页面的 URL,并且目标页面在顶部标题下方显示一个小通知,以表明你是通过重定向到达的。例如,如果你点击 WB:RR,你将被重定向到 Wikibooks:Reading room 页面,并且页面的顶部将如下所示:

Wikibooks:Reading room
(重定向自 Wikibooks:RR)

要获取浏览器地址栏中的目标页面的规范 URL,请点击页面的标签。要转到重定向页面本身(以编辑它、查看它的历史记录等),请点击 "(Redirected from...)" 通知中的链接。

如果重定向目标是一个不存在的页面 (红链接),或者是一个 特殊页面,或者另一个项目中的页面,那么重定向将不会被执行,并且读者将看到重定向页面的显示(如以下所示)。如果目标是现有页面的一个不存在的部分,那么重定向将把读者带到目标页面的顶部。

请注意,重定向链不会被执行。如果标题 A 重定向到 B,而 B 本身是一个重定向页面,那么导航到 A 的读者将看到重定向页面 B 的显示(如上所示)。这种情况被称为 双重重定向。(机器人 会修复此类链,以便每个重定向直接指向最终的目标页面。)

重定向的创建

重定向页面可以像其他任何页面一样创建。只需输入维基文本#REDIRECT [[xxx]],将 "xxx" 替换为目标页面的标题(可以选择后面加上 "#" 符号和部分标题)。 按钮位于编辑窗口上方的 编辑工具栏 中,可用于节省输入(点击它,然后插入所需的目标,或者输入目标,用鼠标选择它,然后点击按钮)。请确保 #REDIRECT 关键字之前没有文本,否则重定向将无法工作。通常没有理由在链接后放置任何文本,尽管有时会添加类别(或分类模板)。

类似地,可以编辑任何现有页面将其变成重定向。如果创建了一个新的重定向页面或将现有页面变成重定向页面,则会自动生成一个 编辑摘要,说明该页面已重定向到给定的目标。(如果编辑者提供了编辑摘要,则会覆盖此操作。)

当一个页面被 移动(重命名)时,会自动从旧名称创建到新名称的重定向,以及相应的讨论页面的重定向(如果它也已移动)。管理员 可以选择抑制重定向的创建。

如果新页面名称被一个只有其历史记录中只有一次编辑且目标为旧页面名称的重定向占据,那么它将被移动的页面替换。如果重定向具有多个历史记录条目,或者具有不同的目标页面,则必须由管理员进行移动。

要编辑一个已经是重定向的页面(或查看它的历史记录、讨论页面等),请跟随重定向到目标页面,然后点击页面顶部的 "(Redirected from ...)" 通知中的链接。这将带你到重定向页面本身。另一种方法是转到目标页面,然后点击 "哪些页面链接到这里"(位于页面左侧的工具箱中)。这将显示所有来自该页面的反向链接,包括重定向。点击此列表中的重定向将带你到重定向页面,而不是目标页面。

软重定向

作为正常“硬”重定向(将读者直接带到目标页面)的替代方案,可以创建 “软”重定向,它会将读者留在重定向页面上,让他们可以选择点击链接到目标页面。这通常在以下情况下完成

  • 当目标位于另一个项目 (维基百科、其他语言的维基教科书等) 上或是一个 特殊页面 时。(在这些情况下,硬重定向在任何情况下都会像软重定向一样工作。)
  • 对于类别之间的重定向。(硬重定向适用于类别页面,但软重定向是首选,因为软件无法从重定向类别中重新分类页面。)

软重定向使用 {{soft redirect}} 和 {{category redirect}} 模板创建。

潜在问题

页面保护

管理员 可以保护页面以限制对该页面的编辑或移动,并删除此类保护。保护可以是无限期的,也可以在指定时间后过期。

  • 完全保护 阻止除 管理员 之外的所有人编辑。
  • 半保护 阻止未注册的贡献者和没有自动确认的账户的贡献者编辑。
  • 创建保护 阻止创建页面(通常是以前 删除 的页面)。
  • 移动保护 只保护页面免受 移动

可以在 Wikibooks:Reading room/Administrative Assistance 中请求任何类型的保护或取消保护。对完全保护页面的更改应在相应的 讨论页面 上提出。有关更多信息,请参阅 Wikibooks:Protected page

编辑冲突

如果其他人在你进行编辑时也进行编辑,则会导致编辑冲突。许多冲突可以由维基自动解决。但是,如果它无法解决,你将需要自己解决它。

要了解编辑冲突是什么,请考虑以下情况

  • 爱丽丝点击页面上的“编辑”。
  • 鲍勃在爱丽丝正在编辑时点击了同一个页面上的“编辑”。
  • 爱丽丝完成了她的编辑并点击了“保存页面”。该页面被保存了爱丽丝的版本,而鲍勃仍在编辑。
  • 鲍勃完成了他的编辑并点击了“保存页面”。鲍勃得到了一个“编辑冲突”页面,因为软件无法自动协调鲍勃和爱丽丝的页面版本之间的差异。编辑冲突页面让鲍勃有机会手动协调差异。

布局

编辑冲突页面顶部有一个编辑框,其中包含 Alice 对整个页面的版本,即使 Bob 正在进行分段编辑。

编辑冲突页面底部有一个第二个编辑框,其中包含 Bob 将要提交的文本。 这将是 Bob 对页面的版本,或他正在编辑的部分。

这两个编辑框之间有一个 diff,它显示了 Alice 和 Bob 对页面的版本的差异。 对于 Bob 正在编辑的部分,它会显示 Bob 的更改和 Alice 的可能更改,但 Bob 和 Alice 都做出了相同更改的部分除外。 对于其他部分,它会显示完整的文本,就好像所有这些文本都被添加了一样。

Bob 可以在上方的编辑框中编辑并按下保存。

解决

如果 Bob 只做了一些小更改,而 Alice 做了一些大的更改,他可以选择从 Alice 的版本开始工作,并重新合并他的更改。 Bob 可能会选择添加一些类似“通过编辑冲突”的文本到编辑摘要中,以警告 Alice 和其他人他不得不这样做——然后 Alice 可以审查他的合并以确保准确性。

如果 Bob 做出了很大的更改,而 Alice 做出了小的更改,他可以选择从他的版本开始工作。 一个选择是让 Bob 将底部的文本复制到顶部的文本中(或者如果 Bob 正在进行分段编辑,则只复制顶部文本的某个部分),并附上一个合适的 编辑摘要(例如,“通过编辑冲突,将重新合并”)。 然后 Bob 可以查看页面历史记录,确定 Alice 的更改,并在单独的编辑中将其重新应用到他的版本中。

如果 Alice 和 Bob 都做了很大的更改,事情就会变得复杂,Alice 和 Bob 只好尽力而为。 例如,如果 Alice 和 Bob 同时在一个主题上添加了大量文本,那么最好让 Bob 提交他的更改,然后让 Alice 和 Bob 都看看这两个版本,并自行决定哪个版本更好。

Bob 不应该仅仅将他的更改发布到 Alice 的更改之上。 我们假设善意——偶尔会犯错误,新手可能不理解编辑冲突窗口。 但是,Bob 不应该例行公事地忽略编辑冲突。 Bob 因为懒惰而覆盖 Alice 的行为是绝对不可接受的。 我们鼓励贡献者使用 diff 功能仔细检查他们的合并。

预防

由于编辑冲突令人讨厌且耗时,您可能选择改变您的编辑习惯,以减少它们发生的频率。

最简单的方法之一是编辑页面所需的最小部分。 如果您只需要编辑页面中的单个部分,那么请单击该部分的“编辑”链接,而不是整个页面的“编辑”链接。 两个人可以同时在不同的部分工作,这样就不会出现编辑冲突。

为了减少编辑冲突的可能性,Wikibooks 在其 模板 命名空间中还提供了一个“使用中”通知,人们可以在长时间编辑页面时使用它。 只需在进行重大编辑之前将 {{in use}} 添加到页面上,并在编辑完成后删除该模板。

另请参阅


华夏公益教科书