User:920831658/WiKi语言入门:修订间差异
无编辑摘要 |
|||
| 第1行: | 第1行: | ||
本Wiki采用[https://zh.wikipedia.org/wiki/MediaWiki MediaWiki]系统,可以使用'''HTML代码'''、'''Wiki标记'''实现各种功能。<br /> | 本Wiki采用[https://zh.wikipedia.org/wiki/MediaWiki MediaWiki]系统,可以使用'''HTML代码'''、'''Wiki标记'''实现各种功能。<br /> | ||
本系列页面用于介绍'''Wiki标记'''以及部分常用的'''HTML代码'''。<br /> | 本系列页面用于介绍'''Wiki标记'''以及部分常用的'''HTML代码'''。<br /> | ||
| 第5行: | 第4行: | ||
更高级的功能说明可以参阅[[帮助:解析函数|解析函数功能列表]]或在[[:分类:扩展帮助文档|扩展帮助文档分类]]中检索。<br /> | 更高级的功能说明可以参阅[[帮助:解析函数|解析函数功能列表]]或在[[:分类:扩展帮助文档|扩展帮助文档分类]]中检索。<br /> | ||
== 概述 == | == 概述 == | ||
您或许使用过记事本、Word等文本编辑器,也或许编辑过百度百科,但 | 您或许使用过记事本、Word等文本编辑器,也或许编辑过百度百科,但是mediawiki与它们有所不同,后者会从源代码,并在服务器进行处理,最终呈现为阅读页面的样子。<br /> | ||
*譬如,要'''加粗文字''',只要将文字放在三个单引号之间→<nowiki>'''像这样'''</nowiki>。 | *譬如,要'''加粗文字''',只要将文字放在三个单引号之间→<nowiki>'''像这样'''</nowiki>。 | ||
对于wiki的所有编辑,均需要在源代码页面完成。本系列帮助页面即是帮助您了解如何进行源代码的编写。 | 对于wiki的所有编辑,均需要在源代码页面完成。本系列帮助页面即是帮助您了解如何进行源代码的编写。 | ||
| 第14行: | 第13行: | ||
在编辑完成后,我们推荐您首先使用“显示预览”按钮查看您的编辑是否如您所期望的那样,以避免不必要的反复修改操作。<br />请尤其注意需要配对使用的标签是否已配对好。大部分情况下代码充满屏幕都是因为这类bug。 | 在编辑完成后,我们推荐您首先使用“显示预览”按钮查看您的编辑是否如您所期望的那样,以避免不必要的反复修改操作。<br />请尤其注意需要配对使用的标签是否已配对好。大部分情况下代码充满屏幕都是因为这类bug。 | ||
*不必死记硬背 | *不必死记硬背本页面的内容——在需要时您可以随时查阅。<br />如果您对编辑技术不太自信,我们推荐您使用[[Help:沙盒]]页面进行编辑练习。在这个页面您可以随意进行编辑。<br />如果您不知道在其它某个页面中编辑会获得怎样的效果,也可以在[[Help:沙盒]]页面进行编辑。<br />[[Help:沙盒]](在如此的再三重复之下,您应该牢记[[Help:沙盒]]这个页面了。) | ||
== 基础编辑功能 == | |||
{| align="center" class="wikitable" | |||
|- | |||
|'''描述''' | |||
|'''使用方法''' | |||
|'''效果''' | |||
|- | |||
|创建新页面 | |||
|colspan=2|直接在搜索框输入要创建的新页面的名字,或者直接在“calcwiki.org/”后面输入,就会提示是否创建新页面了。<br />目前只有以上的方法创建。 | |||
|- | |||
|模板 | |||
|<poem><nowiki>{{}}表示一个模板。一个模板是一串代码的整合,使用模板可以节省很多编写代码的时间。 | |||
如果您不会使用某个模板,推荐您找一个编写完毕的模板并进行内容替换。 | |||
"{{"右边、"|"左边的一段文字是模板的名称。 | |||
进入模板:(模板名称)页面(如:[[模板:Navbox]]) 可以看到该模板的详细信息。 | |||
常用模板请参见[[帮助:常用模板]]。</nowiki></poem> | |||
|<poem>{{}}表示一个模板。一个模板是一串代码的整合,使用模板可以节省很多编写代码的时间。 | |||
如果您不会使用某个模板,推荐您找一个编写完毕的模板并进行内容替换。 | |||
"{{"右边、"|"左边的一段文字是模板的名称。 | |||
进入模板:(模板名称)页面(如:[[模板:Navbox]])可以看到该模板的详细信息。 | |||
常用模板请参见[[帮助:常用模板]]。</poem> | |||
|- | |||
|标题 | |||
|<poem><nowiki>== 2级标题 == | |||
=== 3级标题 === | |||
==== 4级标题 ==== | |||
请不要跳跃标题等级,例如2级标题之下直接就是4级标题,而没有3级标题。 | |||
1级标题是当前页面的标题(如本页为 帮助:常用代码),请不要使用1级标题。 | |||
标题最多为6级。 | |||
当页面超过四个标题时会自动创建目录。</poem> | |||
| | |||
== 2级标题 == | |||
=== 3级标题 === | |||
==== 4级标题 ==== | |||
<poem>请不要跳跃标题等级,例如2级标题之下直接就是4级标题,而没有3级标题。 | |||
1级标题是当前页面的标题(如本页为 帮助:常用代码),请不要使用1级标题。 | |||
标题最多为6级。 | |||
当页面超过四个标题时会自动创建目录。</poem> | |||
|- | |||
|链接 | |||
|<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>这是表格的开始 | |||
{| 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标记(<table>、<tr>、<td>、<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标记(<table>、<tr>、<td>、<th>)亦可使用,但在这些HTML标记中不能使用wiki标记。 | |||
|- | |||
|添加分类 | |||
|<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> | |||
|} | |||
== 字体与段落 == | == 字体与段落 == | ||
{| align="center" class="wikitable" | {| align="center" class="wikitable" | ||
| 第94行: | 第200行: | ||
*****但是请注意这样跨级会出现多个图标。 | *****但是请注意这样跨级会出现多个图标。 | ||
没有星号代表列表结束。 | 没有星号代表列表结束。 | ||
*星号一定要是第一个字符*这 | *星号一定要是第一个字符*这个星号不会转换为列表。 | ||
</nowiki></poem> | </nowiki></poem> | ||
| | | | ||
| 第103行: | 第209行: | ||
*****但是请注意这样跨级会出现多个图标。 | *****但是请注意这样跨级会出现多个图标。 | ||
没有星号代表列表结束。 | 没有星号代表列表结束。 | ||
*星号一定要是一行第一个字符*这 | *星号一定要是一行第一个字符*这个星号不会转换为列表。 | ||
|- | |- | ||
|缩进 | |缩进 | ||
|<poem><nowiki>;这样会使本行加粗 | |<poem><nowiki>;这样会使本行加粗 | ||
:这样 | :这样会使本行缩进(半角冒号)</nowiki></poem> | ||
| | | | ||
;这样会使本行加粗<br /> | ;这样会使本行加粗<br /> | ||
:这样 | :这样会使本行缩进(半角冒号) | ||
|- | |- | ||
|引用框 | |引用框 | ||
|<poem><nowiki> 如果一行开头是空格那 | |<poem><nowiki> 如果一行开头是空格,那么该行文本会在引用框内显示。 | ||
会自带<poem>的效果<br />也可以用这个连续。 | 它会自带<poem>的效果<br />也可以用这个连续。 | ||
<pre>使用它是相同的效果,只是里面不能使用'''wiki标记'''。</pre></nowiki></poem> | <pre>使用它是相同的效果,只是里面不能使用'''wiki标记'''。</pre></nowiki></poem> | ||
| | | | ||
如果一行开头是空格那 | 如果一行开头是空格,那么该行文本会在引用框内显示。 | ||
会自带<poem>的效果<br />也可以用这个连续。 | 会自带<poem>的效果<br />也可以用这个连续。 | ||
<pre>使用它是相同的效果,只是里面不能使用'''wiki标记'''。</pre> | <pre>使用它是相同的效果,只是里面不能使用'''wiki标记'''。</pre> | ||
| 第132行: | 第238行: | ||
|<nowiki>~~~ 这样显示编辑者的名字。 | |<nowiki>~~~ 这样显示编辑者的名字。 | ||
~~~~ 这样显示编辑者的名字和编辑时间。</nowiki> | ~~~~ 这样显示编辑者的名字和编辑时间。</nowiki> | ||
{{color|red|警告:这个功能仅用于在讨论页中标明是谁的评论。不要把您的尊姓大名签 | {{color|red|警告:这个功能仅用于在讨论页中标明是谁的评论。不要把您的尊姓大名签在词条中!}} | ||
|[[用户:DemoUser|DemoUser]]([[用户讨论:DemoUser|讨论]]) 这样显示编辑者的名字。 | |[[用户:DemoUser|DemoUser]]([[用户讨论:DemoUser|讨论]]) 这样显示编辑者的名字。 | ||
[[用户:DemoUser|DemoUser]]([[用户讨论:DemoUser|讨论]]) 2016年1月9日 (六) 11:03 (CST) 这样显示编辑者的名字和编辑时间。 | [[用户:DemoUser|DemoUser]]([[用户讨论:DemoUser|讨论]]) 2016年1月9日 (六) 11:03 (CST) 这样显示编辑者的名字和编辑时间。 | ||
{{color|red|警告:这个功能仅用于在讨论页中标明是谁的评论。不要把您的尊姓大名签在词条中!}} | {{color|red|警告:这个功能仅用于在讨论页中标明是谁的评论。不要把您的尊姓大名签在词条中!}} | ||
|} | |} | ||
== 插入图片 == | == 插入图片 == | ||
| 第199行: | 第306行: | ||
如果希望多个图片按一定方式排列,最常见的办法是使用表格。</nowiki></poem> | 如果希望多个图片按一定方式排列,最常见的办法是使用表格。</nowiki></poem> | ||
|} | |} | ||
2016年4月20日 (三) 15:43的版本
本Wiki采用MediaWiki系统,可以使用HTML代码、Wiki标记实现各种功能。
本系列页面用于介绍Wiki标记以及部分常用的HTML代码。
如果您拥有相关html或wiki编辑经验,您可以跳过本系列帮助,并参照常用模板列表进行编辑。
更高级的功能说明可以参阅解析函数功能列表或在扩展帮助文档分类中检索。
概述
您或许使用过记事本、Word等文本编辑器,也或许编辑过百度百科,但是mediawiki与它们有所不同,后者会从源代码,并在服务器进行处理,最终呈现为阅读页面的样子。
- 譬如,要加粗文字,只要将文字放在三个单引号之间→'''像这样'''。
对于wiki的所有编辑,均需要在源代码页面完成。本系列帮助页面即是帮助您了解如何进行源代码的编写。
- 当您操作不够熟练时,您还可以使用编辑框顶部的小工具进行编辑(不过并不推荐使用,不但编辑速度较慢而且无法移动到其它文本编辑器进行编辑)。
由于源代码内容为文本,您可以在喜欢的文本编辑器进行编辑,然后复制到对应页面的编辑区。
我们强烈推荐您在提交代码前先复制到本地并保存,以避免不必要的编辑内容丢失。
在编辑完成后,我们推荐您首先使用“显示预览”按钮查看您的编辑是否如您所期望的那样,以避免不必要的反复修改操作。
请尤其注意需要配对使用的标签是否已配对好。大部分情况下代码充满屏幕都是因为这类bug。
- 不必死记硬背本页面的内容——在需要时您可以随时查阅。
如果您对编辑技术不太自信,我们推荐您使用Help:沙盒页面进行编辑练习。在这个页面您可以随意进行编辑。
如果您不知道在其它某个页面中编辑会获得怎样的效果,也可以在Help:沙盒页面进行编辑。
Help:沙盒(在如此的再三重复之下,您应该牢记Help:沙盒这个页面了。)
基础编辑功能
| 描述 | 使用方法 | 效果 | ||||||||
| 创建新页面 | 直接在搜索框输入要创建的新页面的名字,或者直接在“calcwiki.org/”后面输入,就会提示是否创建新页面了。 目前只有以上的方法创建。 | |||||||||
| 模板 | {{}}表示一个模板。一个模板是一串代码的整合,使用模板可以节省很多编写代码的时间。 |
|||||||||
| 标题 | <nowiki>== 2级标题 == |
2级标题3级标题4级标题请不要跳跃标题等级,例如2级标题之下直接就是4级标题,而没有3级标题。 | ||||||||
| 链接 | [[TI-Nspire]] 双方括号可以链接calcwiki内页面 |
|||||||||
| 插入表格 | 这是表格的开始 |
这是表格的开始
| ||||||||
| 添加分类 | [[分类:帮助文档]] 这样就会给页面添加一个分类。 |
[[分类:帮助文档]] 这样就会给页面添加一个分类。 | ||||||||
| 注释 | 用<ref>注释文本</ref>进行注释。 |
|||||||||
字体与段落
| 描述 | 使用方法 | 效果 |
| 保持文字排版格式 | 在HTML代码中,大段的半角空格会被忽略为一个,
换行会被当做一个普通的空格(不过在表格里,和回车两次的效果是一样的)
回车两次(↑中间有一个空行)会产生一个新的段落,并不是换行,因而并不推荐使用。<br />标签会使文本进入新的一行。 <nowiki>标签会将其中的全部wiki标记(比如'''这个''')以及全部HTML标记(如<br />)保留原样。 |
在HTML代码中,大段的半角空格会被忽略为一个, 换行会被当做一个普通的空格(不过在表格里,和回车两次的效果是一样的)。
回车两次(↑中间有一个空行)会产生一个新的段落,并不是换行,因而并不推荐使用。 <nowiki>标签会将其中的全部wiki标记(比如'''这个''')以及全部HTML标记(如<br />)保留原样。 |
| 编辑注释 | <!-- 写在这里面的字不会被显示。 --> | |
| 粗体字 | '''粗体''' | 粗体 |
| 斜体字 | ''斜体'' | 斜体 |
| 粗斜体文字 | '''''粗斜体''''' | 粗斜体 |
| HTML标签 | 某些 HTML 标签是MediaWiki可以使用的,例如<code>、<font>、<div>、 <span>(使用style=""添加css)以及全套表格相关代码。(更多内容参见:wikipedia HTML帮助 如果您你对HTML熟悉,可以尝试使用。不过如果有效果相同的模板,我们推荐您使用对应的模板。 以下是若干示例: | |
| <center>可以使内容居中。<br />内容可以是文本或表格,其中也可以加上其它标签。</center>
{{color|颜色名|文字|}}可以设置字体颜色。例如:{{color|red|红色文字}} <s>删除线</s>,<u>下划线</u>,<code>源代码</code>,<blockquote>引用文本(会与上下都空出一部分,并在行首有一个缩进)</blockquote> 用<big>和<small>可以调整字体大小。例如: <big>big</big> <big><big>bigger</big></big> and<small>small</small> 如果您认为字不够大或者不够小,可以连续套用<big>和<small>。比如: <big><big><big><big>THAT IS SO BIIIIG!</big></big></big></big> 然而,我们有必要提示您,不要在词条里面使用过大或过小的文字,这会严重影响阅读体验。 数学公式里,经常需要<sup>上标</sup>和<sub>下标</sub>。 |
内容可以是文本或表格,其中也可以加上其它标签。 {{color|颜色名|文字|}}可以设置字体颜色。例如:红色文字 源代码,
用<big>和<small>可以调整字体大小。例如: | |
| 列表 | *普通列表——该行前会出现一个蓝色圆点。 |
没有星号代表列表结束。
|
| 缩进 | ;这样会使本行加粗 |
|
| 引用框 | 如果一行开头是空格,那么该行文本会在引用框内显示。 |
如果一行开头是空格,那么该行文本会在引用框内显示。 会自带<poem>的效果 使用它是相同的效果,只是里面不能使用'''wiki标记'''。 |
| 水平线 | 单独的一行、四个短横线。 |
单独的一行、四个短横线。
虽然与标题效果类似,但请不要用这个“模拟”标题。请使用==标题== |
| 签名 | ~~~ 这样显示编辑者的名字。
~~~~ 这样显示编辑者的名字和编辑时间。
警告:这个功能仅用于在讨论页中标明是谁的评论。不要把您的尊姓大名签在词条中! |
DemoUser(讨论) 这样显示编辑者的名字。
DemoUser(讨论) 2016年1月9日 (六) 11:03 (CST) 这样显示编辑者的名字和编辑时间。 警告:这个功能仅用于在讨论页中标明是谁的评论。不要把您的尊姓大名签在词条中! |
插入图片
| '描述 | 使用方法 | 效果 |
上传图片
|
点击侧边栏的【上传文件】可以上传。 在“摘要”中写入的内容会成为页面的一部分。应当填写图片的大概内容或是用处。 | |
| 插入图片(此处用Ndless Logo这张图片做示范) | 插入图片就是插入图片文件的地址。
|
插入图片就是插入图片文件的地址。 注意:为了规范词条风格,缩略图都应该插在右侧(上述代码默认是插在右侧的),而不是左侧,更不能左一个右一个,这会严重影响阅读体验。 错误显示在图片旁边的下一段标题
正确显示的下一段标题这里的文字会显示在图片和前面所有东西下方,文字以外,== 标题 ==类型的标题也应该这样写。 |

