December 25, 2024, Wednesday, 359

Manual:Handbook

From NeoWiki

(Redirected from Handbook)
Jump to: navigation, search

编辑上手

基础编辑略过,下面是关于链接、图像、格式的说明。


链接

产生内部链接

如需引用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://7thgen.info/images/intro_icon_blog.jpg”,效果如下:intro_icon_blog.jpg
  • 可以使用Special:Upload页面上传图片后作为站内图片使用,方法和上面描述的外部资源不一样。
图片文件不能使用中文名称,应在上载时指定为英文名称。
上载完成后,图片即可被引用。引用方式为在文章编辑时加入“[[Image:Filename.xxx]]”,注意这里文件名是大小写敏感的,不要写错了。

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

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

编辑进阶

创建新页面

  1. 如果发现正文中有棕红色的链接,则表明该条目中还没有内容,可以点击它来编辑新的条目,保存后就自动创建新页面。
  2. 如果需要自行建立新页面,可以随便编辑某个页面并输入“[[新条目名称]]”,点击“显示预览”按钮后即可按前面所述进行操作。
Tools clipart.png 孤立的文章难以被大家找到并发挥价值,因此请在各文章之间进行合理的链接引用。

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

一文多名处理

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

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

禁止文字转换

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

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

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

目录控制

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

  • 如果需要隐去目录,可以使用“__NOTOC__”标记;
  • 如果需要强制显示目录而不管标题数量,可以使用“__TOC__”标记。
Tools clipart.png 这两个标记不限制出现位置,但一般出现在文章头部或尾部且单独成行。

文章分类

在文本中嵌入“[[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列
|}
标题行,可以不使用本行
第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一般来说是不同的文章。名字空间可以多级的嵌套。

字符格式

您所看到的 您所输入的

变音及重音符号:
À Á Â Ã Ä Å
Æ Ç È É Ê Ë
Ì Í Î Ï Ñ Ò
Ó Ô Õ Ö Ø Ù
Ú Û Ü ß à á
â ã ä å æ

ç
è é ê ë ì í
î ï ñ ò ó ô
õ ö ø ù ú û
ü ÿ



&Agrave; &Aacute; &Acirc; &Atilde; &Auml; &Aring; 
&AElig; &Ccedil; &Egrave; &Eacute; &Ecirc; &Euml; 
&Igrave; &Iacute; &Icirc; &Iuml; &Ntilde; &Ograve; 
&Oacute; &Ocirc; &Otilde; &Ouml; &Oslash; &Ugrave; 
&Uacute; &Ucirc; &Uuml; &szlig; &agrave; &aacute; 
&acirc; &atilde; &auml; &aring; &aelig; &ccedil; 
&egrave; &eacute; &ecirc; &euml; &igrave; &iacute;
&icirc; &iuml; &ntilde; &ograve; &oacute; &ocirc; 
&oelig; &otilde; &ouml; &oslash; &ugrave; &uacute; 
&ucirc; &uuml; &yuml;

标点符号:
¿ ¡ « » § ¶
† ‡ • —


&iquest; &iexcl; &laquo; &raquo; &sect; &para;
&dagger; &Dagger; &bull; &mdash;

商业符号:
™ © ® ¢ € ¥
£ ¤


&trade; &copy; &reg; &cent; &euro; &yen; 
&pound; &curren;
下标:x2

上标:x2 或者 x²

  • 上标的后一种方法可能在许多情况下无法使用,但情况许可下请使用之,因为这可以使文章看起来更加顺眼一点。

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

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

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

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


&alpha; &beta; &gamma; &delta; &epsilon; &zeta; 
&eta; &theta; &iota; &kappa; &lambda; &mu; &nu; 
&xi; &omicron; &pi; &rho;  &sigma; &sigmaf;
&tau; &upsilon; &phi; &chi; &psi; &omega;
&Gamma; &Delta; &Theta; &Lambda; &Xi; &Pi; 
&Sigma; &Phi; &Psi; &Omega;

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


&int; &sum; &prod; &radic; &minus; &plusmn; &infin;
&asymp; &prop; &equiv; &ne; &le; &ge; &rarr;
&times; &middot; &divide; &part; &prime; &Prime;
&nabla; &permil; &deg; &there4; &alefsym; &oslash;
&isin; &notin; &cap; &cup; &sub; &sup; &sube; &supe;
&not; &and; &or; &exist; &forall; &rArr; &hArr;
&rarr; &harr;
x2   ≥   0 true.
  • 要分开文字,使用非分隔空格 - &nbsp;.
  • &nbsp;也防止在文字中间换行。这在方程式中十分有用。
<i>x</i><sup>2</sup>&nbsp;&nbsp;&ge;&nbsp;&nbsp;0 true.
∞ -x²
∫ e   dx = √π
-∞ 
 
&infin; -x&sup2;
&int; e   dx = &radic;&pi;
-&infin; 

变量

以下是已定义的变量:

变量 解释 结果
{{CURRENTMONTH}} 当前月份 12
{{CURRENTMONTHNAME}} 当前月份 December
{{CURRENTDAY}} 当前日 25
{{CURRENTDAYNAME}} 今天星期几 Wednesday
{{CURRENTYEAR}} 当前年份 2024
{{CURRENTTIME}} 当前时间(UTC) 05:27
{{NUMBEROFARTICLES}} 目前的条目数 62
{{PAGENAME}} 当前页面标题 Manual:Handbook
{{NAMESPACE}} 当前页面的名字空间
{{localurl:Sandbox|action=edit}} 编辑页面的url /w/index.php?title=Sandbox&action=edit
{{SERVER}} 当前的服务器 http://7thgen.info

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