帮助:编辑
维基教科书是一个 维基,这意味着任何人都可以轻松编辑任何未受保护的页面,并将这些更改立即保存到该页面。在您首次编辑后,您就成为维基教科书编辑!要请求对受保护页面的更改,您可以将您的建议添加到讨论页面。如果您只是想尝试一下,请在 沙盒 中进行操作。
编辑维基教科书页面非常容易。只需点击维基教科书页面顶部的“编辑”选项卡。这将带您进入一个新页面,其中包含一个文本框,其中包含原始页面的可编辑文本。完成后,在编辑框下方的小字段中写一个简短的编辑摘要。您可以使用缩写来描述您的更改,完成后,按“显示预览”按钮查看您的更改将如何显示。您也可以通过按“显示更改”按钮来查看您的编辑页面与先前版本的页面之间的差异。如果您对看到的内容满意,请大胆地按“保存页面”按钮。您的更改将立即对其他维基教科书用户可见。
编辑页面的组成
编辑页面包含以下部分
- 编辑工具栏
- 编辑文本框
- 编辑摘要 框
- 轻微编辑,关注此页面 复选框
- 保存页面,显示预览,显示更改 按钮
- 取消,编辑帮助链接
- 页面上使用的 模板 列表
- 如果您已请求,则会显示预览。您的偏好可能会将预览放置在页面的顶部。
编辑工具栏
编辑工具栏位于编辑文本框上方,可帮助您生成维基标记,即用于在维基页面上设置文本样式的指令。在编辑页面时看到的编辑文本框上方的编辑工具栏中,如果您点击“帮助”,您可以看到维基标记可以实现哪些效果。另一种学习如何产生特定效果的方法是,点击包含您希望复制的效果的页面的“编辑”,并查看使用了哪些标记。
名称 | 标记 | 显示 | ||
---|---|---|---|---|
基本 | ||||
粗体 | 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 --~~~~
|
谢谢大家 --示例 2005年11月27日 (UTC) 07:46 | ||
高级 | ||||
标题 不同级别标题的下拉列表 | == 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
|
| ||
文本缩进 | :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]]
|
WB:HELP | ||
搜索和替换 | 打开搜索和替换窗口 |
编辑摘要
编辑摘要是对维基教科书页面编辑的简要说明。当您编辑页面时,在主要编辑框下方和“保存页面”按钮上方有一个小的文本输入框,标为“编辑摘要”。编辑摘要显示在更改列表中(例如 页面历史记录 和 监视列表),以及 差异 页面顶部。
填写“编辑摘要”字段或在进行 部分编辑 时进行补充是一种良好的做法,因为这有助于其他人了解您编辑的意图。为了避免意外地留下空白的编辑摘要,如果您创建了帐户,可以在您的 用户偏好设置 中的“编辑”选项卡上选择“在输入空白编辑摘要时提示我”。
始终提供编辑摘要
始终提供编辑摘要被认为是一种良好的做法,但在 撤销 其他编辑者的操作或删除任何文本时尤其重要;否则,人们可能会质疑您编辑的动机。
准确的摘要帮助其他编辑者决定他们是否值得检查更改,以及如果他们选择检查更改,则了解更改。对于“微小更改”,摘要不太重要,但即使在这种情况下,像“修复拼写”这样的摘要也很有用。
良好摘要的品质
- 总结。总结更改,即使只是简要说明;即使是简短的摘要也比没有摘要好。
- 解释。如果其他编辑者可能不清楚更改的原因,请说明更改的原因。
- 缩写。经验丰富的用户,尤其是那些需要进行大量编辑的用户,通常会使用缩写来节省时间;例如,“rv”代表“撤销”,或者维基教科书政策和相关页面的快捷方式,例如“WB:WIW”代表 维基教科书:什么是维基教科书(请参阅 维基教科书:快捷方式)。缩写应该谨慎使用,虽然它们为一个编辑节省了时间,但它们可能让读者花费更多时间来弄清楚它们的意思,对于没有经验的用户来说可能会令人困惑,但对于像格式和语法更改这样的小编辑来说,它们通常没问题。
- 讨论页面。在编辑 讨论页面 时,请考虑将您的评论复制到编辑摘要中,尤其是当它很简短时;这允许用户非常有效地检查最新更改、页面历史记录和用户贡献。它也减少了服务器的负载。
- 文本和编辑摘要之间的和谐。确保重要的信息不仅包含在编辑摘要中。这尤其适用于讨论页面。仅看到文本的读者可能会错过这些重要信息,然后他们可能会做出不恰当的回应,而这并非他们的错。尽量避免误解。如果编辑需要比编辑摘要框中容纳的更多解释,请改用讨论页面,并在编辑摘要中添加“查看讨论”或“查看讨论”。
- 避免误导性的摘要。提到一个更改而没有提到另一个更改可能会误导那些认为另一个更改更重要的人;添加“以及其他”来涵盖其他更改。
- 避免不恰当的摘要。编辑者应该解释他们的编辑,但不要在编辑或撤销其他人的作品时过于批评或苛刻。这可能会被认为是不礼貌的,并造成紧张或不好的感觉,从而使合作更加困难。解释您更改了什么,并引用相关的政策、指南或良好的写作原则,但尽量不要以攻击性方式挑出其他人。
属性
- 限于 200 个字符。编辑摘要框可以容纳一行 200 个字符。如果您尝试键入或粘贴更多字符,则只会显示前 200 个字符——其余字符将被丢弃。例如,尝试在已经包含 195 个字符的摘要中添加 10 个新字符(在末尾或中间)将导致插入前 5 个新字符,而忽略后 5 个字符。
- 可以预览。该 “显示预览”按钮 还提供编辑摘要的预览,以方便检查链接。
- 保存后无法更改。保存页面后,您无法更改编辑摘要。
- 不会出现在搜索中。该 搜索功能 无法搜索编辑摘要,它们也不会被外部搜索引擎索引。
- 维基链接始终呈现;其他维基文本编码被忽略。编辑摘要中的文本会呈现内部链接,包括 管道链接 和 跨维基链接,即使在 <nowiki> 和 </nowiki> 内。因此,将维基文本复制到编辑摘要框中可能比从预览中复制文本更可取,除非想要节省空间。其他维基文本编码不会被解释。
- URL。当从预览中复制外部链接到编辑摘要框中时,根据操作系统的不同,会复制“可打印版本”,即它通常如何呈现,并且在括号中还会添加 URL;因此与维基文本中相同的信息,但格式不同,以及可能的顺序号。
微小编辑复选框
选中微小编辑框表示当前版本和先前版本之间只存在表面上的差异。例如包括排版更正、格式和表现形式的更改、文本的重新排列而不修改内容等。微小编辑是指编辑者认为不需要审查,并且永远不会成为争议主题的编辑,例如将“teh”更改为“the”。这种类型的编辑在其页面的 修订历史记录 中用一个小写的粗体“m”字符 (m) 来标记。
相反,重大编辑是指应该审查其对所有相关编辑者的可接受性的编辑。因此,任何影响页面含义的更改都不是微小的,即使编辑涉及一个单词;例如,添加或删除“不”,这可能会改变句子的含义,是一个重大编辑。
由于编辑者可以选择在审查 最新更改 时忽略微小编辑,因此重大编辑和微小编辑之间的区别非常重要。已登录的用户甚至可以设置其偏好设置,以不显示微小编辑。如果有任何可能其他编辑者会争论更改的可能性,最好不要将编辑标记为微小编辑。
没有 登录 维基教科书的用户不允许将更改标记为微小更改,因为存在破坏的可能性。能够将更改标记为微小更改是注册的众多原因之一。
一个好的经验法则是,仅包含拼写更正、格式更改或文本重新排列而不修改内容的编辑应该被标记为微小编辑。
何时将编辑标记为微小编辑
- 拼写和语法更正。
- 简单格式 (例如,大写、标点符号或适当地为非英语单词添加斜体,如 folie des grandeurs)。
- 不会更改页面含义的格式 (例如,移动图片,将一个段落分成两个段落——只要这不是有争议的)。
- 明显的错误事实 (例如,将“尼克松在 1874 年辞职”改为“尼克松在 1974 年辞职”)。
- 修复布局错误。
- 添加或更正 维基链接,或修复页面中已存在的损坏引用。
- 移除破坏行为和涂鸦。
需要记住的事情
- 任何对源文本的更改,即使它不会影响页面在HTML中的呈现(例如,如果它涉及添加空格或换行符),也会被数据库视为更改。
- 将重大更改标记为次要更改被认为是不礼貌的行为,特别是如果更改涉及删除一些文本。
- 还原页面在大多数情况下不太可能被认为是次要的。当页面的状态存在争议时,尤其是当编辑战正在酝酿时,最好不要将任何编辑标记为次要的。还原明显的破坏行为是此规则的例外。
- 如果您不小心将编辑标记为次要的,而实际上它是重大编辑,您应该进行第二次编辑,或虚拟编辑,在虚拟编辑的编辑摘要中说明前一次编辑是重大的。作为为此目的进行的微不足道的编辑,仅仅打开编辑框并保存(即不进行任何更改)将不起作用;添加一行末尾的空格或页面末尾的空行也不起作用——在这些情况下,编辑会被取消,编辑摘要会被丢弃。但是,例如,可以在两个词之间添加一个额外的空格。这将保存在维基文本中并被记录为更改,尽管它不会改变页面呈现时的外观。
- 通过讨论页面或向贡献者发送消息,值得与任何关于什么是次要的意见分歧进行沟通,注意避免火焰战(“我认为你的更改不止一点点——也许是我过于敏感了?”)。存在灰色地带,许多贡献者会感谢关于他们是否做对了的反馈。
- 将您的更改标记为次要会影响它在某些编辑者的观察列表中的显示方式。例如,如果您将您的讨论页面评论标记为“次要”,那么更少的编辑者可能会注意到您的评论。
例外
管理员和审核员可以半自动地还原页面最后一位编辑的编辑;所有此类回滚还原都被维基软件标记为次要的。回滚功能的预期用途是针对破坏行为的情况,在这种情况下,还原任何破坏行为应被视为次要(并且可以在最近更改列表中忽略)。
显示预览按钮
在编辑框下方有一个显示预览按钮。按下它将显示页面在不实际保存的情况下会是什么样子。强烈建议您在保存之前使用它。这使您可以先查看页面会是什么样子,并检查您是否没有犯任何错误。它还避免了多次保存的必要性。在快速连续地多次保存同一页面会使人们难以检查发生了什么变化,并且会堵塞页面历史记录。
如果在对页面进行小的编辑后,您要移动、拆分或合并页面的部分,那么保存页面是有帮助的。差异显示不太擅长显示段落移动,并且如果部分随后被移动,则不会清晰地显示小的编辑。
只保存一次也是避免编辑冲突的一种方式,因为人们不会在最近更改中看到页面,因此他们不太可能在您同时编辑页面时尝试编辑它。
如果您已登录,您可以设置您的偏好设置,以便在编辑框之前而不是之后显示预览。如果您选择此选项,当您在编辑页面时点击“显示预览”按钮时,预览将在编辑框上方显示。请参阅帮助:帐户管理#偏好设置。
使用显示预览还可以防止您的登录超时,这意味着您的编辑不会归因于您的用户名。定期点击预览将重新启动计时器,因此您将保持登录状态。此外,如果您不再登录,显示预览将让您意识到这一点,以便您登录并在之后保存您的工作。您可以通过查看按下预览后您的用户名是否出现在右上角来检查这一点。如果您没有登录,请在另一个窗口中打开特殊:用户登录(右键单击“登录”并点击“在新窗口中打开链接”或类似操作)。登录,然后返回您的编辑并再次点击“预览”以确保一切正常。请注意,这将清除次要编辑和观察复选框,因此请确保在最终保存页面之前再次正确设置它们。
在重大编辑过程中使用此功能时,请考虑将内容复制到您的剪贴板中。在极少数情况下,维基教科书服务器会遇到故障,您可能会丢失工作。
当按下“显示预览”时,还会获得编辑摘要的预览;因此(例如)可以检查链接。
书籍页面的构成
部分
部分是通过创建它们的标题来创建的,如下所示。
==Section== ===Subsection=== ====Sub-subsection====
请不要只在一侧使用一个等号 (=标题=)。这会导致部分标题与页面名称(标题)一样大。
部分的标题名称(包括子部分)在页面上应该唯一。在页面上多次使用相同的标题会导致问题
- 对部分的内部链接(维基链接),形式为 [[Pagename#Section heading]],只会链接到页面上第一个具有该名称的部分,这可能不是链接的预期目标。请参阅部分链接,了解如何链接到部分。
- 当具有重复名称的部分被编辑时,编辑历史记录和摘要将不明确哪个部分被编辑。
- 在部分编辑后保存页面时,编辑者的浏览器可能会导航到错误的部分。
目录(TOC)
对于每个具有三个以上部分标题的页面,都会自动从部分标题生成目录(TOC),除非
目录的位置
当任一__FORCETOC__或__TOC__(两侧都有两个下划线)被放置在维基文本中,即使页面具有少于四个标题,也会添加 TOC。
使用__FORCETOC__,TOC 被放置在第一个部分标题之前。使用__TOC__,它被放置在放置此代码的位置。TOC 之前可能有一些介绍性文本,称为“导言”。虽然通常 TOC 之后的标题更可取,但__TOC__可以用来避免被迫插入一个毫无意义的标题,只是为了正确放置 TOC,即不要太低。
浮动 TOC
在某些情况下,TOC 可以使用 {{TOC 右侧}} 或 {{TOC 左侧}} 向右或向左浮动,当它对页面的布局有利,或者当默认 TOC 妨碍其他元素时。在将默认 TOC 更改为浮动 TOC 之前,请考虑以下指南
- 如果页面会受到更改的不利影响,请不要浮动 TOC。
- 当浮动 TOC 时,请检查如果用户隐藏 TOC,页面布局是否会受到损害。
- 长列表可能会创建非常长的 TOC。TOC 不应该比必要时长,无论是浮动还是不浮动。限制 TOC 的深度可以用来通过隐藏嵌套子部分来减少 TOC 的长度,而不是使用浮动 TOC(见下文)。
- 默认 TOC 被放置在第一个标题之前,但在任何介绍性文本之后(除非被页面的编辑者更改)。如果介绍性摘要足够长,以至于典型的用户必须向下滚动才能看到 TOC 的顶部,您可以浮动 TOC 以便它更靠近页面的顶部。
- 浮动一个宽 TOC 将为具有低分辨率的用户生成一列窄文本。如果 TOC 的宽度超过用户可见屏幕的 30%(大约是维基教科书左侧导航栏的两倍大),那么它不适合浮动。(百分比假设典型的用户设置。)
- 如果 TOC 被放置在其他浮动图像或框的附近,那么它可以被浮动,只要流动的文本列的宽度不低于平均用户可见屏幕宽度的 30%。
- 向左浮动的 TOC 可能会影响项目符号列表或编号列表。
限制 TOC 的深度
当页面具有非常多的子部分(例如本页面)时,可能需要从 TOC 中隐藏较低级别的子部分。您可以使用{{TOC|limit=n}}
指定应该显示的最低级别部分的限制,其中n是在最低级别部分标题的两侧使用的等号数量(例如,3 表示显示===部分===,但隐藏====部分====)。limit=n参数也可以以相同的方式传递给{{TOC 左侧}} 或 {{TOC 右侧}}。
链接到 TOC
您可以使用以下方法链接到 TOC
章节与独立页面
独立页面的优点
- 哪些页面链接到此页面 功能
- 独立的 编辑历史记录
- 某些 模板 限制按页面应用
- 重命名时自动 重定向
- 加载一个小页面比加载一个大页面速度快——但读者更有可能只使用一个部分还是浏览主题的多个部分?——参见组合页面的优点
- 一个小页面比一个大页面更容易导航——但参见以上内容
- 可以分别放入 类别
一个带章节的组合页面的优点
- 加载一个组合页面比加载几个分割的页面更快更方便
- 在一个大页面或其维基文本中使用本地搜索功能进行搜索比使用网站搜索引擎或网络搜索引擎搜索多个页面更快,并且具有优势。
- 自动目录提供了方便的导航。
- 与多个可能被独立编辑的页面相比,概念的编辑一致性更高。
- 避免了与每个部分相关的项目的重复。
链接
Meta 有相关信息 |
链接 让读者可以一键访问其他维基教科书页面、其他 维基媒体项目 和外部网站。
维基链接
维基链接 或内部链接 将页面链接到英文维基教科书中的另一个页面。
- [[主页]] 给出 主页 (链接到主页,标记为主页)。
- [[主页|首页]] 给出 首页 (链接到主页,标记为首页)。
- [[主页]]s 给出 主页,就像 [[主页|主页]] 一样: 主页。
- [[主页|首页]]s 给出 首页,就像 [[主页|首页]] 一样: 首页。
- [[主页]]'s 给出 主页's (标点符号不会附加到链接)。
- [[主页]]<nowiki>s</nowiki> 给出 主页s。
- [[主页]]''s'' 给出 主页s。
- ''[[主页]]s'' 给出 主页s。
- [[食谱|烹饪]]book<nowiki>s</nowiki> 给出 食谱s。
带有指定标签的链接被称为“管道链接”,因为使用了管道符号 ( | )。对于某些类型的链接,如果在管道符号后没有标签,则会自动生成标签(因此节省了您的输入)。参见下文的 管道链接。
链接目标对除了第一个字符之外的所有字符都区分大小写(因此 calculus 链接到 Calculus,但 CAlculus 不链接)。
如果维基链接的目标不存在,则它会以红色显示,并被称为 红色链接。如果点击红色链接,用户将被带到一个页面,在那里可以创建以红色链接标题命名的页面。可以使用 哪些页面链接到此页面 功能检测到特定(不存在)标题的红色链接。
如果链接的目标与它所在的页面相同(自链接),则它将以粗体显示,例如 帮助:编辑。
尝试以常规方式链接到 文件 页面、类别 页面或 跨语言链接 将产生不同的效果:它将在页面上放置图像,将页面添加到类别或在页面边缘创建跨语言链接。要覆盖此行为,请添加一个初始冒号,例如 [[:File:Mediawiki.png]]
、[[:Category:Help]]
、[[:fr:Help:Contents]]
。
管道链接
管道链接 是一个内部 链接 或 跨维基链接,其中链接目标和链接标签都已指定。当它们不相同且链接标签也不等于链接目标且最后一个词被扩展时,需要这样做。这允许链接页面文本中的单词或短语,而不是使用“参见”,即使措辞与目标页面的名称不完全匹配。使用合适的浏览器,根据设置的 首选项,您仍然可以看到链接目标:当您指向链接时,该名称会显示在悬停框中,并且也会显示在状态栏中。
例如:[[帮助:内容|帮助]] 将显示为 帮助。
如果在管道链接中,"|" 后面的部分为空,它将被转换为左边页面名称的缩写形式,如下所示
- 第一个冒号 (:) 之前的任何单词以及冒号本身都将被删除。这个词可能是也可能不是一个命名空间前缀(例如“帮助:”)或一个 跨维基前缀(例如“commons:”)。
- 如果结尾处有括号内的文本,它将被删除。
- 如果没有括号,但有逗号,则逗号及其后的所有内容都将被删除。
- 链接将以任何使用的格式显示。
就像在添加签名时使用四个波浪号一样,在预览中,结果已经在预览中显示出来,但编辑框中的转换还没有显示。按“显示更改”以查看维基文本中的更改。
冒号
- [[帮助:模板|]] 被转换为 [[帮助:模板|模板]],它被渲染为 模板
- [[编程: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 链接名称]
的形式(结果为 链接名称),链接名称与 URL 之间用空格分隔。没有链接名称的链接将显示为编号:[http://www.example.org]
变成 [1]。没有方括号的链接将完全显示:http://www.example.org。
Special:LinkSearch 查找链接到给定网站的所有页面。
外部链接语法也可用于链接到维基教科书中无法通过维基链接访问的特定页面版本,例如页面 历史记录、编辑视图、页面的旧版本、差异 两个版本之间等等。
要显示没有箭头图标的链接,请将外部链接语法放在<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将链接到本页的“Interwiki links”部分。锚链接也可以添加到外部链接和跨维基链接中,同样使用#语法。
跨语言链接
跨语言链接是指从英文维基教科书的任何页面到另一个语言维基教科书中几乎等效或完全等效页面的链接。
跨语言链接采用以下形式
- [[语言代码:标题]]
其中语言代码是根据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/>
标签扩展为显示脚注或参考文献的文本及其相应的编号,如下所示
对于单次引用,单击箭头 (↑) 将带您到正文中的引用点。对于多次引用,返回正文的链接通过字母上标 (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}}
文本的这一部分需要澄清,[note 1] 而整个文本都被引用了。[1]
- 注释
- ↑ 与引用分开列出
- 参考文献
- ↑ 引用。
请注意,目前,这些脚注本身不能包含参考文献链接。
脚注也可以在每段文本的末尾列出,方法是使用“close”参数关闭 {{reflist}} 模板,如上框所示。
列表定义的参考文献
该软件还允许在参考文献列表中定义命名参考文献,而不是在正文中。这可以使编辑页面变得更容易,尤其是在引用较多的部分。例如
The quick brown fox jumps over the lazy dog.<ref name="LazyDog"/>
<references>
<ref name="LazyDog">This is the lazy dog reference.</ref>
</references>
The quick brown fox jumps over the lazy dog.[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>
}}
How razorback-jumping frogs[注释 1] can level six piqued gymnasts.[1]
- 注释
- ↑ 电池未包含。
- 参考文献
- ↑ 这是关于跳蛙的参考文献。
列表
列表有三种类型:无序列表、有序列表和定义列表。
维基文本 | 渲染 |
---|---|
* 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 |
|
* 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 |
|
为简单起见,维基标记中的列表项不能超过一段。在列表项后面空一行将结束列表并重置有序列表的计数器。用空行分隔无序列表项在你的屏幕上看起来可能正常,但它创建了许多单独的单项列表,这对于使用 屏幕阅读器 的人来说是一个问题,会导致残疾人可访问性问题。
其他项目
常见任务
恢复
在维基教科书中,恢复是指撤消一个或多个编辑的效果,这通常会导致页面恢复到之前某个版本的页面。更广泛地说,恢复也可以指任何部分或全部逆转其他编辑者操作的行为。
此页面包含有关执行恢复的技术信息。但是,应牢记,恢复其他编辑者的善意行为(而不是 破坏)如果过度,则被视为破坏性行为,甚至可能导致恢复者被 阻止 编辑。
手动恢复
在某些情况下(例如,如果破坏者添加或删除了文本,并且此后进行了不相关的建设性编辑),撤消过去编辑的最简单方法可能是简单地编辑当前页面,删除错误添加的文本或恢复错误删除的文本(这可以从页面的过去版本复制并粘贴)。但是,从您希望恢复的更改之前恢复页面的特定旧版本可能更方便。为此
- 单击页面顶部的“历史记录”选项卡以显示 页面历史记录。
- 单击您希望恢复到的较早版本的日期和时间。您将看到类似以下的短语:“这是此页面的旧版本,由 ***.***.***.*** (talk) 于 2024 年 1 月 24 日 15:47 编辑。它可能与当前版本有很大不同。”
- 重要:在 破坏 的情况下,花时间确保您恢复到没有破坏的最后一个版本;可能存在多个连续的破坏性编辑,或者它们可能散布在建设性编辑之间。
- 像往常一样单击编辑选项卡以编辑页面。(在编辑框上方,您会看到类似以下的警告:“您正在编辑此页面的旧版本。如果您保存它,自那时以来的所有更改都将被删除。”)如果编辑需要注册帐户,请先登录,或在讨论页面上留言。
- 完成 编辑摘要 字段(缩写“rv”可以代表“恢复”;编辑摘要“rvv”表示“恢复破坏”)。
- 保存页面。
- 如果在您希望恢复的那些编辑之后进行了建设性编辑,请返回页面历史记录以查找这些编辑,并尽力手动重做它们。
如果恢复破坏,请检查破坏页面的用户的 贡献历史记录。如果此用户破坏了许多页面,请 向管理员报告。
撤消
MediaWiki 软件有时可以让编辑者轻松地恢复(或“撤消”)页面历史记录中的单个编辑,而不会同时撤消自该编辑以来进行的所有建设性更改。为此,请查看 页面历史记录 或编辑的 差异,然后单击该编辑旁边的“撤消”。该软件将尝试创建一个编辑页面,其中包含已删除不良编辑的页面版本,但保留所有后续编辑。有一个默认的编辑摘要,但在保存之前可以修改它。
也可以撤消几个连续的编辑,即使它们彼此冲突:查看要删除的差异(通过选择历史记录中的两个极端修订版并单击“比较选定修订版”),然后单击“撤消”链接。
此功能消除了手动重做在被恢复的编辑之后进行的有用更改的必要性。但是,如果撤消编辑会导致与后续编辑冲突,则会失败。例如,如果一个编辑添加了一段,而另一个编辑修改了该段,则无法自动撤消较早的编辑。在这种情况下,您必须确定如何手动解决问题。
回滚
已获得回滚功能访问权限的 管理员 和 审阅者 拥有其他链接,这些链接
- 仅出现在顶部编辑旁边
- 恢复所有最后编辑者所做的顶部后续编辑
- 立即生效,无需中间确认差异页面
- 添加自动 编辑摘要 “m 恢复 Example (讨论) 的编辑到 Example2 的最后一个版本”,将编辑标记为次要编辑
回滚链接出现在 用户贡献 页面、用户监视列表、历史记录页面 和 差异页面 上。请注意,在最后一种情况下,回滚链接可能会产生误导,因为恢复不一定指向显示的旧版本(差异页面可能显示编辑的组合结果,包括其他编辑者进行的一些编辑或回滚按钮将恢复的编辑的一部分)。要查看回滚按钮将恢复的更改,请查看将最后编辑者的最后一个版本与之前编辑者的最后一个版本进行比较的特定差异。
回滚比撤消快得多,因为它
- 允许恢复,甚至不需要查看修订版列表或差异
- 不需要加载编辑页面并将维基文本发回服务器
- 不需要单击保存按钮
另一方面,它不如撤消灵活,因为它不允许指定必须撤消哪些编辑。人们可能希望恢复的编辑比回滚操作多或少,或者不包括最后编辑的编辑。它也不允许在自动编辑摘要中添加解释,并且应该只用于恢复明显的破坏行为。
在没有解释的情况下回滚善意编辑,可能会被误解为“我认为你的编辑并不比破坏好,恢复它不需要解释”。一些编辑者对这种感知上的轻蔑行为很敏感;如果您使用回滚功能而不是破坏行为(例如,因为页面太大而导致撤消不切实际),那么在书籍的讨论页面或您已恢复其编辑者的讨论页面上留下解释是礼貌的。
如果有人在您单击“回滚”链接之前编辑或回滚了页面,或者没有之前的编辑者,您将收到错误消息。
重定向
重定向页面会导致导航到给定标题将读者直接带到另一个页面。读者首先访问的页面称为重定向页面。
重定向的语法
如果页面的维基文本以以下内容开头,则该页面将被视为重定向页面#REDIRECT后面跟着一个有效的维基链接或跨维基链接。链接前通常留一个空格。(注意,"REDIRECT" 的一些替代大写形式是可能的。) 按钮在编辑工具栏中可以用来生成这种语法。
请注意,重定向只有在链接指向同一个项目(英文维基教科书)上的现有普通页面(而不是特殊页面)时,才能按预期工作(即直接将读者带到目标页面)。在其他情况下,通常使用软重定向 - 请参阅下方。
示例
- #REDIRECT [[Help:Tracking changes]](重定向到Help:Tracking changes页面)
- #REDIRECT [[Help:Tracking changes#Preferences]](重定向到Help:Tracking changes页面中的“首选项”部分)
- #REDIRECT [[fr:Help:Tracking changes]](显示为指向法语维基教科书上的Help:Tracking changes页面的重定向,但不会作为真正的重定向起作用;这被称为“软重定向”)
在重定向链接之后出现的任何文本都将在显示中被忽略,但可以用来添加类别、注释等。
请注意,重定向链接必须是显式的 - 它不能包含变量、模板等。
将页面重定向到类别页面时,请在目标页面名前添加冒号以防止重定向显示在类别中。(从一个类别页面到另一个类别页面的重定向应该使用软重定向 - 请参阅下方。)指向文件页面的重定向也需要冒号。
重定向的显示
如果重定向目标是英文维基教科书上的现有页面,那么如果读者通过维基链接或URL导航到重定向页面,他们将被直接带到目标页面。但是,浏览器仍然显示重定向页面的 URL,目标页面在最顶部标题下方显示一条小通知,以表明您是通过重定向到达这里的。例如,如果您点击WB:RR,您将被重定向到Wikibooks:Reading room页面,页面的顶部将如下所示:
(从Wikibooks:RR重定向)
要让浏览器地址栏显示目标页面的规范 URL,请点击页面的标签。要转到重定向页面本身(编辑它、查看它的历史记录等),请点击“(从…重定向)”通知中的链接。
如果重定向目标是不存在的页面(红链接)、特殊页面或其他项目中的页面,则不会执行重定向,读者将看到重定向页面的显示(如下所示)。如果目标是现有页面中不存在的部分,则重定向将把读者带到目标页面的顶部。
请注意,重定向链不会被执行。如果标题 A 重定向到 B,而 B 本身也是一个重定向页面,那么导航到 A 的读者将看到重定向页面 B 的显示(如上所示)。这种情况被称为双重重定向。(机器人修复了此类链,以便每个重定向都直接指向最终目标页面。)
重定向的创建
重定向页面可以像任何其他页面一样创建。只需输入维基文本#REDIRECT [[xxx]],将“xxx”替换为目标页面的标题(可选地加上“#”符号和部分标题)。 按钮位于编辑窗口上方的编辑工具栏中,可以用来节省输入(点击它,然后插入所需的目标,或者键入目标,用鼠标选择它,然后点击按钮)。确保在 #REDIRECT 关键字之前没有文本,否则重定向将不起作用。通常也没有理由在链接之后放置任何文本,尽管有时会添加类别(或类别模板)。
同样地,任何现有的页面都可以被编辑以将其转换为重定向。如果创建新的重定向页面或将现有页面转换为重定向页面,将自动生成一个编辑摘要,说明该页面已被重定向到给定的目标。(如果编辑者提供了编辑摘要,则会覆盖此操作。)
当页面被移动(重命名)时,将自动从旧名称创建到新名称的重定向,以及相应讨论页面的重定向(如果它也被移动)。管理员可以选择阻止创建重定向。
如果新页面名称被一个重定向占用,该重定向的历史记录中只有一次编辑并且目标指向旧页面名称,那么它将被正在移动的页面替换。如果重定向有多个历史记录条目,或指向不同的目标页面,则必须由管理员进行移动。
要编辑已经是重定向的页面(或查看其历史记录、讨论页面等),请遵循重定向到目标页面,然后点击页面顶部“(从…重定向)”通知中的链接。这将带您到重定向页面本身。另一种访问重定向页面的方法是转到目标页面,然后点击“哪些页面链接到这里”(位于页面左侧的工具栏中)。这将显示所有指向该页面的反向链接,包括重定向。点击列表中的重定向将带您到重定向页面,而不是目标页面。
软重定向
作为普通“硬”重定向(将读者直接带到目标页面)的替代方案,可以创建“软”重定向,它将读者留在重定向页面上,让他们可以选择点击指向目标页面的链接。这通常在以下情况下进行
- 当目标位于其他项目(维基百科、其他语言的维基教科书等)或特殊页面上时。(在这种情况下,硬重定向在任何情况下都会表现得像软重定向。)
- 用于类别之间的重定向。(硬重定向将适用于类别页面,但由于软件无法从重定向类别中重新分类页面,因此软重定向更受青睐。)
软重定向是使用模板 {{soft redirect}} 和 {{category redirect}} 创建的。
潜在问题
页面保护
管理员可以保护页面以限制对该页面的编辑或移动,并删除此类保护。保护可以是无限期的,也可以在指定时间后过期。
可以在Wikibooks:Reading room/Administrative Assistance请求任何类型的保护或取消保护。对完全保护的页面的更改应在相应的讨论页面上提出。有关更多信息,请参阅Wikibooks:Protected page。
编辑冲突
如果其他人在你进行编辑时也进行了编辑,则会导致编辑冲突。许多冲突可以由维基自动解决。但是,如果无法解决,则需要手动解决。
为了了解编辑冲突是什么,请考虑以下情况
- 爱丽丝点击页面上的编辑。
- 鲍勃在爱丽丝编辑时点击了同一页面的编辑。
- 爱丽丝完成编辑并点击“保存页面”。页面被保存为爱丽丝的版本,而鲍勃仍在编辑。
- 鲍勃完成编辑并点击“保存页面”。鲍勃收到“编辑冲突”页面,因为软件无法自动协调鲍勃和爱丽丝版本的页面之间的差异。编辑冲突页面让鲍勃有机会手动协调差异。
布局
在编辑冲突页面的顶部是一个编辑框,其中包含爱丽丝版本的整个页面,即使鲍勃正在进行部分编辑。
在编辑冲突页面的底部是第二个编辑框,其中包含鲍勃要提交的文本。这将是鲍勃版本的页面或他正在编辑的部分。
在两个编辑框之间是一个差异,它显示了爱丽丝和鲍勃版本的页面之间的差异。对于鲍勃正在编辑的部分,它显示了鲍勃的更改和爱丽丝的可能更改,除了鲍勃和爱丽丝都进行了相同更改的部分。对于其他部分,它显示了完整的文本,就好像所有这些文本都被添加了一样。
鲍勃可以在上方的编辑框中编辑并按保存。
解决方案
如果鲍勃只做了很小的更改,而爱丽丝做了很大的更改,他可以选择从爱丽丝的版本开始,并将他的更改重新合并进来。鲍勃可以选择在编辑摘要中添加一些文本,例如“通过编辑冲突”,以警告爱丽丝和其他人他不得不这样做——爱丽丝然后可以检查他的合并是否准确。
如果鲍勃做了很大的更改,而爱丽丝做了很小的更改,他可以选择从他的版本开始。一个选择是让鲍勃将底部的文本复制到顶部的文本中(或者只是复制顶部的文本中的一节,如果鲍勃正在进行部分编辑),并加上适当的编辑摘要(例如,“通过编辑冲突,将重新合并”)。然后鲍勃可以查看页面历史记录,确定爱丽丝的更改,并在单独的编辑中将其重新应用到他的版本中。
如果爱丽丝和鲍勃都做了很大的更改,事情就会变得复杂,爱丽丝和鲍勃只能尽力而为。例如,如果爱丽丝和鲍勃同时在同一个主题上添加了一个很大的文本部分,那么最好的方法可能是让鲍勃提交他的更改,然后让爱丽丝和鲍勃都查看这两个版本,并决定他们之间哪个版本更好。
鲍勃不应该仅仅在他的修改覆盖艾丽丝的修改之上。我们假设善意——偶尔会犯错误,新手可能不理解编辑冲突窗口。然而,鲍勃不能经常性地忽略编辑冲突。鲍勃出于懒惰而覆盖艾丽丝的修改是绝对不可接受的。我们鼓励贡献者通过使用差异功能来仔细检查他们的合并。
预防
由于编辑冲突令人讨厌且耗时,您可能选择改变您的编辑习惯,以减少它们的发生频率。
最简单的方法之一是编辑页面中必要的最小部分。如果您只打算编辑页面中的单个部分,那么单击该部分的“编辑”链接,而不是整个页面的“编辑”链接。两个人可以同时处理不同的部分,就不会出现编辑冲突。
为了降低发生编辑冲突的可能性,维基教科书在其模板命名空间中也有一个“正在使用”通知,人们可以在长时间编辑页面时使用它。在进行重大编辑之前,只需在页面上放置{{正在使用}},并在编辑完成后删除模板。
另请参阅
Meta 有相关信息 |