dokuwiki是一个php写的维基系统,它的插件中包含markdown插件。但是markdown语法跟dokuwiki语法混着用会出现一些bug。所以还是学一下dokuwiki的语法吧。
dokuwiki的语法跟markdown非常像,不知道它俩谁抄谁。
dokuwiki包含很多有用的插件,我比较喜欢的有:
- simplenavi:侧边栏导航,dokuwiki的侧边栏本来是自己写的一个页面(不一定是目录),可以让插件来完成
- move:移动页面插件,可以给页面进行重命名
====基本的文本=====
**粗体** \
//斜体// \
__下划线__ \
''代码片段'' \
我<sup>在上面</sup> \
我<sub>在下面</sub> \
我<del>被删除了</del> \
强行换行\ 使用两个斜杠+一个空格
段落默认是用空行隔开的
====链接====
===外部链接===
外部链接是自动识别的http://www.baidu.com \
可以设置链接显示文本,这就需要使用两对中括号
[[http://www.baidu.com|百度一下,你就知道]] \
邮箱使用一对尖括号<wei.yinfu@qq.com>
===内部链接===
只使用pagename:[[playground]] \
使用''|''号表示链接名称 \
使用冒号表示路径:[[2.功能说明:技术目标]] \
使用井号表示页面中的某个链接:[[2.功能说明:技术内容#平台角色]],不要过于依赖页面内链接
===交际链接===
interwiki是需要在interwiki.conf中进行配置的 \
链接到dokuwiki:[[doku>Interwiki]] \
链接到维基百科:[[wp>Wiki]] \
===图片链接===
点击图片进入php官网
[[http://php.net|{{wiki:dokuwiki-128.png}}]] \
====脚注====
我((haha))是一个好人
====大标题===
等号个数+标题级别=7
等号个数越少,标题字体越小
一共包括五个等级
<code>
==五级标题==
===四级标题===
====三级标题====
=====二级标题=====
======一级标题======
</code>
使用四个或者更多个''-''可以划出一条水平线来
-----------------
====多媒体====
使用双花括号可以引入内部的或者外部的图片、视频、音频文件。
<code>
原始大小 {{wiki:dokuwiki-128.png}}
固定宽度 {{wiki:dokuwiki-128.png?50}}
固定宽高 {{wiki:dokuwiki-128.png?200x50}}
引入外部文件 {{http://php.net/images/php.gif?200x50}}
</code>
通过控制花括号和链接内容的空格关系可以实现图片的左对齐、右对齐、居中对齐。
<code>
{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}
</code>
当然,可以通过''{{link|name}}''的方式给图片设置tooltip
另外,可以通过''{{link?linkonly}}''的方式设置不显示图片,只作为链接出现。
====列表====
空两个格,使用星号作为无序列表,使用减号作为有序列表
这是一个级联列表
* 动物
* 食肉
* 食草
* ......
* 植物
* 草本
* 木本
* 微生物
* 病毒
* 细菌
====文本转换====
conf/entities.conf文件描述了文字转换成特殊字符的规则
====引用====
当然用小于号了,多个小于号表示多级引用。
> 这是一个引用
>> 这是一个二级引用
====表格====
''^'' 表示表格头部项目\
''|'' 表示普通格\
'':::''表示跟邻居是同一个格\
使用空格来实现左对齐、右对齐、居中对齐\
====不格式化====
使用''<nowiki>''标签来使中间文本不进行dokuwiki转义。
====代码====
通过空两格,就可以变成代码了
语法高亮
<code 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.
}
}
</code>
可以下载的代码
<file php myexample.php>
<?php echo "hello world!"; ?>
</file>