格式化语法

DokuWiki支持某些简单的标记语言,它试图使数据文件尽可能可读。此页面包含您在编辑页面时可能使用的所有可能语法。只需通过按“编辑此页面”来查看此页面的来源。如果你想尝试一些东西,只需使用操场上页。通过易于访问更简单的标记quickbuttons,太。

基本文本格式

dokuwiki支持胆大斜体强调和<代码>单次文本。当然可以结合所有这些。

dokuwiki支持**粗体**,// italic //,__underlined__和''monosped'的文本。当然,你可以** __ //'''''''// __ **所有这些。

您可以使用下标上标,太。

您也可以使用下标上标

你可以把它标记为删除也是。

您也可以将其标记为已删除

段落从空行创建。如果你想的话强制换行在没有段落的情况下,可以使用两个反斜杠,后跟一个空格或行尾。

这是一些带有换行符的文本
注意,这两个反斜杠只在一行的末尾被识别
或紧随其后
如果没有它,就会出现空格。

这是一些带有换行符的文本,请注意,两个反斜杠只在行尾或后跟一个空格时才被识别,这在没有它的情况下发生。

只有在确实需要时,才应该使用强制换行符。

DokuWiki支持多种创建链接的方式。

外部

外部链接被自动识别:http://www.google.com或者简单地www.google.com.- 您也可以设置链接文本:该链接指向谷歌.电子邮件地址如下:andi@splitbrain.org也认可。

DokuWiki支持多种创建链接的方式。外部链接被自动识别:http://www.google.com或简单地www.google.com -你也可以设置链接文本:[[http://www.google.com|这个链接指向谷歌]]。像这样的电子邮件地址:也可以被识别。

内部的

使用方括号创建内部链接。你可以给一个Pagename.或者使用额外的链接文本

使用方括号创建内部链接。您可以只给出[[pagename]]或使用额外的[[pagename|link text]]。

Wiki pagenames将自动转换为小写,不允许使用特殊字符。

您可以使用名称空间通过在页面名中使用冒号。

你可以在页面名中使用冒号来使用[[some:namespaces]]。

有关命名空间的详细信息,请参阅名称空间

也可以链接到特定的部分。只需将节名添加到一个散列字符后面超文本标记语言.这个链接本节

链接到[[syntax#internal| This Section]]。

笔记:

  • 链接现有页面是否以不同的风格显示nonexisting的人。
  • DokuWiki不使用CamelCase默认情况下自动创建链接,但可以在配置文件。提示:如果DokuWiki是一个链接,那么它是启用的。
  • 当一个节的标题改变时,它的书签也会改变。所以不要太依赖段链接。

interwiki.

dokuwiki支持interwiki.链接。这些是到其他wiki的快速链接。例如,这是一个链接到维基百科关于维基的页面:维基

DokuWiki支持[[doku>Interwiki]]链接。这些是到其他wiki的快速链接。例如,这是一个关于Wiki的Wikipedia页面的链接:[[wp>Wiki]]。

Windows股份

Windows像股票也认可。请注意,这些仅在同类用户组(如公司)中只有意义内部网

Windows共享(如[\\ Server \ Share |])也被识别。

笔记:

  • 出于安全原因,直接浏览windows共享文件只能在Microsoft Internet Explorer中默认工作(且仅在“本地区域”)。
  • 对于Mozilla和Firefox,它可以通过章节中提到的不同的解决方案来启用Mozilla的知识库.然而,仍然会有一个JavaScript警告,试图打开一个Windows共享。要删除此警告(针对所有用户),请输入以下行<代码>conf / lang / en / lang.php(更多细节本地化):
    conf / lang / en / lang.php
    <?php /** *自定义英文文件*只复制需要修改的字符串*/ $lang['js']['nosmblinks'] = ";

您还可以通过组合链接和的语法,使用图像链接到另一个内部或外部页面图片(见下图):

[[http://php.net | {{wiki: dokuwiki - 128. png}}]]

请注意:图像格式是链接名称中唯一的格式化语法。

整体图像链接支持语法(包括图像调整大小,内部和外部图像和URL和InterWiki链接)。

脚注

你可以添加脚注1)通过使用双括号。

您可以使用双重括号添加脚注((这是一个脚注)。

切片

你可以使用多达5个不同级别的标题来结构你的内容。如果您有三个以上的标题,将自动生成一个目录——可以通过包含字符串来禁用这个功能<代码>~ ~ NOTOC ~ ~在文档中。

标题级别3

四级标题

标题5级
====标题级别3 ==== ===标题级别4 === ==标题级别5 ==

通过使用四个或更多的破折号,你可以做出一条水平线:


媒体文件

你可以包括外部和内部图片、视频和音频文件用卷发括号。可选地,您可以指定它们的大小。

真实尺寸:

调整到给定宽度:

调整到给定宽度和高度2)

调整外部形象:

{{wiki:dokuwiki-128.png}}调整到给定的宽度:{{wiki:dokuwiki-128.png?50}}调整到给定的宽度和高度:{{wiki:dokuwiki-128.png?200x50}}调整外部图像:{{http://php.net/images/php.gif?200x50}}

通过使用左空格或右空格,您可以选择对齐方式。

{{wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png}}

当然,您也可以添加标题(在大多数浏览器中显示为工具提示)。

这是标题

{{wiki:dokuwiki-128.png |这是标题}}

要将图像链接到另一个页面,请参见图片链接多于。

支持的媒体格式

DokuWiki可以直接嵌入以下媒体格式。

图像 gif,<代码>jpg,<代码>png
视频 webm,<代码>ogv,<代码>MP4.
音频 ogg,<代码>mp3..,<代码>波
闪光 SWF.

如果指定的文件名不支持媒体格式,那么它将显示为链接。

通过添加<代码>链接only ?提供指向媒体的链接,而不将其内联显示

{{wiki: dokuwiki - 128. png ?linkonly}}

dokuwiki - 128. - png这只是一个图片的链接。

回退的格式

不幸的是,不是所有的浏览器都能理解所有的视频和音频格式。为了缓解这个问题,您可以以不同的格式上传文件,以获得最大的浏览器兼容性。

例如,请考虑此嵌入式MP4视频:

{{video.mp4 |一个有趣的视频}}

当您上传<代码>video.webm和<代码>视频.ogv.在引用的旁边<代码>video.mp4, DokuWiki会自动添加它们作为替代,这样你的浏览器就能理解这三个文件中的一个。

此外,DokuWiki支持一个“海报”图像,它将在视频开始之前显示。该图像需要有与视频相同的文件名,或者是jpg或png文件。在上面的例子中,a<代码>video.jpg文件是可行的。

清单

Dokuwiki支持有序和无序列表。若要创建列表项,请将文本缩进两个空格并使用<代码>*对于无序列表或<代码>-订购的。

  • 这是一个列表
  • 第二项
    • 你可能有不同的水平
  • 另一个项目
  1. 相同的列表,但有顺序
  2. 另一个项目
    1. 在更深的层次上使用缩进即可
  3. 就是这样
*这是一个列表*第二项*您可能有不同的级别*另一个项目 - 相同的列表但有序 - 另一个项目 - 只需使用缩进即可更深入

也看看常见问题一览表

文本转换

DokuWiki可以将某些预定义的字符或字符串转换为图像或其他文本或超文本标记语言

文本到图像的转换主要是针对笑脸符号。和文本超文本标记语言转换用于排版替换,但可以配置为使用其他超文本标记语言也是。

文本到图像的转换

DokuWiki常用的转换表情符号S的图形次方。那些笑脸可以配置和扩展其他图像。以下是Dokuwiki中包含的表情概述:

  • 8 -)8 -)
  • 8点8点
  • : - (: - (
  • :-):-)
  • =)=)
  • :- /:- /
  • : - \: - \
  • : - ?: - ?
  • : - d: - d
  • : - p: - p
  • : - o: - o
  • : - x: - x
  • : - |: - |
  • ;-);-)
  • ^_^^_^
  • :?::?:
  • :!::!:
  • 哈哈哈哈
  • FIXMEFIXME
  • 删除我删除我

文本到HTML的转换

排版:DokuWiki可以将简单的文本字符转换为排印上正确的实体。下面是一个识别字符的例子。

→←↔⇒⇐⇔»«- - 640×480©™®”他认为“这是一个男人的世界”…”

-> <- <-> => <= <=> >> << -- --- 640 x480 (c) (tm)(右)“他认为‘这是一个男人的世界’……”

可以做任何类似的超文本标记语言,它只需要添加到模式文件

有三个例外不是来自该模式文件:乘法实体(640×480), 'single'和'双引号'。它们可以通过配置选项

报价

有时,您想要标记一些文本,以显示它是一个回复或评论。可以使用以下语法:

我想我们应该这样做>不,我们不应该>>嗯,我说我们应该>真的吗?>>是的!>>>然后让我们这样做!

我觉得我们应该这么做

不,我们不应该
好吧,我觉得我们应该
真的吗?
是的!
那我们就这么做吧!

桌子

DokuWiki支持创建表的简单语法。

标题1 标题2 标题3
行1列1 第一行第二行 第一行第三行
第2章COL 1 一些跨(注意双管)
第三行1 第三行第二列 第3行

表行必须以a开始和结束<代码>|对于普通行或a<代码>^头。

^ 1标题标题标题2 ^ ^ 3 ^ |行1坳1 |行1 Col 2行1坳3 | | |第二行坳1 |一些colspan(注意双管)| | |行3坳1 |行3 Col 2行3坳3 | |

要水平连接单元格,只需让下一个单元格完全空出来,如上所示。请确保始终有相同数量的细胞分隔器!

垂直表头也可以。

标题1 标题2
标题3 第一行第二行 第一行第三行
标题4 这次没有colspan
标题5 行2 col 2 行2彩票3

正如你所看到的,单元格前的单元格分隔符决定格式:

| ^标题1 ^标题2 ^标题3 |第1行Col 2 |第1行Col 3 | ^标题4 |这次不扩展| | ^标题5 |第2行Col 2 |第2行Col 3 |

通过添加,可以获得行跨(垂直连接的单元格)<代码>:::连接到下面的单元格。

标题1 标题2 标题3
行1列1 这个单元格垂直跨越 第一行第三行
第2章COL 1 行2彩票3
第三行1 行2彩票3

除了行跨语法之外,这些单元格不应该包含任何其他内容。

^ 1标题标题标题2 ^ ^ 3 ^ 1坳1 | |行这个细胞垂直行1坳3 | | |第二行坳1 |:::|行2坳3 | |行3坳1 |:::2坳3 | |行

您也可以对表内容进行对齐。只要在文本的另一端至少增加两个空白:在左边增加两个空白以右对齐,在右边增加两个空白以左对齐,在居中文本的两端至少增加两个空白。

表校准
正确的 中央
正确的 中央
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

这是它在来源中的外观:

^ Table with alignment ^^ | right| center |left | |left | right| center | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

注意:不支持垂直对齐。

没有格式

如果您需要与其键入完全相同的文本(没有任何格式),请括起来<代码>标签,甚至更简单,有两个百分比的标志<代码>% %.

这是包含这样的地址的一些文本:http://www.splitbrain.org和**格式化**,但没有任何内容。与笑脸;-)是相同的// __这个___) .-)。

这是一些文本,其中包含如下地址:http://www.splitbrain.org和**格式**,但没有做什么。同样适用于%%//__this__文本//带有微笑符;-)%%。

代码块

您可以通过将代码块至少缩进两个空格(如前面的示例所使用的)或使用标记将代码块包含到文档中<代码><代码>或<代码><文件>.

这是文本缩进两个空格。
这是预格式化的代码,所有空格都被保留:像<-this
这几乎是相同的,但是您可以使用它来显示您引用了一个文件。

这些块是由此来源创建的:

这是文本缩进两个空格。
这是预格式化的代码,所有的空格都被保留:像<-this 
这几乎是相同的,但是您可以使用它来显示您引用了一个文件。> < /文件

语法高亮显示

DokuWiki可以突出显示源代码,这使它更容易阅读。它使用格什通用语法荧光笔 - 因此支持Geshi支持的任何语言。语法使用上一节中描述的相同代码和文件块,但这时间要突出显示的语言语法的名称包含在标签内,例如,<代码>java <代码>或<代码><文件java>.

/** * HelloWorldApp类实现了一个应用程序,它只是简单地显示“HelloWorld !”到标准输出。*/HelloWorldApp公共静态无效主要字符串arg游戏系统出去println“Hello World !”/ /显示字符串。

以下语言字符串目前已被识别:4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript Ada aimms algol68 apache applescript apt_sources arm asm asp渐近autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic BNF boo caddcl cadlisp Ceylon CFDG CFM scriptchapel cil c_loadrunner clojure c_mac cmake COBOLcoffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi飞镖dcl dcpu16 dcs delphi diff div dos点d ecmascript埃菲尔邮件epc e erlang兴奋ezt f1猎鹰fo fortran freebasic freeswitch fsharp大阪钢巴gdb genero精灵gettext glsl gml gnuplot去groovy gwbasic haskell可把嗝hq9plus html html4strict html5图标idl ini创新Intercal IO ispfpanel java5 Java javascript JCL j jquery Julia kixtart klonec klonecpp kotlin latex lb ldif lisp LLVM locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm MXML mysql nagios netrexx newlisp nginx nimrod nsis oberon2Objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp PASCAL pcre perl6 perl per pf phix PHP -brief PHP pic16 pike pixelbender pli PLSQL postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic QML q racket rails RBS rebol rexxRobots rpmspec rsplus ruby rust sas sass scala scheme scilab SCL sdlbasic smalltalk smarty spark sparql SQL standardml stonescript swift systemverilog tclegg TCL tertertertext texgraph text thinbasic TSQL twig typoscript unicon upc urbi script vala vbnet vb vbscript vedit verilog VHDL vim visualfoxpro visualprolog whitespace whois winbatch xbasic XMLXojo xorg_conf XPP yaml z80 zxbasic

有额外的高级选项可用于语法突出显示,例如突出显示线路或添加行号。

可下载的代码块

当你使用<代码><代码>或<代码><文件>由于上面的语法,您可能还想让所示的代码可以下载。你可以在语言代码后面指定一个文件名,如下所示:

PHP myexample.php>  < / >
myexample.php
<?php回声“hello world !”? >

如果你不想高亮显示,但想要一个可下载的文件,请指定破折号(<代码>-)作为语言代码:<代码>

嵌入HTML和PHP

你可以嵌入原始超文本标记语言或PHP代码导入到文档中<代码>< html >或<代码>php> <标签。(如果需要包含块级别的元素,请使用大写标记。)

超文本标记语言例子:

这是一个block HTML

这是一些内联HTML

这是一个区块HTML

PHP示例:

 echo ' php版本:';回声phpversion ();echo '(生成的内联HTML)'; < php> echo '';回声的< td > .phpversion()。”< / td >;回声”< / tr > < /表>”;PHP > < /

回声' PHP版本:'回声phpversion.回声'(内联HTML)'

回声'
相同,但在一个块级别元素:
'回声'
相同,但在一个块级别元素中:'phpversion.''回声' < / tr > < /表> '

请注意超文本标记语言默认情况下,PHP嵌入是禁用的。如果禁用,则显示而不是执行代码。

RSS / ATOM提要聚合

DokuWiki可以集成来自外部XML提要的数据。为了解析XML提要,简单使用。SimplePie可以理解的所有格式也可以在DokuWiki中使用。您可以通过多个额外的以空格分隔的参数来影响呈现:

参数 描述
任何数量 将被用作显示的最大数量项目,默认为8
反向 首先显示提要中的最后一项
作者 显示项目作者名称
日期 显示项目日期
描述 显示项目描述。如果超文本标记语言是否禁用所有标签将被剥离
nosort 不对提要中的项目进行排序
n[DHM] 刷新周期,其中d=天,h=小时,m=分钟。(例如12h = 12小时)。

刷新周期默认为4小时。低于10分钟的任何值将被视为10分钟。DokuWiki一般会尝试提供一个页面的缓存版本,显然这在页面包含动态外部内容时,这是不合适的。参数讲述DokuWiki如果大于,则重新呈现页面刷新周期因为页面上次被渲染。

默认情况下,提要将按日期排序,最新的条目首先排序。可以使用<代码>反向参数,或与exply一起显示<代码>nosort.

例子:

{{rss>http://slashdot.org/index.rss 5作者日期1h}}

控制宏

一些语法会影响DokuWiki在不创建任何输出的情况下呈现页面的方式。以下控制宏可用:

描述
~ ~ NOTOC ~ ~ 如果在页面上找到这个宏,将不会创建目录
~ ~ ~ ~使用NOCACHE dokuwiki默认缓存所有输出。有时这可能不想要(例如,当使用上面的语法时),添加此宏将强制DokuWiki在每个呼叫中​​恢复页面

语法的插件

DokuWiki的语法可以扩展为插件.安装的插件是如何使用的,将在相应的描述页面上进行描述。以下语法插件可以在这个特定的DokuWiki安装中使用:


1) 这是一个脚注
2) 当给定宽度和高度的长宽比与图像的长宽比不匹配时,它将在调整大小之前裁剪到新的比例
Baidu