Wiki系统支持特殊标记的语法,以尽可能使文档的可读性更高。本页提供在编辑页面时可能用到的语法说明。
Wiki系统支持简单的粗体,斜体,下划线以及等宽体
和混合使用
的文字格式,以及上标和下标。用法如下:
**粗体** | //斜体// | __下划线__ | ''等宽体'' | **__//''混合使用''//__** <sup>上标</sup> | <sub>下标</sub>
换行是由空行所建立的。如果想强制换行
而不建立段落,可以使用两个反斜杠\\
加空格或回车。
通过缩进两个空格或者使用标签<code>
或<file>
将扩入内容显示为代码块
高亮源代码可以使代码更容易阅读。使用方法为<code javascript>
或者<file php>
,标签中加入<code linenums:1 | 示例>
这样的格式将显示为如下代码框:
示例
下面是一段代码 <?php echo 'xx'; ?> 如果是文本,文本将原样显示。
系统所支持的语言如下:
4cs, abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autohotkey, autoit, avisynth, awk, bash
, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c
, c_mac, caddcl, cadlisp, cfdg, cfm
, cil, clojure, cmake, cobol, cpp
, cpp-qt, csharp, css
, cuesheet, d, dcs, delphi
, diff, div, dos
, dot, eiffel, email, erlang, fo, fortran, freebasic, fsharp, gambas, genero, gdb, glsl, gml, gnuplot, groovy, gettext, haskell, hq9plus, html
, idl, ini
, inno, intercal, io, java5, java
, javascript
, jquery, kixtart, klonec, klonecpp, latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, make, mapbasic, matlab, mirc, modula3, mmix, mpasm, mxml, mysql
, newlisp, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11
, pascal, perl
, perl6, per, php-brief, php
, pike, pic16, pixelbender, plsql, povray, powerbuilder, powershell
, progress, prolog, properties, providex, purebasic, python
, qbasic, rails, rebol, reg, robots, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql
, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, vbnet, vb
, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xml
, xorg_conf, xpp, z80
使用上面的<code>
或<file>
标签如果希望让显示的代码可以被下载,可通过在语言代码后面指定一个文件名来实现。
<?php echo "Silic Wiki"; ?>
用法:
<file php silic.php linenum:1> 可下载.php <?php echo "Silic Wiki"; ?> </file>
如果不想要任何高亮,但想要一个可下载的文件,指定破折号(-
)作为语言代码:<code - silic.foo>
即可。
外部链接会被自动地识别:如https://silic.wiki/
或www.silic.wiki
,也可以设置链接文本:
[[https://silic.wiki|此链接指向习科小黑板]] <[email protected]>
内部链接可以用方括号创建。可以只给出[[页面名]]
或附加[[页面名|链接文本]]
,分级页面可通过冒号完成,链接到一个特定章节也是可以的,只需要在#号后面加上章节的名称。
[[页面名]] [[页面名|链接文本]] [[某目录:命名空间]] [[某页面#章节|某章某节]]
可以通过结合链接的语法用图像来链接到一个内部或者外部的页面。如下所示:
[[https://silic.wiki/|{{wiki:silic.png}}]]
请注意:图像可进行大小调整。
如果要想引用一段文本,可使用如下的标签。
本文本使用
<blockquote></blockquote>
标签引用;
<q></q>标签类似于等宽体格式;
签字使用的<cite></cite>标签
使用两个连续小括号来添加脚注,格式:((脚注1))
最多可以使用5层标题来组织内容。使用了三个以上标题系统将自动生成目录于右上角,在页面加入~~NOTOC~~
字样将禁用目录。
===== 大大标题I ===== ==== 大标题 ==== === 小标题 === == 小小标题 ==
用两个大括号在页面中加入外部或内部的图像,同时还可以指定图像大小。
原始大小:{{wiki:logo.png}} 指定宽度:{{wiki:logo.png?50}} 指定宽度和高度:{{wiki:dokuwiki-128.png?200x50}} 当指定的长宽比与图像的不一致,在调整图像大小前,其将先被裁剪到新的比例 重新指定宽度和高度的外部图像: {{https://silic.wiki/logo.png?200x50}}
通过使用左空格或右空格,您可以选择对齐方式。
左对齐:{{ wiki:dokuwiki-128.png}} 右对齐:{{wiki:dokuwiki-128.png }} 居中: {{ wiki:dokuwiki-128.png }}
给图像指定一个title(鼠标悬停可以看到)
{{ wiki:logo.png |我是标题}}
系统支持以下格式的媒体文件。
图像 | gif , jpg , png |
动画 | webm , ogv , mp4 |
音频 | ogg , mp3 , wav |
Flash | swf |
如果指定的文件格式不受支持,url将被显示为一个链接。
在链接后加入?linkonly
,文件将显示媒体文件的链接。
带编号或不带编号的列表方式系统均支持。要创建列表,在文字前加入两个空格
,然后使用*
标记不带编号的列表,用-
标记带编号的列表。
表示方法如下:
* 这是一个列表 * 第二项 * 不同的层次 * 另一项 - 带编号的列表 - 另一项 - 更深的层 - 就这样吧
系统将会把预定义的字符或者字符串转换成图像、其他文本,同时也支持emoji表情。
下面是常用的emoji表情的文本输入方式,其他emoji表情可参见emoji官方网站
引用的标记方式,如:
第一行第二行第三行
> 第一行 >> 第二行 >>> 第三行
系统支持用简单的语法创建表格。
标题1 | 标题2 | 标题3 |
---|---|---|
(1,1) | (1,2) | (1,3) |
(2,1) | 合并横向单元格(注意两条竖线) | |
(3,1) | (3,2) | (3,3) |
表格的每一行都以分隔符 ^
(标题行) 和 |
(普通行) 作为开头和结束。
^ 标题1 ^ 标题2 ^ 标题3 ^ | (1,1) | (1,2) | (1,3) | | (2,1) | 合并横向单元格(注意两条竖线) || | (3,1) | (3,2) | (3,3) |
水平合并单元格,只要将后一个单元格设置为空即可。同时要确保每一行有相同数量的单元格分隔符。
竖直的标题列也可以实现:
标题1 | 标题2 | |
---|---|---|
标题3 | (1,2) (1,3) | |
标题4 | 不再合并单元格 | |
标题5 | (2,2) | (2,3) |
标题单元格或普通大院格是由单元格前面的分隔符决定的。
| ^ 标题1 ^ 标题2 ^ ^ 标题3 | (1,2) | (1,3) | ^ 标题4 | 不再合并单元格 | | ^ 标题5 | (2,2) | (2,3) |
竖向合并单元格(垂直合并)也是可以的,通过在下面的相邻单元格输入:::
可以把两个相邻行的单元格合并。
标题1 | 标题 2 | 标题 3 |
---|---|---|
(1,1) | 对该单元垂直合并 | (1,3) |
(2,1) | (2,3) | |
(3,1) | (2,3) |
除跨行合并语法外,单元格中不能包含其他任何内容。
^ 标题1 ^ 标题 2 ^ 标题 3 ^ |(1,1)| 对该单元垂直合并 |(1,3)| |(2,1)| ::: |(2,3)| |(3,1)| ::: |(2,3)|
在文本的相反方向添加至少两个空格,可以对齐表格的文字:如果需要右对齐,在左边添加两个空格;在右边添加则文字左对齐,两边均添加空格可以实现居中对齐。
注意:不支持垂直对齐。
如果文本要没有任何格式化的显示原本的文本,用<nowiki>
标签或两个百分号%%
即可。
技术自由 技术创新 技术共享 技术原创 技术进步