Jump to content

Help:高级编辑

From mediawiki.org
This page is a translated version of the page Help:Advanced editing and the translation is 100% complete.
PD 注意:当您编辑本页面时,即同意以CC0协议授权您的贡献。您可以在公有领域帮助页面找到更多信息。 PD

Wikitext标记语言指引–打造您的页面外观

Help:编辑 包含了基础内容。

使用以下的Wikitext标记来制定您的页面外观。

组织您的文本–行、列表、段落和章节

渲染 Wikitext

开启章节与子章节

以标题划线开启一个章节

注意 注意:最高级别的标题如页面标题通过单个等号(=)表示。

一个章节
一个子章节
另一个孙章节
  • 避免使用一级标题(=),取而代之的是二级标题(==)。
  • 避免跳级。举个例子,不要从第二级跳到第四级。
  • 如果一篇文章有四个或四个以上的部分,一个table of contents 目录将会自动生成。
  • 以适当的顺序排列子章节。 例如,当列举国家时,应该按照字母顺序而不是OECD中的人口顺序或其它任意顺序。
  • 如果您不想让标题出现在目录中,可以使用HTML标题标签并不在标签末尾添加斜杆。 例如:
    <h4>级别过低的子标题也不会出现在目录中<h4>
    
== 章节 ==

=== 一个子章节 ===

=== 另一个孙章节 ===
  • 直接增加换行是无效的。

这是一行文本。 这依然是同一段落的一部分。

  • 空行表示新段落的开启或者列表、缩进部分的结束。 ‎<p>标签可以禁用段落直到‎</p>标签出现或者该章节结束。

这是一个段落。

这是上面那个段落的延伸。 但由于‎<p>‎</p>标签的出现,它出现在了空行的后面。

这是一行文本。

由于‎<div>‎</div>标签,这一行显示为了第二个新段落而不是第三个段落。

  • 在列表中,换行通常被用于分割项和子项,以在MediaWiki语法中提升列表内容的结构化程度和可读性。 参见List 示例。
这是一行文本。
这依然是同一段落的一部分。

这是一个段落。<p>这是上面那个段落的延伸。 但由于&lt;p>和&lt;/p>标签的存在,这行字出现在了空行之后。</p>

这是一行文本。<div>由于&lt;div>和&lt;/div>标签,这一行显示为了第二个新段落而不是第三个段落。</div>

可以在不产生新段落的情况下
进行换行。

  • 请不要过度使用这种方法。
  • 请不要跨行使用链接 斜体粗体,每行中的标记符号都要闭合。
可以在不产生新段落的情况下<br/>进行换行。
  • 在行首添加星号(*)可以创建无序列表的第一项。
    • 使用两个星号来标识子项。
      • 通过增加星号数量来标识更深的层级。
  • 每个换行符都代表着列表中的新项。

没有以星号开头的行代表着列表的结束。

  • 您可以重新开始创建一个新列表

至此您已经可以创建结构良好的无序列表了。

* 在行首添加星号(<code>*</code>)可以创建无序列表的第一项。
** 使用两个星号来标识子项。
*** 通过增加星号数量来标识更深的层级。
* 每个换行符都代表着列表中的新项。
没有以星号开头的行代表着列表的结束。
* 您可以重新开始创建一个新列表

至此您已经可以创建结构良好的无序列表了。
  1. 在每行开头使用一个井号(#)来表示顺序。
    1. 使用两个井号(##)表示子项。
    2. 继续编号以保持信息的顺序和逻辑连贯性。
  2. 在每个项目之间添加一个新行,以提高可读性。

不以井号开头的行表示列表的结束。

  1. 有序列表从“1.”开始。
  2. 然后是“2.”,依次类推。
# 在每行开头使用一个井号(<code>#</code>)来表示顺序。
## 使用两个井号(<code>##</code>)表示子项。
## 继续编号以保持信息的顺序和逻辑连贯性。
# 在每个项目之间添加一个新行,以提高可读性。
不以井号开头的行表示列表的结束。
# 有序列表从“1.”开始。
# 然后是“2.”,依次类推。
  • 这个混合列表以一个无序列表(*)开头。
    1. 要在无序列表下创建有序列表的子项,请使用星号和井号(*#)。
      • 要在有序列表中创建无序列表的更深层级子项,请再添加一个星号(*#*)。
      • 你也可以
        在列表中换行。
* 这个混合列表以一个无序列表(<code>*</code>)开头。
*# 要在无序列表下创建有序列表的子项,请使用星号和井号(<code>*#</code>)。
*#* 要在有序列表中创建无序列表的更深层级子项,请再添加一个星号(<code>*#*</code>)。
*#* 你也可以<br/>在列表中换行。

定义列表由一系列术语-定义对组成。

  • 使用分号(;)来表示一个术语的开始。
  • 将术语直接放在分号后面。
  • 使用冒号(:)来引出与该术语相关的定义。
  • 将定义放在冒号后面的行上。
Wiki
wiki(/ˈwɪki/ ⓘ WI-kee)是一种在线超文本出版物形式,可由其受众通过网络浏览器直接进行协作编辑和管理。 参见 w:Wiki
网络浏览器
网络浏览器是一个用于访问网站的应用程序。 参见 w:Web browser

每行表示一个项目是最合适的,而不是在冒号前换行(:)。

; Wiki
: wiki(/ˈwɪki/ ⓘ WI-kee)是一种在线超文本出版物形式,可由其受众通过网络浏览器直接进行协作编辑和管理。 参见 [[w:Wiki]]。
; 网络浏览器
: 网络浏览器是一个用于访问网站的应用程序。 参见 [[w:Web browser]]

缩进

当行首有冒号(:)时,段落会缩进,如定义列表 中所述。

一个缩进的行。

新的一行开始一个新的无缩进段落。

: 一个缩进的行。
新的一行开始一个新的无缩进段落。

引用块

引用块样式用于突出显示来自外部来源的特定文本部分,或使其与周围内容区分开来。

这是一个引用块。 它用于突出显示引用的文本或分隔特定内容。

<blockquote>
这是一个引用块。 它用于突出显示引用的文本或分隔特定内容。
</blockquote>

水平分割线

wiki页面上的水平分隔线由四个或更多连续的连字符(----)表示,这增强了各部分之间的视觉组织性。

分隔线上方的文本


分隔线下方的文本

分隔线上方的文本
----
分隔线下方的文本

链接

有关详细信息,请参阅Help:链接

基本信息:

  • 目标名称前后加上双方括号 – [[]]
  • 在新页面上,点击目标名称后,其首字母会自动大写。
  • 下划线用于表示空格。避免使用下划线。
  • 当你将鼠标悬停在链接上时,无需点击就能显示链接页面的预览。
渲染 Wikitext

基本

您正在阅读documentation

您正在阅读[[documentation]]

链接可以用斜体表示,例如:

MediaWiki

''[[MediaWiki]]''

跨wiki链接

这些链接指向另一个涵盖相关或相似主题的wiki。

这个维基间链接指向维基百科上的w:Documentation

它对应的世界语单词是eo:Dokumentaro

这个维基间链接指向维基百科上的[[w:Documentation]]。

它对应的世界语单词是[[:eo:Dokumentaro]]

章节链接

你可以通过在指定页面名称后添加一个井号(#)和章节标题,来链接到现有页面的特定章节。

Help:Special pages#Editing Special namespace pages

如果不存在这样的章节,那么该链接会指向页面的开头。 如果一个页面有多个名称相同的部分,请在末尾用数字标明该部分的次序。 (例如,如果有三个标题为“章节标题”的部分,而你想链接到第三个,请使用[[#章节标题 3]])。

参见 帮助:编辑常见问题

[[Help:Special pages#Editing Special namespace pages|Help:Special pages]]

使用竖线符号(|)创建链接标签

上方内容会产生关于链接,链接到文章 Help:Link

 * [[Help:Link|关于链接]]

空白链接标签

使用空白链接标签会自动填充合适的链接标签。 即 [[Kingdom (biology)|]] 将替换为 [[Kingdom (biology)|Kingdom]]

* 圆括号: [[kingdom (biology)|]].
* 冒号: [[Help:Pipe|]].

指向不存在页面的链接

当一个链接被指向不存在的页面时,会显示为红色(就像这个页面

要创建该页面,你可以点击这个链接。 参见 Help:创建页面 (以及您项目的命名约定,如果有的话)。

指向不存在页面的链接(如[[Foo|这个]])会以红色显示。

重定向

你可以通过在页面开头添加维基文本创建一个重定向。 参见Help:重定向

#REDIRECT [[美国]]
#REDIRECT [[美国]]

魔法链接

魔法链接 使用户能够通过输入特定关键词自动生成链接。

这些已过时,通常不应使用。

* ISBN 0131103629
* RFC 234

Media:链接

媒体链接用于引用包含媒体文件的页面。 它们可通过Media命名空间访问。

音频

[[media:Test.ogg|音频]]

分类链接

分类链接将用户引导至特定的分类页面(而不会将该页面归入该分类)。

为实现这一点,会使用一种与链接类似的语法,但要在命名空间前添加一个冒号(:)。

Category:Documentation

[[:Category:Documentation]]

特殊页面

特殊页面由wiki软件创建。 它们可通过特殊命名空间访问。

你可以使用以下格式创建指向“链入页面”等特殊页面的链接:

Special:Whatlinkshere/Help:Editing

其他特殊页面参见Help:特殊页面

[[Special:Whatlinkshere/Help:Editing]]

指向页面先前修订版本、差异(diffs)和特定历史页面的链接

要链接到旧版本、差异对比或特定的历史页面,请避免使用像[[页面]]这样的标准维基链接语法。 相反,请使用外部链接功能,或者直接复制粘贴提供的URL。

链接到页面的先前版本

要分享维基的旧页面版本,请从页面的历史记录中复制URL,然后将其粘贴到你想要分享的地方。

https://www.mediawiki.org/w/index.php?title=Help:Cite&oldid=6364084

你也可以使用Special:PermaLink来进行此操作,即Special:PermaLink/6364084

链接到差异:

要链接到两个修订版本之间的页面差异,请复制并粘贴包含所比较页面差异的特定页面URL。

https://www.mediawiki.org/w/index.php?title=Help%3ACite&diff=6364333&oldid=6364084

你也可以使用Special:Diff来进行此操作,即Special:Diff/6364333/6364084

从编辑历史链接到特定页面

导航至编辑历史,然后选择较旧XX条最旧按钮以查看特定的页面历史,接着复制该URL并粘贴到你想要分享的地方。

https://www.mediawiki.org/w/index.php?title=Help:Cite&action=history&offset=20170210105218%7C2391706&limit=100

https://www.mediawiki.org/w/index.php?title=Help:Cite&oldid=6364084

https://www.mediawiki.org/w/index.php?title=Help%3ACite&diff=6364333&oldid=6364084

https://www.mediawiki.org/w/index.php?title=Help:Cite&action=history&offset=20170210105218%7C2391706&limit=100

外部链接

在MediaWiki的默认配置中,外部链接不会在新的浏览器窗口/标签页中打开。[1]

Google, [1]
[http://www.google.com Google],
[http://www.google.com]
电子邮件示例,

[2]

[mailto:email@example.com 电子邮件示例],
[mailto:email@example.com]
或者只需提供http://www.google.com作为URL。
  • UTF-8编码中的每个符号。 例如:
    • ^%5e
    • ā (带长音符号的小写拉丁字母A) → %c4%81
  • 你也可以用下划线表示一个空格。
或者只需提供http://www.google.com作为URL。


格式化文本 – 自定义其外观

渲染 Wikitext
强调 (斜体), 强烈强调 (粗体), 非常强烈强调 (粗斜体).

(这些是两对撇号和三对撇号,而不是(一对)双引号。)

注意:这也可应用于链接(例如,Wikipedia)。

''强调'', '''强烈强调''',
'''''非常强烈强调'''''.

''[[Wikipedia]]''
在数学计算中,使用斜体粗体字体是有益的,因为这里需要的是特定的字体样式,而非强调。
F = ma

(大多数人忽视了这样一个事实:这两种方法的差异对于图形浏览器而言并非特别显著。) 然而,这可能会对盲人产生重大影响。

在数学计算中,使用<i>斜体</i><b>粗体</b>字体是有益的,因为这里需要的是特定的字体样式,而非强调。
: <b>F</b> = <i>m</i><b>a</b>
你可以写成 in small caps
你可以写成 <span style="font-variant:small-caps">in small caps</span>
偶尔用于技术术语计算机代码的打字机字体。
偶尔用于<kbd>技术术语</kbd><code>计算机代码</code>的打字机字体。
对于字幕,你可以使用 <small小号字/>。
对于字幕,你可以使用 <small小号字/>
删除的内容可以用删除线标出,新的内容可以用下划线标出。

你也可以分别使用已删除内容已插入内容标签来表示它们,这样能保留其语义,而不是仅仅依赖删除线和下划线等视觉提示。

  • 编辑普通文章时可以直接进行操作,无需使用特殊标记来表示删除或插入的内容。
  • 在修订讨论页上的先前评论时,标记可用于指示删除或插入的内容。
删除的内容可以用<s>删除线</s>标出,新的内容可以用<u>下划线</u>标出。

你也可以分别使用<del>已删除内容</del><ins>已插入内容</ins>标签来表示它们,这样能保留其语义,而不是仅仅依赖删除线和下划线等视觉提示。
下标: m2

上标:m2 或 m²

许多浏览器发现,格式化包含HTML实体&sup2; (²)的行比使用2 HTML标签来表示上标文本更简单。

ε0 = 8.85 × 10−12 C² / J m.

1 hectare = 1 E4 m²

下标: m<sub>2</sub><br />
上标:m<sup>2</sup> 或 m&sup2;

&epsilon;<sub>0</sub> =
8.85 &times; 10<sup>&minus;12</sup>
C&sup2; / J m.
<br /><br />
1 [[hectare]] = [[1 E4 m&sup2;]]


重新格式化和/或禁用wikitext解析

以下提供了管理格式和处理的方法。 有关示例中使用的代码{{tc}},请参考Template:Tc(参见Help:模板 )。

默认解释

  • 解释HTML实体
  • 解释维基标记,如文本加粗、斜体等。
  • 格式化文本(删除单个换行符、多个空格,并自动换行)
  • 用两个换行符创建新段落

箭頭 → in

斜体 鏈接

箭頭      &rarr; {{tc}}

''斜体''
[[help:Link|鏈接]]

用于保留单个换行符的poem标签

  • 解析HTML实体
  • 解释维基标记,如文本加粗、斜体等。
  • 格式化文本(删除单个换行符、多个空格,并自动换行)

箭頭 → in

斜体
鏈接

<poem>箭頭 &rarr; {{tc}}

''斜体''
[[help:Link|鏈接]]</poem>

<nowiki>

  • 解析HTML实体
  • 不要处理特殊的维基标记,如文本加粗、斜体等。
  • 重新格式化文本
  • 忽略双重换行以避免创建新段落;因此,每个段落都必须有其用途。

可以在行内应用: arrow → {{tc}} ''italics'' [[help:Link|link]] normal again

''可以在行内应用:'' <nowiki>
arrow      &rarr; {{tc}}

''italics''
[[help:Link|link]]
</nowiki>''[[normal]] again''

<pre>

  • 解析HTML实体
  • 不要处理特殊的维基标记,如文本加粗、斜体等。
  • 不自动换行
  • 按照浏览器的设置指示,使用等宽字体。

arrow      → {{tc}}

''italics''
[[help:Link|link]]
<pre>arrow      &rarr; {{tc}}

''italics''
[[help:Link|link]]
</pre>

行首空格

  • 解析HTML实体
  • 解释维基标记,如文本加粗、斜体等。
  • 不自动换行
  • 创建一个 ‎<pre> HTML 元素
  • pre元素以一个空行结束,如果还有更多带有前导空格的行,则会开始一个新的pre元素。

箭頭      → {{tc}}

''italics''
[[help:Link|link]]


If a line of plain text begins with a space
it will be displayed exactly
as entered
in a fixed-width font
inside a grey dotted-outline box
with no line breaks
END
此功能便于:
* 插入预格式化文本;
* 算法描述;
* 展示代码片段;
* 显示ASCII艺术;
* 展示化学图表;
* 诗歌排版

警告 警告: 当你把它调宽时,你就是在将整个页面调宽,因此可读性会降低。 不要用空格开头来写普通行。
(另见下文)

 箭頭      &rarr; {{tc}}
 
 ''斜体''
 [[help:Link|鏈接]]


 If a line of plain text begins with a space
 it will be displayed exactly
 as entered
 in a fixed-width font
 inside a grey dotted-outline box
 with no line breaks
 END
 此功能便于:
 * 插入预格式化文本;
 * 算法描述;
 * 展示代码片段;
 * 显示ASCII艺术;
 * 展示化学图表;
 * 诗歌排版

文字字符引用

&rarr;
&amp;rarr;

使用可展开的维基文本 (如{{t1demo|p ''q'' r}})时,使用<nowiki>{{t1demo|p ''q'' r}}</nowiki>将按原样显示维基文本。 然而,使用#tag 魔术词时,{{#tag:nowiki|{{t1demo|p ''q'' r}}}}会显示展开的维基文本startp ''q'' rend


杂项

签名

别忘了在讨论页上用波浪号(~)给你的评论“签名”。

三个波浪号会添加你的用户名: Example
四个波浪号会添加你的用户名和时间戳: Example 09:20, Mar 14 2024 (UTC)
五个波浪号会添加一个时间戳: 09:20, Mar 14 2024 (UTC)

服务器会在你保存时添加该链接。

: 三个波浪号会添加你的用户名: ~~~
: 四个波浪号会添加你的用户名和时间戳: ~~~~
: 五个波浪号会添加一个时间戳: ~~~~~
以下的文本

以上的文本不会被渲染
'''这'''以下的文本
<!-- 在此处留言 -->'''这'''以上的文本不会被渲染

添加另一页面 – 嵌入和模板

修改一个被嵌入的 页面会修改所有嵌入它的页面。

一种专为嵌入而设计的独特页面类型。 它们可在Template: 命名空间 中找到。 这些模板可以接受参数。 当你更新页面时,该页面上使用的所有模板都会列在编辑框之后。

在这个示例中,Quote 是一个用于显示引语的模板页面。

{{Template:Quote}}

嵌入

将另一页面的内容合并到当前页面中。 以下示例使用Quote模板页来执行上述模板的嵌入。 Quote模板处理通过参数提供的维基文本,并应用文本格式来生成嵌入输出。

这是嵌入引用的一个参数。
{{Quote|quote=这是嵌入引用的一个参数。}}

与编辑相关的数据库记录

数据库中的revision 表和recentchanges 表都包含编辑记录。

revision表存储页面历史和用户贡献列表,而recentchanges表管理最近更改、监视列表和新页面创建列表。

如果从recentchanges表中移除较早的编辑,而revision表中未删除任何内容,那么较早的编辑仍会在页面历史和用户贡献列表中显示,但不会出现在最近更改、相关更改监视列表或新页面列表中。

导入 页面修订版本时,更改会记录在 revision 表中,但不会记录在 recentchanges 表中。 这意味着,虽然修订会显示在页面历史和用户贡献列表中,但不会出现在最近更改、监视列表或新页面列表中。

参考资料