zh:wiki:syntax
差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录前一修订版后一修订版 | 前一修订版 | ||
zh:wiki:syntax [2017-08-14 11:53] – [Tables] 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 |
下面是源文件中的格式: | 下面是源文件中的格式: | ||
行 357: | 行 359: | ||
注意:不支持垂直对齐 | 注意:不支持垂直对齐 | ||
- | ===== No Formatting | + | ===== 无格式区块 |
- | If you need to display text exactly like it is typed (without any formatting), | + | 若要略过某段内含维基语法,不对该段文字作任何处理, 可以使用 |
< | < | ||
- | This is some text which contains addresses like this: http:// | + | 正如本段示范里,本来包含了网址:http:// |
</ | </ | ||
- | The same is true for %%// | ||
- | < | + | 使用百分号对 |
- | This is some text which contains addresses like this: http:// | + | |
- | </ | + | |
- | The same is true for %%//__this__ text// with a smiley | + | |
- | ===== Code Blocks ===== | + | < |
+ | |||
+ | 使用百分号对 %%// | ||
- | You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags '' | + | ===== 代码区块 ===== |
- | This is text is indented by two spaces. | + | 在一段文字的最前面加上 2 个空白,来直接作为「文本框」不对它做加工处理(就像前面那些说明一样)。或者也可以用 ''< |
+ | |||
+ | 这段是用 < | ||
< | < | ||
- | This is preformatted code all spaces are preserved: like | + | 就像 |
</ | </ | ||
< | < | ||
- | This is pretty much the same, but you could use it to show that you quoted a file. | + | 这段跟上段很像,但是改用 < |
+ | remember, information | ||
+ | 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 | ||
</ | </ | ||
- | Those blocks were created by this source: | + | 这些区域的源码如下: |
- | | + | |
< | < | ||
- | | + | |
</ | </ | ||
< | < | ||
- | | + | |
+ | remember, information | ||
+ | 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 | ||
</ | </ | ||
- | ==== Syntax Highlighting ==== | ||
- | [[wiki:DokuWiki]] | + | ==== 语法的高亮度显示 ==== |
+ | |||
+ | [[DokuWiki]] | ||
+ | |||
+ | 用法就类似前例的 | ||
<code java> | <code java> | ||
- | /** | + | /** |
* The HelloWorldApp class implements an application that | * The HelloWorldApp class implements an application that | ||
* simply displays "Hello World!" | * simply displays "Hello World!" | ||
- | */ | + | |
- | class HelloWorldApp { | + | |
- | | + | |
System.out.println(" | System.out.println(" | ||
} | } | ||
行 413: | 行 434: | ||
</ | </ | ||
- | The following language strings are currently recognized: //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 | + | 目前支持的语言有: // |
- | ==== Downloadable Code Blocks | + | ==== 可下载的代码块 |
- | When you use the '' | + | 若您使用上述的 |
< | < | ||
行 429: | 行 450: | ||
</ | </ | ||
- | If you don't want any highlighting but want a downloadable file, specify a dash ('' | + | 若您不想把语法高亮显示出,但想方便浏览者下载,您可以用链接号 |
- | ===== Embedding | + | ===== 在内容中嵌入HTML或PHP语法 |
- | You can embed raw HTML or PHP code into your documents by using the '' | + | 可以在文件里透过加入 |
- | HTML example: | + | < |
+ | 这是一段用 <font color=" | ||
+ | </ | ||
< | < | ||
< | < | ||
- | This is some <span style="color:red;font-size:150%;">inline | + | 这是一段用 |
</ | </ | ||
- | < | ||
- | <p style=" | ||
- | </ | ||
</ | </ | ||
- | + | 22 | |
- | <html> | + | <php> |
- | This is some <span style=" | + | echo '由 PHP 所产生 Logo:'; |
- | </html> | + | echo '<img src="' |
- | < | + | ' |
- | <p style="border:2px dashed red;">And this is some block HTML</p> | + | alt="PHP Logo !" />'; |
- | </HTML> | + | </php> |
- | + | ||
- | PHP example: | + | |
< | < | ||
<php> | <php> | ||
- | echo 'The PHP version: '; | + | echo '由 PHP 所产生 Logo:'; |
- | echo phpversion(); | + | echo '< |
- | echo ' (generated inline HTML)'; | + | ' |
+ | | ||
</ | </ | ||
- | <PHP> | ||
- | echo '< | ||
- | echo '< | ||
- | echo '</ | ||
- | </ | ||
</ | </ | ||
- | <php> | ||
- | echo 'The PHP version: '; | ||
- | echo phpversion(); | ||
- | echo ' (inline HTML)'; | ||
- | </ | ||
- | <PHP> | ||
- | echo '< | ||
- | echo '< | ||
- | echo '</ | ||
- | </ | ||
- | **Please Note**: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed. | ||
- | ===== RSS/ATOM Feed Aggregation ===== | + | **请特别注意**:HTML 及 PHP 语法可以在[[config|设定选项]]中决定支持与否。若您的 |
- | [[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http:// | + | |
- | ^ Parameter | + | ===== RSS/ATOM Feed 聚合 ===== |
- | | any number | will be used as maximum number items to show, defaults to 8 | | + | |
- | | reverse | + | |
- | | author | + | |
- | | date | show item dates | | + | |
- | | description| show the item description. If [[doku> | + | |
- | | nosort | + | |
- | | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | | + | |
- | The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered. | + | DokuWiki |
- | By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the '' | + | ^ 參數 |
+ | | any number | 最多顯示多少項內容;預設值是8。 | | ||
+ | | reverse | ||
+ | | author | ||
+ | | date | 顯示條目數據。 | | ||
+ | | description| 顯示條目的描述;如果 [[doku> | ||
+ | | //n//[dhm] | 刷新周期,其中,d=日數,h=小時數,m=分。例如,12h=12小時。 | | ||
- | **Example:** | + | 預設的刷新周期是 4 小時。小於 10 分鐘者亦視為 10 分鐘。DokuWiki 通常會提供頁面的暫存版,但這做法不適用於包含動態外部內容的頁面。上面的參數則告訴 DokuWiki:若對上一次渲染時間已經過了// |
+ | |||
+ | **範例:** | ||
{{rss> | {{rss> | ||
行 505: | 行 508: | ||
- | ===== Control Macros | + | ===== 控制宏 |
- | + | ||
- | Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble: | + | |
- | + | ||
- | ^ Macro ^ Description | | + | |
- | | %%~~NOTOC~~%% | + | |
- | | %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%< | + | |
- | ===== 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.1502704434.txt.gz · 最后更改: 2017-08-14 11:53 由 111.18.35.224