Dokuwiki插件:Wrap

Dokuwiki插件:Wrap

好久没更新了,继续写Dokuwiki的东西……

在我看来,此插件应属Dokuwiki使用中的必备用品之一,绝对值得关注。它主要扩充了排版功能,可以取代以前许多旧的插件。如果你曾经是Osmond的读者,应该对作者介绍一些诸如box、color之类的插件有印象,现在它们的功能都可以用wrap来完成。

更重要的是,用wrap,你可以轻松进行自定义

安装就不多说了,网址:http://www.dokuwiki.org/plugin:wrap

基本语法

总共有两种类型:以大写的<WRAP></WRAP>包围的生成区块元素,即<div></div>;以小写的<wrap></wrap>包围的生成行内元素,即<span></span>。

第一种:

<WRAP classes width :language>
区块元素内容
</WRAP>

第二种

<wrap classes width :language>行内元素内容</wrap>

其中classes指定元素的类(class),width给定一个宽度,language指定语言。在自定义中,最为常用的就是class了,语言一般不用考虑。

用法

说了这么多,估计你仍然不知道怎么用,我当时也不知道。幸好wrap的作者提供了非常完备有用的示例文件。把lib/plugins/wrap下面的example.txt的内容复制到一个wiki页面里就可以随时参考了。这里举几个例子

比如三栏排版

<WRAP column 30%>第一栏</WRAP>
<WRAP column 30%>第二栏</WRAP>
<WRAP column 30%>第三栏</WRAP>

column用来实现多栏排版,默认是左对齐的(CSS属性为float:left)。30%指定列的宽度,也可以用绝对宽度,如200px。

再如产生一个带圆角的漂亮盒子

<WRAP box 50% round></WRAP>

box和column类似,但是预定义了更多样式,默认是有背景色的。这里round指定要带圆角。

column和box有一个特殊的作用,实现对表格宽度的控制,比如占据50%的宽度(column和box中的表格默认都是100%宽度的)

<WRAP column 50%>
^表头^
|表内容|
</WRAP>

再如产生一个带下载图标的圆角盒子(不少网站都用这种效果……)

<WRAP download round 200px>
//**下载**//
</WRAP>

自定义

非常简单,用语法

<WRAP div_test></WRAP>

就会产生代码

<div class="wrap_div_test"></div>

只需要对wrap_div_test类定义CSS就行了。

<WRAP div_test 300px></WRAP>

限定了产生的<div>块的宽度

Posted in 插件安装.

发表评论