帮助:格式手册

From DragonWiki翼爪维基
提示
您当前访问的条目目前受到保护,只有管理员被允许编辑。
如果您认为有理由编辑其中的内容,请与管理团队联系。

本页面的内容来自mw:Help:Formatting/zh

常用Wiki编辑相关

创建

  • 在右上角搜索栏中输入想要创建的新条目的名称,出现未创建的提示后即可点击对应条目创建新页面
  • 条目中红色标注的即不存在的条目,点击即可创建

Hide隐藏

  • 实例
这是一条折叠信息
  • 代码

{{Hide|标题=这是一条折叠信息 |内容= 嗯 }}

Ref脚注

参见mw:Extension:Cite/zh#用法

实例(这里使用最简单的用法)

大家好,我是[1]

这里查看脚注具体内容

  1. 脚注
代码
大家好,我是<ref>脚注</ref>

这里查看脚注具体内容<references />

格式化文本

文本格式化标记

描述 用户键入 输出效果
文字(行中)格式化– 适用于任何地方
斜体文字
''斜体''

斜体

粗体文字
'''粗体'''

粗体

粗斜体
'''''粗斜体'''''

粗斜体

删除文本
<strike>删除文本</strike>
删除文本
局部禁止wiki标记
<nowiki>没有''标记''</nowiki>

没有''标记''

章节格式化-只能放在一行的开头
不同等级的标题
== 2级标题 ==

=== 3级标题 ===

==== 4级标题 ====

===== 5级标题 =====

====== 6级标题 ======

Note:
2级标题
3级标题
4级标题
5级标题
6级标题
分割线
之前文本
----
之后文本

之前文本


之后文本

无序列表
* 在行的开始
* 使用一个[[w:星号|星号]](*)。
** 更多的星号表示
*** 越来越深的层次。
* 换行标记 <br />不会停止列表。
*** 但是越级将产生一个空行。
用任何其他字符在段首将停止列表。
  • 在行的开始
  • 使用一个星号(*)。
    • 更多的星号表示
      • 越来越深的层次。
  • 换行标记
    不会停止列表。
      • 但是越级将产生一个空行。

用任何其他字符在段首将停止列表。

有序列表
# 在行的开始
# 使用一个[[w:井号|井号]](#)。
## 更多的井号表示
### 越来越深
### 的层次。
# 换行标记 <br /> 不会停止列表。
### 但是越级将产生一个空行。
# 空行

# 将结束列表并开始一个新的列表。
用任何其他字符在段首将停止列表。
  1. 在行的开始
  2. 使用一个井号(#)。
    1. 更多的井号表示
      1. 越来越深
      2. 的层次。
  3. 换行标记
    不会停止列表。
      1. 但是越级将产生一个空行。
  4. 空行
  1. 将结束列表并开始一个新的列表。

用任何其他字符在段首将停止列表。

定义
;事物一
: 事物一的定义
;事物二
: 事物二的第一种定义
: 事物二的第二种定义
事物一
事物一的定义
事物二
事物二的第一种定义
事物二的第二种定义
缩进文本
:缩进1字符
:: 缩进2字符
::::: 缩进多字符

Note: 但是这样可能导致阅读困难。
缩进1字符
缩进2字符
缩进多字符
列表的混合使用
# 第一条
# 第二条
#* 第二条第一点
#* 第二条第二点
# 第三条
#; 第三条事物一
#: 第三条事物一的定义
# 第四条
#: 第四条定义
#: 这种缩进列表不会换行
#: 并且常用来
#: 替换<nowiki><br /></nowiki>之中的<br />
# 第五条
## 第五条第一款
### 第五条第一款第一项
## 第五条第二款

Note: 使用了#: 或者 *: 来换行常常带来阅读困难(显示问题)。
  1. 第一条
  2. 第二条
    • 第二条第一点
    • 第二条第二点
  3. 第三条
    第三条事物一
    第三条事物一的定义
  4. 第四条
    第四条定义
    这种缩进列表不会换行
    并且常用来
    替换<nowiki>
    </nowiki>之中的
  5. 第五条
    1. 第五条第一款
      1. 第五条第一款第一项
    2. 第五条第二款
预格式化文本
 在行首使用空格。文本被'''预格式化'''并且'''''可以'''''使用''维基标记''。

Note: 这种办法常用来给文章的某部分排版。对字符进行格式化的维基标记仍然有效。
在行首使用空格。文本被预格式化并且可以使用维基标记
预格式化文本块
  <nowiki>在第一列使用空格,
(在 <nowiki> 之前)。

您文本块的格式将保留。

这个功能对于拷贝代码块很有用:

def function():
    """documentation string"""

    if True:
        print True
    else:
        print False</nowiki>
在第一列使用空格,
(在 <nowiki> 之前)。

您文本块的格式将保留。

对于源代码的拷贝很有帮助:

def function():
    """documentation string"""

    if True:
        print True
    else:
        print False</nowiki>

段落

Mediawiki忽略单个换行。要想另起一段,请留空一行(两个换行)。您也可以使用HTML标记<br />强制换行另起一段。

HTML 标记

在 MediaWiki 中允许使用一些 HTML 标记。比如<code>, <div>, <span> and <font>等。这些标记将在你插入它们的地方生效。

描述 您输入的 输出效果
插入标记
(在很多浏览器中显示为下划线)
<ins>插入标记</ins>

或

<u>下划线</u>

插入标记

下划线

删除标记
(在很多浏览器中显示为删除线)
<s>划掉</s>

或

<del>删除线</del>

划去

删除线

等宽字体
<code>源代码</code>

或

<tt>等宽字体</tt>

源代码

等宽字体

引用的内容
之前的文本
<blockquote>引用的内容</blockquote>
之后的文本

之前的文本

引用的内容

之后的文本

评论
<!-- 这行是注释 -->
注释只能编辑时在编辑区域内看到。

注释只能编辑时在编辑区域内看到。

完全预格式化文本
<pre>文本被'''预格式化'''并且''标记'' '''''不能''''' 起作用</pre>

Note: 要想在预格式化好的文本中使用标记,请参考前一个表格最后的预格式化文本
文本被'''预格式化'''并且''标记'' '''''不能''''' 起作用
自定义预格式化文本
<pre style="color: red">文本被某种样式'''预格式化'''并且''标记'' '''''不能''''' 起作用</pre>

Note: CSS 样式能够用 style 特性来命名。
文本被某种样式'''预格式化'''并且''标记'' '''''不能''''' 起作用

续表:

描述 您输入的 输出效果
自定义预格式化文本中回行取决于可用宽度
<pre style="white-space: pre-wrap; 
white-space: -moz-pre-wrap; 
white-space: -pre-wrap; 
white-space: -o-pre-wrap; 
word-wrap: break-word;">
这句长句子用来展示文本回行(为了凑足长度而加的一句话,跟英文版不同)。后面的这句话使得这段文字更长。
</pre>
这句长句子用来展示文本回行(为了凑足长度而加的一句话,跟英文版不同)。后面的这句话使得这段文字更长。
预格式化文本中回行取决于可用宽度
<code>
这句长句子用来展示文本回行(为了凑足长度而加的一句话,跟英文版不同)。后面的这句话使得这段文字更长。
</code>

这句长句子用来展示文本回行(为了凑足长度而加的一句话,跟英文版不同)。后面的这句话使得这段文字更长。

插入符号

对于用键盘无法直接录入的符号和其他特殊字符,您可以用一种特殊字符序列来插入他们。那种序列被称为HTML实体。比如,&rarr;就是一个序列(实体)。当这个序列被插入时,将会显示为右箭头的 HTML 符号 →;&mdash;插入位置将会显示为破折号(译者注:英文破折号) HTML 符号 —。


Note: 鼠标悬停在任意字符上,就可以看到它产生的符号。有些在当前字体库中不可用的将显示为空格。
HTML symbol entities
Á á Â â ´ Æ æ À à Α α & Å å Ã ã Ä ä Β β ¦ Ç ç ¸ ¢
Χ χ ˆ © ¤ ° Δ δ ÷ É é Ê ê È è Ε ε Η η
Ð ð Ë ë ƒ ½ ¼ ¾ Γ γ > Í í Î î ¡ Ì ì Ι ι
¿ Ï ï Κ κ Λ λ « < ¯ µ · Μ μ  
¬ Ñ ñ Ν ν Ó ó Ô ô Œ œ Ò ò Ω ω Ο ο ª º Ø ø Õ õ Ö
ö Φ φ Π π ϖ ± £ Ψ ψ " » ® Ρ ρ
Š š § ­ Σ σ ς ¹ ² ³ ß Τ τ Θ θ ϑ Þ þ ˜
× Ú ú Û û Ù ù ¨ ϒ Υ υ Ü ü Ξ ξ Ý ý ¥ ÿ Ÿ Ζ ζ
说明 您输入的 输出效果
版权标记
&copy;
©
希腊字符Δ标记
&delta;
δ
欧元标记
&euro;

查阅所有的 HTML 实体列表请前往维基百科的文章XML与HTML字符实体引用列表。同时, MediaWiki 支持两种非标准的实体引用序列: &רלמ;&رلم; 这些都与&rlm;同等考虑,这是一个右至左符号。(当右至左和左至右语言混合显示在同一页面时使用。)

HTML标记和符号实体显示它们自身(不管是否解释)

&amp;euro;  → &euro;
<span style="color: red; text-decoration: line-through;">待纠正的笔误</span>  → 待纠正的笔误
&lt;span style="color: red; text-decoration: line-through;">待纠正的笔误</span>  → <span style="color: red; text-decoration: line-through;">待纠正的笔误</span>

nowiki标记与HTML

<nowiki /> 能禁用(HTML)标记:

  • <<nowiki />pre>  → <pre>

& 标记也没漏网:

  • &<nowiki />amp;  → &

像文本一样打印 & 符号,用 "&amp;" 替换 "&" 字符 (例: 输入 "&amp;nbsp;", 结果是 "&nbsp;")。

表格

Wiki 标示语言一览

{| 表格 起始
|+ 表格 标题, 选用; 每张表格只能出现一次且介于表格起始与第一行
|- 表格行, 第一行选用 -- wiki 引擎会假设是第一行
! 表格标题 储存格, 选用。 可以使用(!!)在同一行加入接续的表格标题或是單獨使用 (!)换新的一行 。
| 表格资料 储存格, 必要! 可以使用(||)接续表格资料储存格或是单独使用 (|)。
|} 表格结束
  • 上述符号必须出现在新行的开头除了当在同一行中想要延续储存格所增用的双 || 与 !! 。
  • XHTML 属性。每一个符号,除了表格的末尾,可选择性的接受一或多个 XHTML 属性。 属性必须与符号在同一行。请使用一个空格隔开每一项属性。
    • 储存格与标题 (| 或是 ||,! 或是 !!,以及 |+) 持有表格内容。 所以要使用单线(|)来区隔属性与内容。储存格内容可以都位在同一行或是换到另一行。
    • 表格与行的符号({| 与 |-) 并不直接持有内容。 在它们的属性之后请不要加入管线(|)。 如果你在表格与行符号的属性之后错误的加入管线符号,剖析器会将之删除 以及之后任何触及该出错管线的属性!
  • 内容 (a) 可以任何选用的 XHTML 属性之后跟著同一行它的储存格标记或是 (b) 储存格标记的下一行。 使用 wiki 标示语言的内容本身需要自新的一行开始,例如清单,表头,或是表格内接的表格,必须在它自个儿的新行。

简单的表格

普通

下面这个表格没有外框与留白,但是显示了最简单的 wiki 表格标示语言的结构。

橘子 苹果
面包
奶油 冰淇凌
{|
|橘子
|苹果
|-
|面包
|饼
|-
|奶油
|冰淇凌 
|}

另一种标记方式

想要排列得更像表格,可以使用 wiki 标示语言 || 将储存格分开但又并排于同一行。 这个方法对于储存格要放入比较长的文字内容,如段落时,其长短的调整并不佳。 它最适合用在简短的内容,例如此处所作的表格例子。

你也可以在储存格之间的 wiki 标示语言加入额外的空格,如同下面我对 wiki 标示语言所作的, 可以使得 wiki 标示语言本身排列的更好看但又不影响表格的产生。

HTML 属性可以被加入本页的表格示例。但是为了简化,在下述的例子中并没有写出来。

橘子 苹果 更多
面包 更多
奶油 冰淇凌 以及更多
{|
|   橘子   ||   苹果  ||   更多
|-
|   面包   ||   饼    ||   更多
|-
|   奶油   ||  冰淇凌  ||  以及更多
|}

搭配 HTML 属性

你可以加上 HTML 属性让你的表格看起来更漂亮

border="1"

橘子 苹果
面包
奶油 冰淇凌
{| border="1"
|橘子
|苹果
|-
|面包
|饼
|-
|奶油
|冰淇凌 
|}

align="center" border="1"

橘子 苹果
面包
奶油 冰淇凌
{| align="center" border="1"
|橘子
|苹果
|-
|面包
|饼
|-
|奶油
|冰淇凌 
|}

align="right" border="1"

你可以将属性加诸于个别的储存格。 例如数字靠右对齐会比较好看

橘子 苹果 12,333.00
面包 500.00
奶油 冰淇凌 1.00
{| border="1"
|橘子
|苹果
|align="right"|12,333.00
|-
|面包
|饼
|align="right"|500.00
|-
|奶油
|冰淇凌
|align="right"|1.00
|}


你也可以将属性加诸于个别的

橘子 苹果 12,333.00
面包 500.00
奶油 冰淇凌 1.00
{| border="1"
|橘子
|苹果
|align="right"|12,333.00
|-
|面包
|饼
|align="right"|500.00
|- style="font-style:italic;color:green;"
|奶油
|冰淇凌
|align="right"|1.00
|}

cellspacing="0" border="1"

橘子 苹果
面包
奶油 冰淇凌
{| cellspacing="0" border="1"
|橘子
|苹果
|-
|面包
|饼
|-
|奶油
|冰淇凌 
|}

cellpadding="20" cellspacing="0" border="1"

橘子 苹果
面包
奶油 冰淇凌
{| cellpadding="20" cellspacing="0" border="1"
|橘子
|苹果
|-
|面包
|饼
|-
|奶油
|冰淇凌 
|}

搭配 HTML 属性与 CSS 样式

CSS 样式属性可以同时搭配或不搭配其他 HTML 属性

style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"

橘子 苹果
面包
奶油 冰淇凌
{| style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"
|橘子
|苹果
|-
|面包
|饼
|-
|奶油
|冰淇凌 
|}

搭配 TH 表头的表格

TH (HTML 表头的表格) 可以使用 ! 而非 | 来指明。 依照预设,表头通常是粗体字与置中对齐。

表头

各栏

好吃 更好吃
橘子 苹果
面包
奶油 冰淇凌
{| border="1" cellpadding="20" cellspacing="0"
!好吃!更好吃
|-
|橘子|苹果
|-
|面包|饼
|-
|奶油|冰淇凌 
|}

Colspan="2"

好吃的东西
橘子 苹果
面包
奶油 冰淇凌
{| border="1" cellpadding="20" cellspacing="0"
! colspan="2"|好吃的东西
|-
|橘子
|苹果
|-
|面包
|饼
|-
|奶油
|冰淇凌 
|}

侧表头

预设

水果 橘子 苹果
主食 面包
甜点 奶油 冰淇凌
{| border="1" cellpadding="20" cellspacing="0"
!水果
|橘子
|苹果
|-
!主食
|面包
|饼
|-
!甜点
|奶油
|冰淇凌 
|}

靠右对齐

如下作出靠右对齐的效果

水果 橘子 苹果
主食 面包
甜点 奶油 冰淇凌
{| border="1" cellpadding="20" cellspacing="0"
!align="right" |水果
|橘子
|苹果
|-
!align="right" |主食
|面包
|饼
|-
!align="right" |甜点
|奶油
|冰淇凌 
|}

标题

标题可以如下的方式加到任何表格的第一行

食品和配餐
橘子 苹果
面包
奶油 冰淇凌
{| border="1" cellpadding="20" cellspacing="0"
|+食品和配餐
|-
|橘子
|苹果
|-
|面包
|饼
|-
|奶油
|冰淇凌 
|}

属性也可以如下的方式放到标题内

食品和配餐
橘子 苹果
面包
奶油 冰淇凌
{| border="1" cellpadding="20" cellspacing="0"
|+align="bottom" style="color:#e76700;"|''食品和配餐''
|-
|橘子
|苹果
|-
|面包
|饼
|-
|奶油
|冰淇凌 
|}

表格搭配 H1, H2, H3 等标题

你可以使用 ==等于== 号来製作 HTML H1, H2, H3, H4 等类型的标题,必须紧靠成行才有效果。

预览整个表格 如果你在表格之内的标题选取编辑标籤编辑,预览,其母表格会因部份会断落而无法完整的显示出来。

保持标题架构与页面的其他部份一致来使得页面上方的目录能正确的显示。

最好吃的

橘子 苹果
面包
奶油 冰淇凌
{| border="1" cellpadding="20" cellspacing="0"
|colspan="2"|
===最好吃的===
|-
|橘子
|苹果
|-
|面包
|饼
|-
|奶油
|冰淇凌 
|}

注意事项

负数

如果你要在一行的第一个单元格中显示负数(例如 |-6 ),其中的负号可能会导致显示不正常。因为MediaWiki软件会认为你的标记并不是新单元格,而是新行 (|-)。

避免的方法是在负号前加空格 (| -6) 或者使用单行单元格标记(||-6)。

链接

内部链接

要想添加内部链接,请将您想要链接的页面的名字放入双层方括号中。当您保存页面时,您将看到新的链接指向您想要的页面。如果页面已经存在,它将显示为蓝色,如果不存在将显示为红色。 链接到自身将无法转化为URI但是会加粗显示。 (如果您确实需要链接到当前页面,请使用锚点(见下文),或者使用[[#top|当前页面]] 将生成指向当前页面顶端的链接。)

对于英文,目标面名字的第一个字母将自动大写,除非被超级用户设置为不大写,并且空格将被显示为下划线。(在链接中直接打出一条下划线将与打出一个空格有相似的效果,但是并不建议这么做,因为下划线将会在文章中显示出来。)


描述 您输入的 输出效果
内部链接
[[首页]]

[[帮助:格式手册]]
首页

帮助:格式手册

管道链接
[[Main Page|different text]]

[[Main Page#Concrete_Paragraph|different text2]]

请参阅:meta:Special:MyLanguage/Help:Piped link|元维基上关于Piped link的帮助

different text

different text2

Pipe trick
[[Studio讨论:互助客栈|]]

[[用户:Zhw|]]

管道装饰快速产生较短的链接文字,但是在动态页面列表的状况下将会让人搞糊涂。

互助客栈

Zhw

带后缀的链接,遵从被称为“链接后缀规则”根据每种语言本地化。(本项主要适用于其他语言)
[[Help]]s

[[Help]]ing

[[Help]]ers

[[Help]]almostanylettersyoulikehere

Helps

Helping

Helpers

Helpalmostanylettersyoulikehere

如何防止自动生成带后缀的链接(本项主要适用于其他语言)
[[Help]]<nowiki />ful advice

[[wikipedia:GNU General Public License|GPL]]<nowiki />v3

Helpful advice

GPLv3

重定向
#REDIRECT [[Main Page]]

另见帮助:重定向

Main Page
指向锚点的内部链接
[[#See also]]

章节标题页面顶端自动成为锚点。

#See also
使用不同文字顯示指向锚点的内部链接
[[#See also|different text]]
different text
设置内部链接的锚点
<div id="NameOfAnchorHere">optional text</div>

Omit the "optional text" for invisible anchor.

optional text
内部链接到其他页面上的描点
[[Help:Images#Supported media types for images]]
Help:Images#Supported media types for images
内部链接到本页面的讨论页
[[{{TALKPAGENAME}}|Discussion]]

请参阅:Help:Magic_words#Page_names

Discussion
内部链接到子页面
[[/example]]

快捷方式指向[[Help:Links/example|/example]]。请参阅:Help:subpages.

/example
内部链接到没有前导斜杠的子页面
[[/example/]]

Shortcut for [[Help:Links/example|example]].

example
内部链接到分类页面
[[:Category:Help]]

另见Help:分类

Category:Help
指向图片或文件的内部链接
[[media:example.jpg]]

[[media:example.pdf]]

另见Help:图片

media:example.jpg

media:example.pdf

内部链接到用户页
[[Special:MyPage]]
Special:MyPage
内部链接到用户讨论页
[[Special:MyTalk]]
Special:MyTalk

测试沙盒

看完了?手痒了?那赶快去测试沙盒试试吧! 你知道的,点这儿就能进测试沙盒了