查看“︁User:920831658/WiKi语言入门”︁的源代码


本Wiki采用[https://zh.wikipedia.org/wiki/MediaWiki MediaWiki]系统，可以使用'''HTML代码'''、'''Wiki标记'''实现各种功能。<br />
本系列页面用于介绍'''Wiki标记'''以及部分常用的'''HTML代码'''。<br />
如果您拥有相关html或wiki编辑经验，您可以跳过本系列帮助，并参照[[帮助:常用模板|常用模板列表]]进行编辑。<br />
更高级的功能说明可以参阅[[帮助:解析函数|解析函数功能列表]]或在[[:分类:扩展帮助文档|扩展帮助文档分类]]中检索。<br />
== 概述 ==
您或许使用过记事本、Word等文本编辑器，也或许编辑过百度百科，但是mediawiki与它们有所不同，后者会从源代码，并在服务器进行处理，最终呈现为阅读页面的样子。<br />
*譬如，要'''加粗文字'''，只要将文字放在三个单引号之间→<nowiki>'''像这样'''</nowiki>。
对于wiki的所有编辑，均需要在源代码页面完成。本系列帮助页面即是帮助您了解如何进行源代码的编写。
*当您操作不够熟练时，您还可以使用编辑框顶部的小工具进行编辑（不过并不推荐使用，不但编辑速度较慢而且无法移动到其它文本编辑器进行编辑）。

由于源代码内容为文本，您可以在喜欢的文本编辑器进行编辑，然后复制到对应页面的编辑区。<br /><big>我们强烈推荐您在提交代码前先复制到本地并保存，以避免不必要的编辑内容丢失。</big>

在编辑完成后，我们推荐您首先使用“显示预览”按钮查看您的编辑是否如您所期望的那样，以避免不必要的反复修改操作。<br />请尤其注意需要配对使用的标签是否已配对好。大部分情况下代码充满屏幕都是因为这类bug。

*请不必死记本页面内容，需要的时候就来查吧~<br />如果您对编辑技术不太自信，我们推荐您使用[[Help:沙盒]]页面进行编辑练习。在这个页面您可以随意进行编辑。<br />如果您不知道在其它某个页面中编辑会获得怎样的效果，也可以在[[Help:沙盒]]页面进行编辑。<br />[[Help:沙盒]](在如此的再三重复之下，您应该牢记[[Help:沙盒]]这个页面了。)
== 字体与段落 ==
{| align="center" class="wikitable"
|-
|'''描述'''
|'''使用方法'''	
|'''效果'''
|-
|保持文字排版格式
|<nowiki>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;在HTML代码中，大段的半角空格会被忽略为一个，
换行会被当做一个普通的空格(不过在表格里，和回车两次的效果是一样的)</nowiki>

<nowiki>回车两次（↑中间有一个空行）会产生一个新的段落，并不是换行，因而并不推荐使用。<br />标签会使文本进入新的一行。</nowiki>

<nowiki><nowiki>标签会将其中的全部wiki标记（比如'''这个'''）以及全部HTML标记（如<br />）保留原样。</nowiki>
<!--——————
 <br />是HTML标记，<poem>是wiki标记，结束的位置用&#60;/poem>表示。-->
|&nbsp;        在HTML代码中，大段的半角空格会被忽略为一个， 换行会被当做一个普通的空格(不过在表格里，和回车两次的效果是一样的)。
回车两次（↑中间有一个空行）会产生一个新的段落，并不是换行，因而并不推荐使用。<br />标签会使文本进入新的一行。

<nowiki>&#60;nowiki>标签会将其中的全部wiki标记（比如'''这个'''）以及全部HTML标记（如<br />）保留原样。</nowiki>
<!--——————
 <br />是HTML标记，<poem>是wiki标记，结束的位置用&#60;/poem>表示。-->
|-
|编辑注释
|<nowiki><!-- 写在这里面的字不会被显示。 --></nowiki>
|<!-- 写在这里面的字不会被显示。 -->
|-
|粗体字
|<nowiki>'''粗体'''</nowiki>
|'''粗体'''
|-
|斜体字
|<nowiki>''斜体''</nowiki>
|''斜体''
|-
|粗斜体文字
|<nowiki>'''''粗斜体'''''</nowiki>
|'''''粗斜体'''''
|-
|rowspan="2"|HTML标签
|colspan="2"|某些 HTML 标签是MediaWiki可以使用的，例如<nowiki><code>、<font>、<div>、 <span>（使用style=""添加css)以及全套表格相关代码</nowiki>。(更多内容参见:[https://zh.wikipedia.org/wiki/Help:HTML wikipedia HTML帮助]<br />如果您你对HTML熟悉，可以尝试使用。不过如果有效果相同的模板，我们推荐您使用对应的模板。<br />以下是若干示例：
|-
|<nowiki><center>可以使内容居中。<br />内容可以是文本或表格，其中也可以加上其它标签。</center></nowiki>

<nowiki>{{color|颜色名|文字|}}可以设置字体颜色。例如：{{color|red|红色文字}}</nowiki>

<nowiki><s>删除线</s>，<u>下划线</u>，<code>源代码</code>，<blockquote>引用文本（会与上下都空出一部分，并在行首有一个缩进）</blockquote></nowiki>

<nowiki>用<big>和<small>可以调整字体大小。例如：</nowiki>

<nowiki><big>big</big> <big><big>bigger</big></big> and<small>small</small></nowiki>

<nowiki>如果您认为字不够大或者不够小，可以连续套用<big>和<small>。比如：</nowiki>

<nowiki><big><big><big><big>THAT IS SO BIIIIG!</big></big></big></big></nowiki>

'''然而，我们有必要提示您，不要在词条里面使用过大或过小的文字，这会严重影响阅读体验。'''

<nowiki>数学公式里，经常需要<sup>上标</sup>和<sub>下标</sub>。</nowiki>

|<poem><center>可以使内容居中。<br />内容可以是文本或表格，其中也可以加上其它标签。</center>
<nowiki>{{color|颜色名|文字|}}可以设置字体颜色。</nowiki>例如：{{color|red|红色文字}}
<s>删除线</s>，<u>下划线</u>，<code>源代码</code>，<blockquote>引用文本（会与上下都空出一部分，并在行首有一个缩进）</blockquote>
<nowiki>用<big>和<small>可以调整字体大小。例如：
</nowiki><big>big</big> <big><big>bigger</big></big> and<small>small</small>
<nowiki>如果您认为字不够大或者不够小，可以连续套用<big>和<small>。比如：</nowiki>
<big><big><big><big>THAT IS SO BIIIIG!</big></big></big></big>
'''然而，我们有必要提示您，不要在词条里面使用过大或过小的文字，这会严重影响阅读体验。'''
数学公式里，经常需要<sup>上标</sup>和<sub>下标</sub>。
</poem>
|-
|列表
|<poem><nowiki>*普通列表——该行前会出现一个蓝色圆点。
**也可以这样递进
**#或者在其中加上些数字顺序（#与*的用法相同）
*或者这样跳到上一级
*****但是请注意这样跨级会出现多个图标。
没有星号代表列表结束。
*星号一定要是第一个字符*这就不行了。
</nowiki></poem>
|
*普通列表——该行前会出现一个蓝色圆点。
**也可以这样递进
**#或者在其中加上些数字顺序（#与*的用法相同）
*或者这样跳到上一级
*****但是请注意这样跨级会出现多个图标。
没有星号代表列表结束。
*星号一定要是一行第一个字符*这就不行了。
|-
|缩进
|<poem><nowiki>;这样会使本行加粗
&#58;这样就缩进了（半角冒号）</nowiki></poem>
|
;这样会使本行加粗<br />
:这样就缩进了（半角冒号）
|-
|引用框
|<poem><nowiki> 如果一行开头是空格那就会被框进框里。
 会自带&#60;poem>的效果<br />也可以用这个连续。
<pre>使用它是相同的效果，只是里面不能使用'''wiki标记'''。</pre></nowiki></poem>
|
 如果一行开头是空格那就会被框进框里。
 会自带&#60;poem>的效果<br />也可以用这个连续。
<pre>使用它是相同的效果，只是里面不能使用'''wiki标记'''。</pre>
|-
|水平线
|<poem><nowiki>单独的一行、四个短横线。
----
虽然与标题效果类似，但请不要用这个“模拟”标题。请使用&#61;&#61;标题&#61;&#61;</nowiki></poem>
|单独的一行、四个短横线。
----
虽然与标题效果类似，但请不要用这个“模拟”标题。请使用&#61;&#61;标题&#61;&#61;
|-
|签名
|<nowiki>~~~ 这样显示编辑者的名字。
~~~~ 这样显示编辑者的名字和编辑时间。</nowiki>
{{color|red|警告：这个功能仅用于在讨论页中标明是谁的评论。不要把您的尊姓大名签写在词条中！}}
|[[用户:DemoUser|DemoUser]]（[[用户讨论:DemoUser|讨论]]） 这样显示编辑者的名字。
[[用户:DemoUser|DemoUser]]（[[用户讨论:DemoUser|讨论]]） 2016年1月9日 (六) 11:03 (CST) 这样显示编辑者的名字和编辑时间。
{{color|red|警告：这个功能仅用于在讨论页中标明是谁的评论。不要把您的尊姓大名签在词条中！}}
|}

== 插入图片 ==
{| align="center" class="wikitable"
|-
|'''描述''
|'''使用方法'''	
|'''效果'''
|-
|<div id="上传图片">上传图片</div>
|colspan=2| 点击侧边栏的[[特殊:上传文件|【上传文件】]]可以上传。<br />在“摘要”中写入的内容会成为页面的一部分。应当填写图片的大概内容或是用处。
|-
|插入图片(此处用Ndless Logo这张图片做示范)
|<poem><nowiki>插入图片就是插入图片文件的地址。
不希望展示的话，是[[Media:Ndless Logo.png ]]
希望直接显示完整图片的话，是[[File:Ndless Logo.png]]
希望从某段文字起不环绕图片而是在图片下方出现的话，使用{{-}}
在图片上面写的文字会默认在图片上方。
如果您希望在词条中插入一个缩略图，并在点击缩略图时能看到它的大图，可以输入这样的代码：
[[File:Ndless Logo.png|200px|thumb|right|Ndless Logo]]
注意：为了规范词条风格，缩略图都应该插在右侧（上述代码默认是插在右侧的），而不是左侧，更不能左一个右一个，这会严重影响阅读体验。
大多数情况下图片都是浮动的。这时就容易出现这个问题：
=== 错误显示在图片旁边的下一段标题 ===
{{-}}
=== 正确显示的下一段标题 ===
这里的文字会显示在图片和前面所有东西下方，文字以外，== 标题 ==类型的标题也应该这样写。
文件插入命令的具体参数说明：
[[文件:文件名.后缀名|可以添加的参数1|2|3|4...|图片标题]]
没有参数的情况下，默认为在原处放置、文字不会环绕图片。
none、center会使其独占一行，center还会使图片居中。
left、right会使文字环绕图片，同时使图片居左/右。
frame、thumb会使图片有外框并显示标题，thumb还会使图片变为缩略图。
link= 会为图片添加超链接。
[[File:Wiki.png|100px]]会使图片宽度为100px，
[[File:Wiki.png|x100px]]会使图片高度为100px。会根据原图宽高比成比例缩小。
[[File:Wiki.png|100x100px]]会使图片最长的一边等比缩放到100px。
如果希望多个图片按一定方式排列，最常见的办法是使用表格。</nowiki>
* 更加详细的图片插入示例以及<gallary>的用法，请参见[https://www.mediawiki.org/wiki/Help:Images/zh mediawiki 图片帮助]<nowiki>--></nowiki></poem>
|<poem>插入图片就是插入图片文件的地址。
不希望展示的话，是<nowiki>[[Media:Ndless Logo.png ]]</nowiki>[[Media:Ndless Logo.png ]]
希望直接显示完整图片的话，是<nowiki>[[File:Ndless Logo.png]]</nowiki>[[File:Ndless Logo.png]]
希望从某段文字起不环绕图片而是在图片下方出现的话，使用<nowiki>{{-}}</nowiki>{{-}}
在图片上面写的文字会默认在图片上方。
如果您希望在词条中插入一个缩略图，并在点击缩略图时能看到它的大图，可以输入这样的代码：<nowiki>[[File:Ndless Logo.png|200px|thumb|right|Ndless Logo]]</nowiki>
[[File:Ndless Logo.png|200px|thumb|right|Ndless Logo]]
注意：为了规范词条风格，缩略图都应该插在右侧（上述代码默认是插在右侧的），而不是左侧，更不能左一个右一个，这会严重影响阅读体验。
大多数情况下图片都是浮动的。这时就容易出现这个问题：
<h3> 错误显示在图片旁边的下一段标题 </h3>
{{-}}
<h3> 正确显示的下一段标题 </h3>
这里的文字会显示在图片和前面所有东西下方，文字以外，== 标题 ==类型的标题也应该这样写。
<nowiki>文件插入命令的具体参数说明：
[[文件:文件名.后缀名|可以添加的参数1|2|3|4...|图片标题]]
没有参数的情况下，默认为在原处放置、文字不会环绕图片。
none、center会使其独占一行，center还会使图片居中。
left、right会使文字环绕图片，同时使图片居左/右。
frame、thumb会使图片有外框并显示标题，thumb还会使图片变为缩略图。
link= 会为图片添加超链接。
[[File:Wiki.png|100px]]会使图片宽度为100px，
[[File:Wiki.png|x100px]]会使图片高度为100px。会根据原图宽高比成比例缩小。
[[File:Wiki.png|100x100px]]会使图片最长的一边等比缩放到100px。
如果希望多个图片按一定方式排列，最常见的办法是使用表格。</nowiki></poem>
|}

== 更多常用功能 ==
{| align="center" class="wikitable"
|-
|'''描述'''
|'''使用方法'''
|'''效果'''
|-
|模板
|<poem><nowiki>{{}}表示一个模板。
如果您不会使用某个模板，推荐您找一个编写完毕的模板并进行内容替换。 
"{{"右边、"|"左边的一段文字是模板的名称。
进入模板:(模板名称)页面（如:[[模板:Navbox]]） 可以看到该模板的详细信息。
常用模板请参见[[帮助:常用模板]]。</nowiki></poem>
|<poem>{{}}表示一个模板。
如果您不会使用某个模板，推荐您找一个编写完毕的模板并进行内容替换。
 "{{"右边、"|"左边的一段文字是模板的名称。
进入模板:(模板名称)页面（如:[[模板:Navbox]]）可以看到该模板的详细信息。
常用模板请参见[[帮助:常用模板]]。</poem>
|-
|插入表格
|<poem><nowiki>这是表格的开始
{| class="wikitable"
|+ 这样添加表格标题
|一道竖线是一个单元格 || 同一行如果要继续书写，之后的都要两个竖线
|另一行开头的话就只需要一个
|-----
|这样换行(-有几个都可以) ||align="center" colspan=2|这样添加css信息
|- align="center"
| style="background:black; color:white"|行首添加css方法相同 
! 用叹号代替竖线会获得标题效果的表格
|}这样结束表格。
* 表格中可以嵌套表格，但可能会造成一些bug。
* 常用的css参数还有width=50%(宽度为整个页面50%) 、height=200px(高度限定为200像素)等。
* 可以用 class="sortable"进行排序，参考</nowiki>[https://zh.wikipedia.org/wiki/Help:可排序表格 wikipedia 可排序表格]<nowiki>
* HTML标记(&#60;table>、&#60;tr>、&#60;td>、&#60;th>)亦可使用，但在这些HTML标记中不能使用wiki标记。</nowiki></poem>
|
这是表格的开始 
{| class="wikitable"
|+ 这样添加表格标题
|一道竖线是一个单元格 || 同一行如果要继续书写，之后的都要两个竖线
|另一行开头的话就只需要一个
|-----
|这样换行(-有几个都可以) ||align="center" colspan=2|这样添加css信息
|- align="center"
| style="background:black; color:white"|行首添加css方法相同 
! 用叹号代替竖线会获得标题效果的表格
|}这样结束表格。
* 表格中可以嵌套表格，但可能会造成一些bug。
* 常用的css参数还有width=50%(宽度为整个页面50%) 、height=200px(高度限定为200像素)等。
* 可以用 class="sortable"进行排序，参考[https://zh.wikipedia.org/wiki/Help:可排序表格 wikipedia 可排序表格]
* HTML标记(&#60;table>、&#60;tr>、&#60;td>、&#60;th>)亦可使用，但在这些HTML标记中不能使用wiki标记。
|-
|创建新页面
|colspan=2|直接在搜索框输入要创建的新页面的名字，或者直接在“calcwiki.org/”后面输入，就会提示是否创建新页面了。<br />目前只有以上的方法创建。
|-
|链接
|<poem><nowiki>[[TI-Nspire]] 双方括号可以链接</nowiki>calcwiki<nowiki>内页面
[[计算器|电卓]] 也可以加上“|”更改显示文字
[http://education.ti.com 德州仪器教育] 单方括号以处理完整的url。这样更改显示文字。
如果没有加上显示文字，会变成[1]
http://casio.com 单独出现的地址也会被解析为网址。
#重定向[[目标页面]]会使进入该页面后自动跳转到目标页面。
请首先建立目标页面，再设置重定向。</nowiki>
</poem>
|<poem>[[TI-Nspire]] 双方括号可以链接<nowiki>calcwiki</nowiki>内页面
[[计算器|电卓]] 也可以加上“|”更改显示文字
[http://education.ti.com 德州仪器教育] 单方括号以处理完整的url。这样更改显示文字。
如果没有加上显示文字，会变成[http://education.ti.com]
http://casio.com 单独出现的地址也会被解析为网址。
#重定向[[目标页面]]会使进入该页面后自动跳转到目标页面。
请首先建立目标页面，再设置重定向。</poem>

|-
|添加分类
|<poem><nowiki>[[分类:帮助文档]] 这样就会给页面添加一个分类。
在页面的最下方，注明了本页面所属的分类。
点进去，就可以看到同名分类下的所有页面和文件。</nowiki></poem>
|<poem><nowiki>[[分类:帮助文档]]</nowiki> 这样就会给页面添加一个分类。
在页面的最下方，注明了本页面所属的分类。
点进去，就可以看到同名分类下的所有页面和文件。</poem>
|-
|注释
|<poem><nowiki>用<ref>注释文本</ref>进行注释。
如果相同内容的注释多<ref name="说明">在最前面的Ref里写下name="",
之后的ref都直接加上name=""/</ref>，可以这样<ref name="说明" />
注释内容还会在<references />处出现。如果页面没有，会默认加在页尾。
</nowiki></poem>
|<poem><ref>注释文本</ref>
<ref name="说明">/</ref>
<ref name="说明" />
<references /></poem>
|-
|标题
|<poem><nowiki>== 2级标题 ==
=== 3级标题 ===
==== 4级标题 ====
请不要跳跃标题等级，例如2级标题之下直接就是4级标题，而没有3级标题。
1级标题是当前页面的标题（如本页为 帮助:常用代码），请不要使用1级标题。
标题最多为6级。
当页面超过四个标题时会自动创建目录。</poem>
|
== 2级标题 ==
=== 3级标题 ===
==== 4级标题 ====
<poem>请不要跳跃标题等级，例如2级标题之下直接就是4级标题，而没有3级标题。
1级标题是当前页面的标题（如本页为 帮助:常用代码），请不要使用1级标题。
标题最多为6级。
当页面超过四个标题时会自动创建目录。</poem>