语法手册

概述

我们使用的标记语言非常简单，直接阅读源代码也不会困难。这篇文档为您总结了所有的编辑语法。如果您想看看它是怎么实现的，只需点击右侧边栏编辑本页¹⁾按钮即可

对于刚接触的新手朋友，建议先在目录下添加一个新页面练练手。另外，别忘了利用编辑栏上方的快捷按钮，它们能帮您轻松完成各种排版操作！

基本文本格式

支持 **粗体**、 //斜体//、__下划线__ 以及 ''等宽体'' 等格式, 也可以 **__//''混合使用''//__** 这些格式, 支持<sub>下标</sub>、<sup>上标</sup>、<del>删除线</del>

样式: 粗体–嬴政, 斜体–嬴政,下划线– 嬴政,等宽体–嬴政,混合使用–嬴政 下标– _嬴政和上标– ^嬴政、删除线– 嬴政

段落是由空行所建立的,如果您想 强制建立新行 ，您可以使用两个连续的反斜杠+空格作为标记。

代码：这是一些有着换行标记的文字 \\ 我换行了
样式: 这是一些有着换行标记的文字
我换行了

标题段落

您可以使用最多达5层的标题来使您的页面更富结构性。如果您使用了三个以上的标题，那么本页面会自动在页面上生成一个名为“本页目录”的标题列表。
当然，您也可以关闭这项特性，只需在编辑时在页面里加入 ~~NOTOC~~ 字样即可

==== Headline Level 3 ====
=== Headline Level 4 ===
== Headline Level 5 ==

您可以通过连续的4个以上“-”号来创建一条水平分割线

列表

支持带编号或不带编号的列表,要使用列表，在文字前加入两个空格，然后使用*标志不带编号的列表，用-标志带编号的列表。

  * 列表
  * 第二项
    * <wrap hi>下一层</wrap>
  * 第三项
 
 
  - 列表
  - 第二项
    -下一层
      -下一层
        -下一层
  - 第三项

列表
第二项
- 下一层
第三项

列表
第二项
1. 下一层
  1. 下一层
    1. 下一层
第三项

文本转换

可以将预定义的字符或者字符串转换成图片、其他文本或 HTML。文本到图片的转换，主要用作表情符号。文本到 HTML 的转换，多用於显示符号替换，但也可以配置为使用其他 HTML

将一些常用的表情符号转换为图像。除了默认的表情符号以外，您也可以在lib/images/smileys/文件夹中放入更多的表情图，然后在 conf/smileys.conf中设置它们即可。下面包含了的表情图像

8-)
8-O
:-(
:-)
=)
:-/
$:-\$ :-\
:-?
:-D
:-P
:-O
:-X
:-|
;-)
^_^
:?:
:!:
LOL
FIXME
DELETEME

印刷样式

可以将特定字符转换为印刷时所用的样式,下面是可以识别的这类字符的列表：

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640x480 © ™ ® "He thought 'It's a man's world'…" ²⁾

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

脚注

您可以使用两个连续小括号来添加脚注 ((看这里，这是一个脚注)) 样式:³⁾

无格式区块

若要略过某段内含维基语法，不对该段文字作任何处理，可以使用 <nowiki> 标签或更简单一点用 2 个 %% 放在该段文字的前后，请参考下面例子：

正如本段示范，包含了网址：http://www.splitbrain.org，以及**加上格式的文字**，但它没有给格式化。连表情符号；-）的转换，也与//__加上格式的文字__//一样，全都失效了

使用百分号对 //__这段__ 文字// 可以达到同样的效果 ;-).

正如本段示范，包含了网址：http://www.splitbrain.org，以及**加上格式的文字**，但它没有给格式化。连表情符号；-）的转换，也与//__加上格式的文字__//一样，全都失效了

使用百分号对 //__这段__ 文字// 可以达到同样的效果 ;-)

代码区块

在一段文字的最前面加上 2 个空白，来直接作为「文本框」不对它做加工处理。或者也可以用 <code> 或 <file> 这两个标签都可以达到类似效果

remember, information is not knowledge,
                  
                  knowledge is not wisdom
                  wisdom is not truth
                  truth is not beauty
                  beauty is not love
                  love is not music
                  music is the best
  
                                        -- frank zappa

这些区域的源码如下:

<file>
 
remember, information is not knowledge,
 
                  knowledge is not wisdom
                  wisdom is not truth
                  truth is not beauty
                  beauty is not love
                  love is not music
                  music is the best
 
                                    -- frank zappa
 
</file>

语法的高亮度显示

可把原始码语法来做高亮度显示(Syntax Highlighting)，来更加具可读性。它采用的是 GeSHi —— 所以只要 GeSHi 有支持的，本站亦可

用法就类似前例的 <code> ，但要在标签内指定该原始码所使用的语言。比如 <code java> <file java>

/** 
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */   class HelloWorldApp {   public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

目前支持的语言有: 4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm ASP Assymptote AutoConf AutoHotkey， Autoit Avisynth awk Bascomavr bash Basic4GL Batch BF biblatex bibtex BlitzBasic BNF Boo caddcl cadlisp ceylon CFDG CFM Chaiscript Chapel CIL c_loadrunner clojure c_mac cmake， cobol， coffeescript， c cpp cpp-qt cpp-winapi csharp， cs， cus esheet c_winapi dart dcl DCPU16 DCS Delphi diff div DOS dot d ecmascript Eiffel email EPC e erlang Euphoria ezt F1 Falcon fo fortran freebasic freeswitch fsharp gambas GDB Genero Genie GetText GLSL GML GNUPLOT Go Groovy GWBASIC haskell haxe hicest hq9plus html html4strict html5 图标 IDL INI inno intercal IO ISPFPANEL JavaScript JavaScript JCL j J Query Julia Kixtart klonec klonecpp kotlin latex lb LDIF Lisp LLVM locobasic logtalk lolcode lotusformulas lotusformulas lotusformula Script lscript LSL2 Lua M68K Magiksf Make MapBasic Mathematica Matlab Mercury Metapost mirc MK-61 mmix Modula2 Modula3 MPASM XMLl mySQL nagios netrexx NewLisp nginx nimrod NSIS oberon2 objc objeck oCAML-brief OCAML Octave oobass oorexx Oracle11 Oxygene oz parasail parigp pascal pcre perl6 perl per pf PHIX PHP-brief PHP pic16 Pike PixelBender PLI PostgreSQL PostScript povray PowerBuilder PowerShell ProftPD Progress Prolog properties Providex ebasic pycon pys60 Python QBASIC QML q racket rails RBS Rebol Rexx 机器人 Roff RPMspec RSPLUS Ruby Rust SAS Sass Scala Scheme SCILlab SCLLbasic SmallTalk Smarty Spark SPARQL SQL SSHconfig StandardML StoneScript Swift Systemverilog TCLG TCL Teraterm Texgraph Text ThinBasic TSQL twig typoscript unicon UPC URCI uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog 空白空间 whois winbatch wolfram xbasic XML xojo xorg_conf XPP Yaml Z80 ZXBASIC

可下载的代码块

若您使用上述的 <code> 或 <file> 语法，您或許希望让浏览者直接下载该段代码。您可以在语言代码后方指定一個文件名，方便浏览者下载： 🚩

<file php myexample.txt>
 
// php 代表需要高亮代码的语言,可以是java,c等,根据内容实际语言来
 
<?php echo "hello world!"; ?>
 
</file>

样式:

myexample.txt

<?php echo "hello world!"; ?>

链接

在 Knowledge Library System 中，链接非常灵活且功能丰富。它支持多种形式的链接，包括外部链接、内部链接、跨站（Interwiki）链接以及使用图片作为链接等。

外部链接

外部链接会被自动地识别网址：https://www.oroq.cn 或者简单地 www.oroq.cn

当然您也可以为链接设置名字：[[https://www.catalog.update.microsoft.com|链接到microsoft补丁]]

类似这样的电子邮件地址：<admin@oroq.cn> 也可以被自动识别

样式:https://www.oroq.cn， www.oroq.cn，链接到microsoft补丁，admin@oroq.cn

内部链接

内部链接可以用方括号创建,您可以只给出链接的地址：[[welcome]]，也可以附加上链接的名字：[[welcome|欢迎页面]]。

样式:welcome，欢迎页面。

您也可以链接到一个网页内部的标题，只需要将该节书签的名称以一个#号分隔加在网页的地址后面即可，这是一个 [[welcome#联系站长|跳到欢迎页联系站长一栏]]的链接

样式:跳到欢迎页的联系站长一栏

简化链接

在 /conf/interwiki.conf ⁴⁾ 文件中配置 orohttps://www.oroq.cn/,在 /lib/images/interwiki 添加链接图片如: orq.png⁵⁾

🚩 这是一个到 Knowledge Library System页面链接代码： [[orq>|Knowledge Library System]] , 效果: Knowledge Library System

图像链接

您也可以用图像来作为一个内部或者外部的链接，只需使用编辑工具栏图像链接和图像的语法，包括调整图像大小

真实尺寸:                             {{image:u.png}}
 
调整大小到给定宽度:                    {{image:u.png?50}}
 
调整大小为给定的宽度和高度:             {{image:u.png?200x50}}    
 
缩放后的外部图像：                     {{https://www.oroq.cn/_media/image:u.png?200x50}}

样式如下 ⁶⁾

调整大小到给定宽度: 调整大小为给定的宽度和高度:

调整大小为给定的宽度和高度: 缩放后的外部图像：

通过使用右留白 ^左对齐或左留白^右对齐,左右留白 ^居中，可以选择对齐方式和添加标题

{{image:u.png?150 }} {{ image:u.png?150 }} {{ image:u.png?150}}  {{  image:u.png?150|一切为了U }}

本站可以直接在页面中嵌入以下格式

如果你指定了一个不支持的媒体格式文件名，那么它将以链接的形式显示,添加链接时，你提供了媒体链接，但不会内嵌显示?linkonly

{{image:u.png?linkonly}} 样式: u.png

图像	`gif`, `jpg`, `png`
视频	`webm`, `ogv`, `mp4`
音频	`ogg`, `mp3`, `wav`
Flash	`swf`

🚩 图像嵌入外部链接和嵌入视频语法 [[https://www.oroq.cn|{{image:logo.png}}]] 与 {{ image:sea.mp4?direct&1000 |sea}} ,样式如下

Windows 共享

Windows 共享 like this are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate Intranet.

  Windows Shares like [[\\server\share|this]] are recognized, too

Notes:

For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone").
For Mozilla and Firefox it can be enabled through different workaround mentioned in the Mozilla Knowledge Base. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in conf/lang/en/lang.php (more details at localization):
conf/lang/en/lang.php
```
<?php
/**
 * Customization of the english language file
 * Copy only the strings that needs to be modified
 */
$lang['js']['nosmblinks'] = '';
```

表格

可以用简单的语法创建表格

标题 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）		（3，3）

除跨行合并语法:::外，单元格中不能包含其他内容

  ^ 标题 1      ^ 标题 2                  ^ 标题 3          ^
  | （1，1）   | 这次示范垂直合并 | （1，3）        |
  | （2，1）   | :::                        | （2，3）        |
  | （3，1）   | :::                        | （3，3）        |

您可以对齐表格的文字。只需要添加多余两个的空格在您需要对齐的方向的反向即可：如果需要右对齐，在左边添加两个空格；反之，则在右边添加。在两边均添加空格可以实现中间对齐。⁷⁾

有对齐的表格
右对齐	居中	左对齐
左对齐	右对齐	居中
xxxxxxxxxxxx	xxxxxxxxxxxx	xxxxxxxxxxxx

下面是源文件中的格式：

  ^           有对齐的表格           ^^^
  |         右对齐|    居中    |左对齐          |
  |左对齐          |         右对齐|    居中    |
  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

HTML或PHP

可以在文件里透过加入 <html> or <php> 标签来使用HTML或PHP

<html> 这是一段用 <font color="red" size="+1">HTML 写的红色字(size=+1)</font></html>

<php>echo date("Y-h:i:s");  </php>

样式: 这是一段用 HTML 写的红色字(size=+1)

echo date("Y-h:i:s");

🚨 HTML 及 PHP 语法可以在configuration settings中决定支持与否。若您的设定不打开这两项功能 ⁸⁾ 那么上面的例子就不会被执行，而是直接显示出来原始写法。

RSS/ATOM Feed 聚合

可以整合外部 XML 数据源。解析XML订阅源时使用SimplePie。SimplePie理解的所有格式也可以在本系统中使用。你可以通过多个额外的空间分离参数来影响渲染：

參數	描述
any number	将作为显示的最大数量物品，默认为8
reverse	先显示信息流中的最后一项
author	显示项目作者姓名
date	展示项目日期
description	展示物品描述。所有HTML标签都会被剔除
nosort	不要对信息流中的物品进行排序
n[dhm]	刷新周期，其中 d = 天，h = 小时，m = 分钟。（例如12小时=12小时）

刷新周期默认为4小时。任何低于10分钟的数值都会被视为10分钟。系统通常会尝试提供缓存版本的页面，显然当页面包含动态外部内容时，这种做法不合适。该参数告诉系统如果页面上次渲染超过刷新周期，就重新渲染页面。

默认情况下，动态会按日期排序，优先显示最新内容。你可以先用参数按最早排序，或者用显示原始数据流。

🚩 {{rss>http://slashdot.org/index.rss 5 author date 1h }}

控制宏

控制宏会影响本站对页面的渲染，而自身不输出任何內容,可用的控制宏如下：

宏	描述
~~NOTOC~~	如果页面中出现该控制宏，将不会为该页创建目录。
~~NOCACHE~~	默认会缓存所有的输出。有时您并不希望内容被缓存（例如您使用了上述的<php>语法，页面会动态生成），便可使用这个控制宏，强制在每次访问时都重新生成页面。

¹⁾

需要相关权限

²⁾

在配置文件中可以禁用这类自动转换。

³⁾

看这里，这是一个脚注

⁴⁾

支持HTML语言

⁵⁾

图片名称需对应,对应好后会自动连接图片,不支持ico格式图片

⁶⁾

当给定的宽高比与图像不匹配时，会先裁剪到新的比例后再调整大小

⁷⁾

注：不支持垂直对齐

⁸⁾

可单独打开两者之一功能