zh:wiki:syntax
差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录前一修订版后一修订版 | 前一修订版 | ||
zh:wiki:syntax [2017-08-14 12:29] – [Control Macros] 111.18.35.224 | zh:wiki:syntax [2024-03-22 10:35] (当前版本) – [表] 113.87.222.208 | ||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== DokuWiki格式语法说明 | + | ====== DokuWiki 格式语法 ====== |
- | [[doku> | + | [[doku> |
===== 基本文本格式 ===== | ===== 基本文本格式 ===== | ||
- | DokuWiki支持 **粗体**, //斜体//, __下划线__ 以及 '' | + | DokuWiki 支持 **粗体**, //斜体//, __下划线__ 以及 '' |
DokuWiki支持 **粗体**, //斜体//, __下划线__ 以及 '' | DokuWiki支持 **粗体**, //斜体//, __下划线__ 以及 '' | ||
- | 当然,你也可以使用 | + | 当然,你也可以 **__//'' |
可以使用 < | 可以使用 < | ||
行 29: | 行 29: | ||
请只在必须的时候才使用强制的换行标记。 | 请只在必须的时候才使用强制的换行标记。 | ||
+ | |||
===== 链接 ===== | ===== 链接 ===== | ||
- | DokuWiki支持多种形式的链接。 | + | DokuWiki 支持多种形式的链接。 |
==== 外部链接 ==== | ==== 外部链接 ==== | ||
行 50: | 行 51: | ||
也可以附加上链接的名字:[[pagename|我的链接]]。 | 也可以附加上链接的名字:[[pagename|我的链接]]。 | ||
- | [[doku> | + | [[doku> |
您可以通过在页面名中使用冒号的方式来使用 [[wiki: | 您可以通过在页面名中使用冒号的方式来使用 [[wiki: | ||
行 56: | 行 57: | ||
您可以通过在页面名中使用冒号的方式来使用 [[wiki: | 您可以通过在页面名中使用冒号的方式来使用 [[wiki: | ||
- | 如果您需要关于命名空间(namespaces)的更详细的信息,请参见 [[doku> | + | 如果您需要关于命名空间(namespaces)的更详细的信息,请参见 [[doku> |
您也可以链接到一个网页内部的某一节,只需要将该节书签的名称以一个# | 您也可以链接到一个网页内部的某一节,只需要将该节书签的名称以一个# | ||
- | 这是一个连向 [[syntax# | + | 这是一个指向 [[syntax# |
注: | 注: | ||
* 到 [[syntax|已存在页面]] 的链接和到 [[nonexisting|未存在页面]] 的链接,其外观是不同的。 | * 到 [[syntax|已存在页面]] 的链接和到 [[nonexisting|未存在页面]] 的链接,其外观是不同的。 | ||
- | * 默认情况下,DokuWiki不使用 [[wp> | + | * 默认情况下,DokuWiki 不使用[[wp> |
- | * 当一节的标题改变时,该节的书签也会改变,因此,请不要太依靠网页内的链接。 | + | * 当一节的标题改变时,该节的书签也会改变,因此,请不要太依赖页面内的链接。 |
- | ==== Wiki间链接 ==== | + | ==== 维基间链接 ==== |
- | DokuWiki支持 [[interwiki|Wiki间链接]] ,即到其他wiki的链接。例如,这是一个到Wikipedia上关于Wiki的一个页面的的链接: [[wp> | + | DokuWiki 支持[[interwiki|维基间链接]],即到其他维基的链接。例如,这是一个到维基百科上关于“维基”的一个页面链接: [[wp> |
- | DokuWiki支持 [[interwiki|Wiki间链接]] ,即到其他wiki的链接。 | + | DokuWiki 支持[[interwiki|维基间链接]],即到其他维基的链接。 |
- | 例如,这是一个到Wikipedia上关于Wiki的一个页面的的链接: [[wp> | + | 例如,这是一个到维基百科上关于“维基”的一个页面链接: [[wp> |
- | ==== Windows共享文件夹 ==== | + | |
+ | ==== Windows 文件夹共享 | ||
- | Windows共享文件夹,例如 [[\\server\share|this]] 也可以被识别。请注意,这只在内部 [[wp> | + | Windows 文件夹共享,例如 [[\\server\share|this]] 也可以被识别。请注意,这只在内部 [[wp> |
Windows共享文件夹,例如 [[\\server\share|this]] 也可以被识别。 | Windows共享文件夹,例如 [[\\server\share|this]] 也可以被识别。 | ||
行 82: | 行 84: | ||
注: | 注: | ||
- | * 出于安全原因,只有在微软IE浏览器上才能够直接访问Windows共享文件夹。 (且只适用于局域网内部环境). | + | * 出于安全原因,只有在微软IE浏览器上才能够直接访问 Windows 文件夹共享。 (且只适用于局域网内部环境). |
- | * Mozilla和Firefox可采用 [[http:// | + | * Mozilla 和 Firefox 可采用 [[http:// |
<?php | <?php | ||
/** | /** | ||
行 91: | 行 93: | ||
$lang[' | $lang[' | ||
</ | </ | ||
+ | |||
==== 图像链接 ==== | ==== 图像链接 ==== | ||
行 102: | 行 105: | ||
请注意:在链接名中使用语法,只有显示图像的语法会被识别,请不要使用其它语法。 | 请注意:在链接名中使用语法,只有显示图像的语法会被识别,请不要使用其它语法。 | ||
- | DokuWiki支持完整的[[# | + | DokuWiki 支持完整的[[# |
行 113: | 行 116: | ||
===== 标题段落 ===== | ===== 标题段落 ===== | ||
- | 您可以使用最多达5层的标题来使您的页面更富结构性。如果您使用了三个以上的标题,那么DokuWiki会自动在页面上生成一个名为“本页目录”的标题列表。当然,您也可以关闭这项特性,只需在编辑时在页面里加入 ''< | + | 您可以使用最多达5层的标题来使您的页面更富结构性。如果您使用了三个以上的标题,那么 DokuWiki 会自动在页面上生成一个名为“本页目录”的标题列表。当然,您也可以关闭这项特性,只需在编辑时在页面里加入 ''< |
==== H3标题 ==== | ==== H3标题 ==== | ||
行 190: | 行 193: | ||
{{video.mp4|一个很有意思的视频}} | {{video.mp4|一个很有意思的视频}} | ||
- | 如果同时上传了 '' | + | 如果同时上传了 '' |
- | 此外,DokuWiki也支持" | + | 此外,DokuWiki 也支持" |
===== 列表 ===== | ===== 列表 ===== | ||
- | Dokuwiki支持带编号或不带编号的列表。要使用列表,在文字前加入两个空格,然后使用'' | + | Dokuwiki 支持带编号或不带编号的列表。要使用列表,在文字前加入两个空格,然后使用'' |
* 列表 | * 列表 | ||
行 224: | 行 227: | ||
===== 文本转换 ===== | ===== 文本转换 ===== | ||
- | DokuWiki可以将预定义的字符或者字符串转换成图片、其他文本或HTML。 | + | DokuWiki 可以将预定义的字符或者字符串转换成图片、其他文本或 HTML。 |
- | 文本到图片的转换,主要用作表情符号。文本到HTML的转换,多用於显示符号替换,但也可以配置为使用其他HTML。 | + | 文本到图片的转换,主要用作表情符号。文本到 HTML 的转换,多用於显示符号替换,但也可以配置为使用其他 HTML。 |
==== 表情符号 ==== | ==== 表情符号 ==== | ||
- | DokuWiki会将一些常用的 [[wp> | + | DokuWiki 会将一些常用的 [[wp> |
* 8-) %% 8-) %% | * 8-) %% 8-) %% | ||
行 271: | 行 274: | ||
< | < | ||
- | I think we should do it | + | 我认为我们应该一起行动 |
- | > No we shouldn' | + | > 不行,不能一起行动 |
- | >> | + | >> |
- | > Really? | + | > 真的吗? |
- | >> | + | >> |
- | >>> | + | >>> |
</ | </ | ||
+ | 我认为我们应该一起行动 | ||
- | I think we should do it | + | > 不行,不能一起行动 |
- | > No we shouldn' | + | >> 嗯……,我感觉能行 |
- | >> Well, I say we should | + | > 真的吗? |
- | > Really? | + | >> 是! |
- | >> | + | >>> |
- | + | ||
- | >>> Then lets do it! | + | |
===== 表格 ===== | ===== 表格 ===== | ||
- | DokuWiki可以用简单的语法创建表格。 | + | DokuWiki 可以用简单的语法创建表格。 |
- | ^ 标题 1 ^ 标题 2 | + | ^ 标题 1 ^ 标题 2 ^ 标题 3 ^ |
- | | (1,1) | (1,2) | + | | (WOK) |
- | | (2,1) | + | | (2,1) |
- | | (3,1) | + | | (3,1) |
表格的每一行都以分隔符 '' | 表格的每一行都以分隔符 '' | ||
行 316: | 行 318: | ||
竖直的标题列也是可以实现的: | 竖直的标题列也是可以实现的: | ||
- | | ^ 标题 1 ^ 标题 2 ^ | + | | |
- | ^ 标题 3 | (1,2) | + | ^ 标题 3 | (1,2) |
- | ^ 标题 4 | 不再合并单元格 | | | + | ^ 标题 4 | 不再合并单元格 |
- | ^ 标题 5 | (2,2) | + | ^ 标题 5 | (2,2) |
可以看到,单元格前面的分隔符决定了单元格的格式。 | 可以看到,单元格前面的分隔符决定了单元格的格式。 | ||
行 329: | 行 331: | ||
您也可以垂直合并两格或多格。只要在下面的格内输入'':::'' | 您也可以垂直合并两格或多格。只要在下面的格内输入'':::'' | ||
- | ^ 标题 1 ^ 标题 2 ^ 标题 3 ^ | + | ^ 标题 1 ^ 标题 2 ^ 标题 3 ^ |
- | | (1,1) | + | | (1,0) | 这次示范垂直合并 |
- | | (2,1) | + | | (2,1) |
- | | (3,1) | + | | (3,1) |
除跨行合并语法'':::'' | 除跨行合并语法'':::'' | ||
行 343: | 行 345: | ||
您可以对齐表格的文字。只需要添加多余两个的空格在您需要对齐的方向的反向即可:如果需要右对齐,在左边添加两个空格;反之,则在右边添加。在两边均添加空格可以实现中间对齐。 | 您可以对齐表格的文字。只需要添加多余两个的空格在您需要对齐的方向的反向即可:如果需要右对齐,在左边添加两个空格;反之,则在右边添加。在两边均添加空格可以实现中间对齐。 | ||
- | ^ | + | ^ 有对齐的表格 |
- | | | + | | |
- | |左对齐 | + | | 左对齐 |
- | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | + | | xxxxxxxxxxxx |
下面是源文件中的格式: | 下面是源文件中的格式: | ||
行 359: | 行 361: | ||
===== 无格式区块 ===== | ===== 无格式区块 ===== | ||
- | 若要略过某段内含 | + | 若要略过某段内含维基语法,不对该段文字作任何处理, 可以使用 %%< |
< | < | ||
行 464: | 行 466: | ||
</ | </ | ||
</ | </ | ||
+ | 22 | ||
<php> | <php> | ||
echo '由 PHP 所产生 Logo:'; | echo '由 PHP 所产生 Logo:'; | ||
行 483: | 行 485: | ||
- | **请特别注意**:HTML及PHP语法可以在[[config|设定选项]]中决定支持与否。若您的DokuWiki设定不打开这两项功能(可单独打开两者之一功能)那么上面的例子就不会被执行,而是直接显示出来原始写法。 | + | **请特别注意**:HTML 及 PHP 语法可以在[[config|设定选项]]中决定支持与否。若您的 DokuWiki 设定不打开这两项功能(可单独打开两者之一功能)那么上面的例子就不会被执行,而是直接显示出来原始写法。 |
- | ===== RSS/ATOM Feed聚合 ===== | + | ===== RSS/ATOM Feed 聚合 ===== |
- | DokuWiki能從外部XML feed中聚合數據。為分析這些XML feed,DokuWiki使用了[[http:// | + | DokuWiki 能從外部 XML feed 中聚合數據。為分析這些 XML feed,DokuWiki 使用了[[http:// |
^ 參數 | ^ 參數 | ||
行 494: | 行 496: | ||
| author | | author | ||
| date | 顯示條目數據。 | | | date | 顯示條目數據。 | | ||
- | | description| 顯示條目的描述;如果[[doku> | + | | description| 顯示條目的描述;如果 [[doku> |
| //n//[dhm] | 刷新周期,其中,d=日數,h=小時數,m=分。例如,12h=12小時。 | | | //n//[dhm] | 刷新周期,其中,d=日數,h=小時數,m=分。例如,12h=12小時。 | | ||
- | 預設的刷新周期是4小時。小於10分鐘者亦視為10分鐘。DokuWiki通常會提供頁面的暫存版,但這做法不適用於包含動態外部內容的頁面。上面的參數則告訴DokuWiki:若對上一次渲染時間已經過了// | + | 預設的刷新周期是 4 小時。小於 10 分鐘者亦視為 10 分鐘。DokuWiki 通常會提供頁面的暫存版,但這做法不適用於包含動態外部內容的頁面。上面的參數則告訴 DokuWiki:若對上一次渲染時間已經過了// |
**範例:** | **範例:** | ||
行 506: | 行 508: | ||
- | ===== 控制巨集 | + | ===== 控制宏 ===== |
- | + | ||
- | 有些語法會影響DokuWiki對頁面的渲染,而自身不輸出任何內容。可用的控制巨集如下: | + | |
- | + | ||
- | ^ 巨集 | + | |
- | | %%~~NOTOC~~%% | + | |
- | | %%~~NOCACHE~~%% | DokuWiki預設會緩存所有的輸出。有時您並不希望這樣(例如您使用了上述的%%< | + | |
- | ===== Syntax Plugins ===== | + | 控制宏会影响 DokuWiki 对页面的渲染,而自身不输出任何內容。可用的控制宏如下: |
- | DokuWiki's syntax can be extended by [[doku>plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular | + | ^ 宏 ^ 描述| |
+ | | %%~~NOTOC~~%% | ||
+ | | %%~~NOCACHE~~%% | DokuWiki | ||
- | ~~INFO: | + | ===== 扩展插件 ===== |
+ | 使用[[doku> |
zh/wiki/syntax.1502706559.txt.gz · 最后更改: 2017-08-14 12:29 由 111.18.35.224