目录

格式化语法

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>标签如果希望让显示的代码可以被下载,可通过在语言代码后面指定一个文件名来实现。

silic.php
<?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,文件将显示媒体文件的链接。

列表

带编号或不带编号的列表方式系统均支持。要创建列表,在文字前加入两个空格,然后使用*标记不带编号的列表,用-标记带编号的列表。

  1. 带编号的列表
  2. 另一项
  3. 更深的层
  4. 就这样吧

表示方法如下:

  * 这是一个列表
  * 第二项
    * 不同的层次
  * 另一项
  
  - 带编号的列表
  - 另一项
    - 更深的层
  - 就这样吧

文本转换

系统将会把预定义的字符或者字符串转换成图像、其他文本,同时也支持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>标签或两个百分号%%即可。

技术自由 技术创新 技术共享 技术原创 技术进步