Manual:Handbook

From NeoWiki

Revision as of 08:32, 28 February 2007

编辑上手

基础编辑如前文所述，下面是关于链接、图像、格式的说明。

链接

产生内部链接

如需引用Wiki内部其他文章，可编辑文本，用两个中括号里将该文章的标题括起来，保存编辑内容后将自动产生链接。例如编辑时输入“[[Manual:FAQ]]”，保存后显示为“Manual:FAQ”。

如果链接的文章存在，点击链接将直接进入该页面；对于不存在的文章，链接将显示为红色，点击它进入创建该文章的编辑页面。

改变链接文字

如果链接名称不符合文章需要，我们可以用在链接中附加“|说明文字”的方式，强制链接显示为指定文字。例如输入“[[Manual:FAQ|常见问题]]”，保存后显示为“常见问题”。

引用外部链接

对于原样显示的外部链接，直接书写完整的URL即可，例如http://www.google.com 。注意这里为防止系统不能正常判断网址结束，一般要在网址之后增加一个空格。

对于不直接显示网址而需要显示说明文字的外部链接，则应采用“[网址 说明文字]”的方式书写。例如输入[http://www.google.com Google]，将显示为 Google。注意：在URL和说明文字之间需要一个空格。

图片的URL不能直接书写，Neo-Wiki打开了相关的设置，直接书写的图片URL会直接显示该图片，所以可以采用“[http://matrix.foresee.cn/blogs/neo/images/ragnarok.gif <nowiki>http://matrix.foresee.cn/blogs/neo/images/ragnarok.gif</nowiki>]”的形式书写，效果为：http://matrix.foresee.cn/blogs/neo/images/ragnarok.gif

排版格式

多级标题

文章较长而需要设置段落标题时，可使用“==一级标题==”、“===二级标题===”等标记。2个等号表示一级标题，3个等号是二级标题，直至6个等号。系统将自动根据标题等级显示出不同的字体效果。

注意：文章标题要求在行首书写，结尾的等号之后不能紧跟文字，否则MediaWiki系统将无法识别。

缩进与列表

MediaWiki中的缩进不能使用半角空格调整。有以下几种方式控制缩进格式缩进：

• 行首使用半角:号：允许多个半角冒号连用，以控制不同文本缩进深度。
• 行首使用半角*号：行首星号是列表控制符，产生列表的同时伴有不同的文本缩进。允许多个星号连用。
• 行首使用半角#号：数字序号的列表控制符，与星号类似。注意，多个#号行中夹有非#号起始的文本行时，数字序号会中断。
• 使用;与:号配合：分号与冒号称为“定义列表”控制符，冒号之后的部分换行缩进显示。
• 行首使用全角空格：一种非正规手段，不建议使用。

举例：

一个冒号引导的文本行

两个冒号引导的文本行

• 一个星号引导的文本行
  • 两个星号引导的文本行

• 一个冒号、一个星号也可以有效果

1. 一个#号引导的文本行
2. 又一个#号引导的文本行
   1. 两个#号引导的文本行

分号与冒号配合使用

与前面分号写在一行中，放在冒号之后的部分会被自动换行缩进

换行问题

文本内容换行了，为什么显示结果不换行？

Wiki文本中，单独回车并不会出现换行。为强制换行，可以：

• 增加空行会分开不同的段落(即两个以上的空行作为分段符)；
• 在换行位置使用强制换行标签“<br>”

为什么出现不自动换行的超宽文本？

这是因为行首出现了空格，删除即可。MediaWiki中的行首空格另有作用。

使用图片

• Neo-Wiki目前开放了对于以下图片格式的上传和显示支持：PNG/GIF/JPG/JPEG/SVG，其他暂不支持。

• 对于站外图片，直接在文本中书写http链接即可，例如“http://matrix.foresee.cn/blogs/neo/images/ragnarok.gif”，效果如下：

• 可以使用Special:Upload页面上传图片后作为站内图片使用，方法和上面描述的外部资源不一样。

图片文件不能使用中文名称，应在上载时指定为英文名称。

上载完成后，图片即可被引用。引用方式为在文章编辑时加入“[[Image:Filename.xxx]]”，注意这里文件名是大小写敏感的，不要写错了。

对于上传的图片，还可以随意指定显示大小、左右位置、添加说明文字等，参见Help:Images。

• 一般来说Wiki系统使用的图片将被用于公有领域(Public Domain)，所以要注意不要上传有版权的图片。

编辑进阶

创建新页面

1. 如果发现正文中有棕红色的链接，则表明该条目中还没有内容，可以点击它来编辑新的条目，保存后就自动创建新页面。
2. 如果需要自行建立新页面，可以随便编辑某个页面并输入“[[新条目名称]]”，点击“显示预览”按钮后即可按前面所述进行操作。

孤立的文章难以被大家找到并发挥价值，因此请在各文章之间进行合理的链接引用。

更详细的介绍请见Help:Starting a new page。

一文多名处理

有时一篇文章可能具有多个不同标题，例如中央处理器与CPU。如果您希望将“中央处理器”的访问转到“CPU”页面，可以在“中央处理器”的正文中顶头输入：#REDIRECT [[CPU]]

这称为MediaWiki的“页面重定向”。

禁止文字转换

使用<nowiki>和</nowiki>扩起来的文字会被保持原有内容，不进行Wiki转义可以用来原样显示会被系统转换掉的文本，例如双中括号等。

对于需要原样引用的多行文字，则可以采用在每行之前增加空格的办法来实现，以一个空格引导的行将被按照原样显示。

少数时候此法不能完全禁止转换，此时应采用前面的标记方法。

目录控制

当文章中含有3个以上标题时，MediaWiki将自动在第一个标题之前生成目录(这是默认的设置)。

• 如果需要隐去目录，可以使用“__NOTOC__”标记；
• 如果需要强制显示目录而不管标题数量，可以使用“__TOC__”标记。

这两个标记不限制出现位置，但一般出现在文章头部或尾部且单独成行。

文章分类

在文本中嵌入“[[Category:Foo]]”的文字，会使本文自动归类到“Foo”下面。一般习惯在文章末尾放置该语句；同一篇文章可以设定多个分类。

编辑完成后，点击正文页面下端的分类名称，可以进入该分类页面查看更多的同类文章。同时，分类页面中也可以进行编辑，以进行必要的说明。

更详细的说明参见Help:Categories。

模板

中允许调用其他页面中的内容，这被成为“模板”，方法为在文章中输入{{模板名}}。

这种调用一般用于公共内容的处理，例如同一专题的侧栏、导航条、特定样式等。

详细内容请参见Help:Templates。

表格

规则表格的基础用法如下：(关于表格的详细讲解和复杂例子请参考Help:Tables)

{|border="1" cellspacing="0" 
|+ '''标题行，可以不使用本行'''
|-
| 第1行第1列 || 第1行第2列 || 第1行第3列
|-
| 第2行第1列 || 第2行第2列 || 第2行第3列
|-
| 第3行第1列 || 第3行第2列 || 第3行第3列
|}

上述例子里：

• border="1" cellspacing="0" 是边框样式，不写的话就不出边框
• 标题行可省略
• 其后每两行为一个表格行，单元格以双竖线分隔。单元格中可包含链接、图片甚至另外的表格。

名字空间

在MediaWiki中，以英文开始的文章标题中首字母自动大写；标题中的空格会被自动使用下划线代替。

在文章标题中用冒号分开的分类部分(Category)可以给文章进行名字空间的划分，例如Foo:Blah 和 Blah一般来说是不同的文章。名字空间可以多级的嵌套。

字符格式

À Á Â Ã Ä Å 
Æ Ç È É Ê Ë 
Ì Í Î Ï Ñ Ò 
Ó Ô Õ Ö Ø Ù 
Ú Û Ü ß à á 
â ã ä å æ ç 
è é ê ë ì í
î ï ñ ò ó ô 
œ õ ö ø ù ú 
û ü ÿ

¿ ¡ « » § ¶
† ‡ • —

™ © ® ¢ € ¥ 
£ ¤

下标: x<sub>2</sub>
上标: x<sup>2</sup> 或者 x&sup2;

&epsilon;<sub>0</sub> =
8.85 × 10<sup>−12</sup>
C² / J m.

α β γ δ ε ζ 
η θ ι κ λ μ ν 
ξ ο π ρ  σ ς
τ υ φ χ ψ ω
Γ Δ Θ Λ Ξ Π 
Σ Φ Ψ Ω

∫ ∑ ∏ √ − ± ∞
≈ ∝ ≡ ≠ ≤ ≥ →
× · ÷ ∂ ′ ″
∇ ‰ ° ∴ ℵ ø
∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇
¬ ∧ ∨ ∃ ∀ ⇒ ⇔
→ ↔

<i>x</i><sup>2</sup>&nbsp;&nbsp;&ge;&nbsp;&nbsp;0 true.

∞ -x²
∫ e   dx = √π
-∞ 

 
∞ -x²
∫ e   dx = √π
-∞ 

变量

以下是已定义的变量：

更多的变量含义可以参考Help:Variables。