跳转至内容

使用 Wikibooks/Wiki-标记

来自 Wikibooks,为开放世界提供开放书籍


Wikitext 基础

[编辑 | 编辑源代码]

Wikitext 非常简单,学习它的最佳方法之一是观察和实践。当您看到一个具有精美格式的页面时,点击“编辑此页面”查看代码。有些东西不言自明,有些则不然。

正如我们之前提到的,Wikitext 通常可以与 HTML 和 CSS 代码互换使用。如果您不熟悉 HTML 和 CSS,您可能难以独立复制一些更高级的格式。但是,不要绝望!没有截止日期,事情不需要立即完美,您有足够的时间在这里学习和实验。

如果您想尝试使用 Wikitext 和编辑,您可以访问 沙盒。沙盒是一个您可以进行编辑而不会惹麻烦的页面。如果您想尝试一些东西,请在沙盒中进行!

可以通过在代码中创建新的段落来创建新的段落。例如

This code will create 2 paragraphs. This is the first.

This is the second.

将为您提供

此代码将创建 2 个段落。这是第一个。

这是第二个。

格式:粗体和斜体

[编辑 | 编辑源代码]

文本可以加粗或斜体来强调某个单词或短语。要加粗文本,请在您要加粗的单词或短语前后放置三个撇号(''')。例如

'''This is an incredibly bold statement'''

将为您提供

这是一个非常大胆的声明

加粗通常用于重要术语的首次出现,例如在数学书中您可能会看到“积分学是...”,后面是定义。加粗的另一个用途是使用整个句子来强调重要信息,例如在化学书中,可能会给出黑火药的配方,但之后可能会出现类似“不要在家尝试制作!”的提示。您可能想到更多加粗文本的用途,这些只是一些通用的示例。

要使文本斜体,请在您要斜体的短语前后放置两个撇号('',不要与引号“”混淆)。例如

''This sentence looks slanty''

将为您提供

这句话看起来倾斜

斜体文本可用于在陈述观点时为文本添加强调,例如“您并不真正需要这样做,但是...”,人们可能会在他们的脑海中以比看到普通“really”更长的音调读出“really”。另一个用途是在命名书籍和电影标题时,例如“在威廉·莎士比亚的罗密欧与朱丽叶中,...”

这两种格式可以通过先放置加粗文本的 3 个撇号,然后放置斜体文本的 2 个撇号来组合。例如

'''''A bold Italian might write like this...'''''

创建

一个大胆的意大利人可能会这样写...

这可以用来强调重要信息,同时提供与斜体相同的强调效果。如果您正在为一本书制作注释文本,也可以使用它。您可能会以 Wikitext 开头

J. R. R. Tolkien's novel, '''''The Lord of the Rings''''', was written...

这将显示为

J. R. R. 托尔金的小说指环王... 写成。

项目符号和编号列表

[编辑 | 编辑源代码]

要创建项目符号列表,只需在每个列表项前面放置一个星号。例如

*Number one
*Number two
*Number three

将显示为

  • 第一条
  • 第二条
  • 第三条

您还可以缩进特定的项目符号。为此,只需在行的开头添加另一个星号。例如

*Number one
**Number two
*Number three

将显示为

  • 第一条
    • 第二条
  • 第三条

编号列表同样简单。在每个列表项前面放置一个 # 符号,它们将被自动编号。例如

#Number one
#Number two
#Number three

将显示为

  1. 第一条
  2. 第二条
  3. 第三条

编号列表也可以缩进。在每行的开头添加另一个 #,如下所示

#Number one
#Number two
##Number two point one
##Number two point two
#Number three

这将显示为

  1. 第一条
  2. 第二条
    1. 第二条点一
    2. 第二条点二
  3. 第三条

预格式化文本

[编辑 | 编辑源代码]

预格式化文本以固定宽度字体(如 Courier)呈现,并尊重文字空格。这对于编写软件代码最有用,但也适用于其他需要以特定方式对齐内容的地方。通常,使用表格或 div 应该用于对齐数据,但有时预格式化文本可以完成您想要的内容,并且效果更好。

This is preformatted text. Text here will render
exactly how it appears. If you do not add inline
breaks when you edit this page, the text will run
off the edge of the screen. Notice how this text
appears in a little box? We can put text where
we want it:
 A
      B
           C


固定宽度字体适合对齐内容并显示文字空格的文字。它通常被认为不利于可读性,并且可能更难编辑,因为需要监视空格。

[编辑 | 编辑源代码]

大约有两种方法可以链接到 Wikibooks 中的其他页面。一种方法是简单地在代码中放置页面的 URL,例如

https://wikibooks.cn/wiki/Main_Page

给出

这在仅对 Wikibooks 中的另一个页面进行简单链接时是一个不好的主意,因为它看起来不太整洁,并且更多地保留用于指向其他网站的外部链接以供参考和额外阅读,例如,关于无稽之谈的 Wikibook 可能会在其“外部链接”部分中包含 http://www.encyclopediadramatica.com 用于进一步阅读。

对于指向 Wikibooks 中其他页面的简单链接,您需要获取 URL 中 https://wikibooks.cn/wiki/ 之后的部分,在上例中为 Main_Page,然后在其周围放置一对双括号,如下所示

[[Main_Page]]

这将生成

Main_Page 是 Wikibooks 主页的名称。您可能想知道为什么您的链接中有一个下划线,而您看到的其他所有链接都只有空格。在创建链接时,mediawiki 软件会用下划线替换空格,因为 Wikibooks 中的页面名称以及其他 Wikimedia 项目不允许页面名称中包含空格。因此,您可以使用 [[Main Page]] 做同样的事情。页面名称的另一个特点是它们始终以大写字母开头,并且运行 Wikibooks 的软件会自动将链接中的第一个字母转换为大写,因此您可以键入 [[main Page]] 并获得相同的结果。

您可能想知道现在页面名称是否区分大小写,因为唯一的“P”在所有其他小写字符中显得格格不入。实际上是区分大小写的,所以 [[main Page]] 和 [[main page]] 将链接到两个不同的页面。

Try clicking on [[main Page]] and [[main page]] to see the difference.

尝试点击 主页主页 来查看区别。

您可能想知道,如果这两个链接应该指向不同的页面,为什么它们反而指向同一个页面。这是因为 [[main page]] 指向一个重定向页面。因此,当您点击链接时,您将访问 https://wikibooks.cn/wiki/Main_page,但该页面将被 https://wikibooks.cn/wiki/Main_Page 中的页面替换,并且在页面的左上角有一小段文字说(从 主页 重定向)。

这是一个非常有用的功能,它使链接到页面变得容易得多,因为人们已经想到了人们在链接到特定页面时可能会尝试的常用页面名称,并且创建了这些页面作为重定向,这样我们这些普通人就不必为大小写敏感的问题而烦恼。

这就是你在维基教科书中链接页面的方法。你也可以链接到子页面,例如

[[Using_Wikibooks/The_Wikibooks_Editor/Cleanup_and_Maintenance]]

给出

这看起来很丑,和发布页面的 URL 一样糟糕。可以通过使用管道字符 | 来避免这种情况。在页面名称的末尾添加一个管道字符,然后在双括号内键入另一个名称,你可以更改链接显示的文本而无需更改链接本身。因此,与其使用像 使用维基教科书/维基教科书编辑器/清理和维护 这样的长链接,你可以这样做

[[Using_Wikibooks/The_Wikibooks_Editor/Cleanup_and_Maintenance|Cleanup and Maintenance]]

它会显示

无论你是否在链接中添加空格来间隔元素并提高可读性都没有关系

[[ Using_Wikibooks/The_Wikibooks_Editor/Cleanup_and_Maintenance | Cleanup and Maintenance ]]

仍然会显示

通常最好链接到整个页面,但有时你可能想链接到页面的某个部分。为此,在要链接到的页面名称后添加一个 # 和该部分的名称。所以

[[Using Wikibooks/The Wikibooks Editor/Cleanup and Maintenance#Moves and Mergers|Moves and Mergers]]

给出

从长远来看,链接到特定部分可能有点风险,因为如果该部分后来被重命名,链接将只指向目标页面的顶部。如果你在指定链接目标时使用了错误的名称,即使是轻微的错误,也会出现同样的情况;例如,如果你使用了错误的大小写来指定链接目标,

[[Using Wikibooks/The Wikibooks Editor/Cleanup and Maintenance#Moves and mergers|Moves and Mergers]]

将会显示

大多数链接指向同一本书中的页面,大多数非同一本书的链接指向维基教科书中的其他页面,但有时我们会链接到其他姊妹项目,例如维基百科。要链接到姊妹项目中的页面,请在目标页面名称前加上姊妹项目名称和冒号;大多数项目都有一个或两个字母的缩写可以用来代替。例如,你可以使用 [[w:Tensor calculus|tensor calculus]][[wikipedia:Tensor calculus|tensor calculus]] 链接到维基百科,这两者都会显示 tensor calculus.

← 如何编辑维基教科书 · 使用维基教科书 · 清理和维护 →

华夏公益教科书