习科小黑板 - Silic Wiki

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 |我是标题}}

系统支持以下格式的媒体文件。

如果指定的文件格式不受支持，url将被显示为一个链接。 在链接后加入?linkonly，文件将显示媒体文件的链接。

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

• 这是一个列表
• 第二项
  • 不同的层次
• 另一项

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

表示方法如下：

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

系统将会把预定义的字符或者字符串转换成图像、其他文本，同时也支持emoji表情。

下面是常用的emoji表情的文本输入方式，其他emoji表情可参见emoji官方网站

• 8-)
• 8-O
• :-(
• :-)
• =)
• :-/
• :-\
• :-?
• :-D
• :-P
• :-O
• :-X
• :-|
• ;-)
• ^_^
• :?:
• :!:
• -_-
• :gift:
• → ->
• ← <-
• ↔ <->
• ⇒ =>
• ⇐ <=
• ⇔ <=>
• » >>
• « <<
• 640×480 640x480
• © (c)
• ™ (tm)
• ® (r)

引用的标记方式，如：

第一行

第二行

第三行

> 第一行
>> 第二行
>>> 第三行

系统支持用简单的语法创建表格。

表格的每一行都以分隔符 ^(标题行) 和 | (普通行) 作为开头和结束。

^ 标题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,1)| 对该单元垂直合并       |(1,3)|
|(2,1)| :::                  |(2,3)|
|(3,1)| :::                  |(2,3)|

在文本的相反方向添加至少两个空格，可以对齐表格的文字：如果需要右对齐，在左边添加两个空格；在右边添加则文字左对齐，两边均添加空格可以实现居中对齐。

注意：不支持垂直对齐。

如果文本要没有任何格式化的显示原本的文本，用<nowiki>标签或两个百分号%%即可。

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