差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
wiki:syntax [2020/11/15 01:17] 限速四十 ↷ 链接因页面移动而自动修正 |
wiki:syntax [2022/03/13 04:18] A135 更新html标签 |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== | + | ====== 语法手册 |
+ | 相关的语法说明可以见下文的列表,点击链接可以查看其详细说明。 | ||
- | [[doku> | + | ===== 基础语法 ===== |
+ | * [[wiki: | ||
+ | | ||
+ | * [[wiki: | ||
- | ===== 基本文本格式 | + | ===== 高级语法 |
- | + | * [[wiki:高级语法:引用]]:用于插入参考资料或文献 | |
- | DokuWiki支持 **粗体**, //斜体//, __下划线__ 以及 '' | + | * [[wiki:高级语法: |
- | + | * [[wiki:高级语法:页面跳转]]:用于使一个页面自动跳转到另一个页面 | |
- | | + | |
- | 当然,你也可以使用 **__//'' | + | * [[wiki:高级语法:HTML标签和字符实体]]:用于HTML标签和字符实体 |
- | + | ||
- | 可以使用 < | + | |
- | + | ||
- | 可以使用 < | + | |
- | + | ||
- | 您也可以使用 < | + | |
- | + | ||
- | 您也可以使用 < | + | |
- | + | ||
- | **段落** 是由空行所建立的。如果您想 **强制建立新行** 而不建立段落,您可以使用两个连续的反斜杠+空格或是回车作为标记。请看样例: | + | |
- | + | ||
- | 这是一些有着换行标记的文字。\\ 请注意 | + | |
- | 反斜杠只在回车符之前\\ | + | |
- | 或者在\\ 一个空格之前的时候才有效。 \\而这样就并不起作用。 | + | |
- | + | ||
- | 这是一些有着换行标记的文字。\\ 请注意 | + | |
- | 反斜杠只在回车符之前\\ | + | |
- | 或者在\\ 一个空格之前的时候才有效。 \\而这样就并不起作用。 | + | |
- | + | ||
- | 请只在必须的时候才使用强制的换行标记。 | + | |
- | + | ||
- | + | ||
- | ===== 链接 ===== | + | |
- | + | ||
- | DokuWiki支持多种形式的链接。 | + | |
- | + | ||
- | ==== 外部链接 ==== | + | |
- | + | ||
- | 外部链接会被自动地识别:http:// | + | |
- | + | ||
- | DokuWiki支持多种形式的链接。外部链接会被自动地识别: | + | |
- | http:// | + | |
- | - 当然您也可以为链接设置名字: [[http:// | + | |
- | 类似这样的电子邮件地址: < | + | |
- | + | ||
- | ==== 内部链接 ==== | + | |
- | + | ||
- | 内部链接可以用方括号创建。您可以只给出链接的地址:[[pagename]],也可以附加上链接的名字:[[pagename|我的链接]]。 | + | |
- | + | ||
- | 内部链接可以用方括号创建。您可以只给出链接的地址:[[pagename]], | + | |
- | 也可以附加上链接的名字:[[pagename|我的链接]]。 | + | |
- | + | ||
- | [[doku> | + | |
- | + | ||
- | 您可以通过在页面名中使用冒号的方式来使用 [[wiki: | + | |
- | + | ||
- | 您可以通过在页面名中使用冒号的方式来使用 [[wiki: | + | |
- | + | ||
- | 如果您需要关于命名空间(namespaces)的更详细的信息,请参见 [[doku> | + | |
- | + | ||
- | 您也可以链接到一个网页内部的某一节,只需要将该节书签的名称以一个# | + | |
- | + | ||
- | 这是一个连向 [[syntax# | + | |
- | + | ||
- | 注: | + | |
- | + | ||
- | * 到 [[格式语法说明|已存在页面]] 的链接和到 [[nonexisting|未存在页面]] 的链接,其外观是不同的。 | + | |
- | * 默认情况下,DokuWiki不使用 [[wp> | + | |
- | * 当一节的标题改变时,该节的书签也会改变,因此,请不要太依靠网页内的链接。 | + | |
- | + | ||
- | ==== Wiki间链接 ==== | + | |
- | + | ||
- | DokuWiki支持 [[interwiki|Wiki间链接]] ,即到其他wiki的链接。例如,这是一个到Wikipedia上关于Wiki的一个页面的的链接: [[wp> | + | |
- | + | ||
- | DokuWiki支持 [[interwiki|Wiki间链接]] | + | |
- | 例如,这是一个到Wikipedia上关于Wiki的一个页面的的链接: [[wp> | + | |
- | ==== Windows共享文件夹 ==== | + | |
- | + | ||
- | Windows共享文件夹,例如 [[\\server\share|this]] 也可以被识别。请注意,这只在内部 [[wp> | + | |
- | + | ||
- | Windows共享文件夹,例如 [[\\server\share|this]] 也可以被识别。 | + | |
- | + | ||
- | 注: | + | |
- | + | ||
- | * 出于安全原因,只有在微软IE浏览器上才能够直接访问Windows共享文件夹。 (且只适用于局域网内部环境). | + | |
- | * Mozilla和Firefox可采用 | + | |
- | <?php | + | |
- | /** | + | |
- | * Customization of the english language file | + | |
- | * Copy only the strings that needs to be modified | + | |
- | */ | + | |
- | $lang[' | + | |
- | </ | + | |
- | + | ||
- | ==== 图像链接 ==== | + | |
- | + | ||
- | 您也可以用图像来作为一个内部或者外部的链接,只需同时使用链接和[[# | + | |
- | + | ||
- | [[http:// | + | |
- | + | ||
- | [[http:// | + | |
- | + | ||
- | 请注意:在链接名中使用语法,只有显示图像的语法会被识别,请不要使用其它语法。 | + | |
- | + | ||
- | DokuWiki支持完整的[[# | + | |
- | + | ||
- | + | ||
- | ===== 脚注 ===== | + | |
- | + | ||
- | 您可以使用两个连续小括号来添加脚注((看这里,这是一个脚注))。 | + | |
- | + | ||
- | 您可以使用两个连续小括号来添加脚注((看这里,这是一个脚注))。 | + | |
- | + | ||
- | ===== 标题段落 ===== | + | |
- | + | ||
- | 您可以使用最多达5层的标题来使您的页面更富结构性。如果您使用了三个以上的标题,那么DokuWiki会自动在页面上生成一个名为“本页目录”的标题列表。当然,您也可以关闭这项特性,只需在编辑时在页面里加入 ''< | + | |
- | + | ||
- | ==== H3标题 ==== | + | |
- | === H4标题 === | + | |
- | == H5标题 == | + | |
- | + | ||
- | | + | |
- | === H4标题 === | + | |
- | == H5标题 == | + | |
- | + | ||
- | 您可以通过连续的4个以上“-”号来创建一条水平分割线: | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | ===== 图像和其它文件 ===== | + | |
- | + | ||
- | 您可以使用双大括号来在页面中加入 | + | |
- | + | ||
- | 原始大小: | + | |
- | + | ||
- | 指定宽度(50 pixel): | + | |
- | + | ||
- | 指定宽度和高度(200×50)((若指定宽高比例不合适,图像将被裁减)): | + | |
- | + | ||
- | 重新指定宽度和高度的外部图像(100x100): | + | |
- | + | ||
- | 原始大小: | + | |
- | 指定宽度(50 pixel): | + | |
- | 指定宽度和高度(200×50): | + | |
- | 重新指定宽度和高度的外部图像(100x100): | + | |
- | + | ||
- | + | ||
- | 使用左方或者右方的空格,您可以选择对齐方式: | + | |
- | + | ||
- | {{ wiki: | + | |
- | + | ||
- | {{wiki: | + | |
- | + | ||
- | {{ wiki: | + | |
- | + | ||
- | {{ wiki: | + | |
- | {{wiki: | + | |
- | {{ wiki: | + | |
- | + | ||
- | 当然,您也可以指定一个图像的名字,将鼠标移到图像上可以看到效果。 | + | |
- | + | ||
- | {{ wiki: | + | |
- | + | ||
- | {{ wiki: | + | |
- | + | ||
- | 如果您指定的文件名(无论是外部的还是内部的)不是一个图像'' | + | |
- | + | ||
- | ==== 支持的媒体格式 ==== | + | |
- | + | ||
- | DokuWiki 可以直接在页面中嵌入一下格式. | + | |
- | + | ||
- | | 图像 | '' | + | |
- | | 视频 | '' | + | |
- | | 音频 | '' | + | |
- | | Flash | '' | + | |
- | + | ||
- | 如果指定不支持的媒体格式的文件名,则它将作为链接显示。 | + | |
- | + | ||
- | 加上 ''? | + | |
- | + | ||
- | {{wiki: | + | |
- | + | ||
- | {{wiki: | + | |
- | + | ||
- | ==== 备用的文件格式 ==== | + | |
- | + | ||
- | 并非所有浏览器都支持所有的视频和音频格式,要解决这个问题,你可以上传不同的文件格式,以获得最大的浏览器兼容性。 | + | |
- | + | ||
- | 例如有一个 mp4 的视频文件: | + | |
- | + | ||
- | {{video.mp4|一个很有意思的视频}} | + | |
- | + | ||
- | 如果同时上传了 '' | + | |
- | + | ||
- | 此外,DokuWiki也支持" | + | |
- | + | ||
- | ===== 列表 ===== | + | |
- | + | ||
- | Dokuwiki支持带编号或不带编号的列表。要使用列表,在文字前加入两个空格,然后使用'' | + | |
- | + | ||
- | * 列表 | + | |
- | * 第二项 | + | |
- | * 下一层 | + | |
- | * 第三项 | + | |
- | + | ||
- | - 带编号的列表 | + | |
- | - 第二项 | + | |
- | - 用缩进表示更深的层 | + | |
- | - 完了 | + | |
- | + | ||
- | < | + | |
- | * 列表 | + | |
- | * 第二项 | + | |
- | * 下一层 | + | |
- | * 第三项 | + | |
- | + | ||
- | - 带编号的列表 | + | |
- | - 第二项 | + | |
- | - 用缩进表示更深的层 | + | |
- | - 完了 | + | |
- | </ | + | |
- | + | ||
- | 同时可以关注 [[doku> | + | |
- | + | ||
- | ===== 文本转换 ===== | + | |
- | + | ||
- | DokuWiki可以将预定义的字符或者字符串转换成图片、其他文本或HTML。 | + | |
- | + | ||
- | 文本到图片的转换,主要用作表情符号。文本到HTML的转换,多用於显示符号替换,但也可以配置为使用其他HTML。 | + | |
- | ==== 表情符号 ==== | + | |
- | + | ||
- | DokuWiki会将一些常用的 [[wp> | + | |
- | + | ||
- | * 8-) %% 8-) %% | + | |
- | * 8-O %% 8-O %% | + | |
- | * :-( %% :-( %% | + | |
- | * :-) %% :-) %% | + | |
- | * =) %% =) %% | + | |
- | * :-/ %% :-/ %% | + | |
- | * :-\ %% :-\ %% | + | |
- | * :-? %% :-? %% | + | |
- | * :-D %% :-D %% | + | |
- | * :-P %% :-P %% | + | |
- | * :-O %% :-O %% | + | |
- | * :-X %% :-X %% | + | |
- | * :-| %% :-| %% | + | |
- | * ;-) %% ;-) %% | + | |
- | * ^_^ %% ^_^ %% | + | |
- | * :?: %% :?: %% | + | |
- | * :!: %% :!: %% | + | |
- | * LOL %% LOL %% | + | |
- | * FIXME %% FIXME %% | + | |
- | * DELETEME %% DELETEME %% | + | |
- | + | ||
- | ==== 印刷样式 ==== | + | |
- | + | ||
- | [[DokuWiki]] 可以将特定字符转换为印刷时所用的样式。下面是可以识别的这类字符的列表: | + | |
- | + | ||
- | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | + | |
- | "He thought ' | + | |
- | + | ||
- | < | + | |
- | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | + | |
- | "He thought ' | + | |
- | </ | + | |
- | + | ||
- | 请注意:在配置文件中可以禁用这类自动转换。 | + | |
- | + | ||
- | ===== 层次显示 ===== | + | |
- | + | ||
- | 有时候(特别是讨论时)您想把某些文字(尤为各次的回复)标示作不同的层次,您可以使用下列的语法: | + | |
- | + | ||
- | < | + | |
- | I think we should do it | + | |
- | + | ||
- | > No we shouldn' | + | |
- | + | ||
- | >> Well, I say we should | + | |
- | + | ||
- | > Really? | + | |
- | + | ||
- | >> Yes! | + | |
- | + | ||
- | >>> | + | |
- | </ | + | |
- | + | ||
- | I think we should do it | + | |
- | + | ||
- | > No we shouldn' | + | |
- | + | ||
- | >> Well, I say we should | + | |
- | + | ||
- | > Really? | + | |
- | + | ||
- | >> Yes! | + | |
- | + | ||
- | >>> | + | |
- | + | ||
- | ===== 表格 ===== | + | |
- | + | ||
- | DokuWiki可以用简单的语法创建表格。 | + | |
- | + | ||
- | ^ 标题 1 ^ 标题 2 ^ 标题 3 ^ | + | |
- | | (1,1) | + | |
- | | (2,1) | + | |
- | | (3,1) | + | |
- | + | ||
- | 表格的每一行都以分隔符 '' | + | |
- | + | ||
- | ^ 标题 1 ^ 标题 2 ^ 标题 3 ^ | + | |
- | | (1,1) | + | |
- | | (2,1) | + | |
- | | (3,1) | + | |
- | + | ||
- | 要水平合并单元格,只需要将后一个单元格设置为空即可,如上面演示的一样。请确保每一行有相同数量的单元格分隔符! | + | |
- | + | ||
- | 竖直的标题列也是可以实现的: | + | |
- | + | ||
- | | ^ 标题 1 ^ 标题 2 ^ | + | |
- | ^ 标题 3 | (1,2) | + | |
- | ^ 标题 4 | 不再合并单元格 | | | + | |
- | ^ 标题 5 | (2,2) | + | |
- | + | ||
- | 可以看到,单元格前面的分隔符决定了单元格的格式。 | + | |
- | + | ||
- | | ^ 标题 1 ^ 标题 2 ^ | + | |
- | ^ 标题 3 | (1,2) | + | |
- | ^ 标题 4 | 不再合并单元格 | | | + | |
- | ^ 标题 5 | (2,2) | + | |
- | + | ||
- | 您也可以垂直合并两格或多格。只要在下面的格内输入'' | + | |
- | ^ 标题 1 ^ 标题 2 ^ 标题 3 ^ | + | |
- | | (1,1) | + | |
- | | (2,1) | + | |
- | | (3,1) | + | |
- | + | ||
- | 除跨行合并语法'' | + | |
- | + | ||
- | ^ 标题 1 ^ 标题 2 ^ 标题 3 ^ | + | |
- | | (1,1) | + | |
- | | (2,1) | + | |
- | | (3,1) | + | |
- | + | ||
- | 您可以对齐表格的文字。只需要添加多余两个的空格在您需要对齐的方向的反向即可:如果需要右对齐,在左边添加两个空格;反之,则在右边添加。在两边均添加空格可以实现中间对齐。 | + | |
- | + | ||
- | ^ | + | |
- | | | + | |
- | |左对齐 | + | |
- | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | + | |
- | + | ||
- | 下面是源文件中的格式: | + | |
- | + | ||
- | ^ | + | |
- | | | + | |
- | |左对齐 | + | |
- | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | + | |
- | + | ||
- | 注意:不支持垂直对齐 | + | |
- | + | ||
- | ===== 无格式区块 ===== | + | |
- | + | ||
- | 若要略过某段内含 WIKI 语法,不对该段文字作任何处理, 可以使用 %%< | + | |
- | + | ||
- | < | + | |
- | 正如本段示范里,本来包含了网址:http:// | + | |
- | </ | + | |
- | + | ||
- | 使用百分号对 %%// | + | |
- | + | ||
- | < | + | |
- | + | ||
- | 使用百分号对 %%// | + | |
- | + | ||
- | ===== 代码区块 ===== | + | |
- | + | ||
- | 在一段文字的最前面加上 2 个空白,来直接作为「文本框」不对它做加工处理(就像前面那些说明一样)。或者也可以用 ''< | + | |
- | + | ||
- | 这段是用 < | + | |
- | + | ||
- | < | + | |
- | 就像 | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | 这段跟上段很像,但是改用 < | + | |
- | 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 | + | |
- | </ | + | |
- | + | ||
- | 这些区域的源码如下: | + | |
- | + | ||
- | 这段是用 < | + | |
- | + | ||
- | < | + | |
- | 就像 | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | 这段跟上段很像,但是改用 < | + | |
- | 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 | + | |
- | </ | + | |
- | + | ||
- | + | ||
- | ==== 语法的高亮度显示 ==== | + | |
- | + | ||
- | [[DokuWiki]] 可把原始码语法来做高亮度显示(Syntax Highlighting),来更加具可读性。 它采用的是 GeSHi Generic Syntax Highlighter —— 所以只要 GeSHi 有支持的,DokuWiki 亦可。 | + | |
- | + | ||
- | 用法就类似前例的 '' | + | |
- | + | ||
- | <code java> | + | |
- | /** | + | |
- | * The HelloWorldApp class implements an application that | + | |
- | * simply displays "Hello World!" | + | |
- | | + | |
- | System.out.println(" | + | |
- | } | + | |
- | } | + | |
- | </ | + | |
- | + | ||
- | 目前支持的语言有: | + | |
- | + | ||
- | ==== 可下载的代码块 ==== | + | |
- | + | ||
- | 若您使用上述的 '' | + | |
- | + | ||
- | < | + | |
- | <file php myexample.php> | + | |
- | <?php echo "hello world!"; | + | |
- | </ | + | |
- | </ | + | |
- | + | ||
- | <file php myexample.php> | + | |
- | <?php echo "hello world!"; | + | |
- | </ | + | |
- | + | ||
- | 若您不想把语法高亮显示出,但想方便浏览者下载,您可以用链接号 '' | + | |
- | + | ||
- | + | ||
- | ===== 在内容中嵌入HTML或PHP语法 ===== | + | |
- | + | ||
- | 可以在文件里透过加入 '' | + | |
- | + | ||
- | < | + | |
- | 这是一段用 <font color=" | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | < | + | |
- | 这是一段用 <font color=" | + | |
- | </ | + | |
- | </ | + | |
- | 22 | + | |
- | < | + | |
- | echo '由 PHP 所产生 Logo:'; | + | |
- | echo '< | + | |
- | ' . php_logo_guid() . '" | + | |
- | | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | < | + | |
- | echo '由 PHP 所产生 Logo:'; | + | |
- | echo '< | + | |
- | ' . php_logo_guid() . '" | + | |
- | | + | |
- | </ | + | |
- | </ | + | |
- | + | ||
- | + | ||
- | + | ||
- | **请特别注意**:HTML及PHP语法可以在[[config|设定选项]]中决定支持与否。若您的DokuWiki设定不打开这两项功能(可单独打开两者之一功能)那么上面的例子就不会被执行,而是直接显示出来原始写法。 | + | |
- | + | ||
- | ===== RSS/ATOM Feed聚合 ===== | + | |
- | + | ||
- | DokuWiki能從外部XML feed中聚合數據。為分析這些XML feed,DokuWiki使用了[[http:// | + | |
- | + | ||
- | ^ 參數 | + | |
- | | any number | 最多顯示多少項內容;預設值是8。 | | + | |
- | | reverse | + | |
- | | author | + | |
- | | date | 顯示條目數據。 | | + | |
- | | description| 顯示條目的描述;如果[[doku> | + | |
- | | //n//[dhm] | 刷新周期,其中,d=日數,h=小時數,m=分。例如,12h=12小時。 | | + | |
- | + | ||
- | 預設的刷新周期是4小時。小於10分鐘者亦視為10分鐘。DokuWiki通常會提供頁面的暫存版,但這做法不適用於包含動態外部內容的頁面。上面的參數則告訴DokuWiki:若對上一次渲染時間已經過了// | + | |
- | + | ||
- | **範例: | + | |
- | + | ||
- | {{rss> | + | |
- | + | ||
- | {{rss> | + | |
- | + | ||
- | + | ||
- | ===== 控制宏 ===== | + | |
- | + | ||
- | 控制宏会影响DokuWiki对页面的渲染,而自身不输出任何內容。可用的控制宏如下: | + | |
- | + | ||
- | ^ 宏 ^ 描述| | + | |
- | | %%~~NOTOC~~%% | + | |
- | | %%~~NOCACHE~~%% | DokuWiki默认会缓存所有的输出。有时您并不希望内容被缓存(例如您使用了上述的%%< | + | |
- | + | ||
- | ===== 扩展插件 ===== | + | |
- | + | ||
- | 使用[[doku> | + |