Dokuwiki 插件 Wrap

优质

小牛编辑

169浏览

2023-12-01

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

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

更重要的是，用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>块的宽度