decoupage 0.15.1

这是什么？

decoupage是一个dynamic文件服务器，允许索引页 可使用genshi模板和.ini文件配置。我主要写的 因为我厌倦了使用apache来服务我的网站 手工生成index.html文件。摘要提供视图到 文件系统。

我怎么用？

设置一个paste.ini文件，该文件指定 要服务的目录（decoupage.directory）和（可选）一个 配置文件.ini文件（decoupage.configuraton），其中 根据目录指定文件的标签。一个例子 paste.ini文件位于 decoupage.ini。注意[app:decoupage]部分：

[app:decoupage]
paste.app_factory = decoupage.factory:factory
decoupage.directory = %(here)s/example
decoupage.configuration = %(here)s/example.ini

文件的标签在example.ini中，由节指定为 目录：

[/]
foo.txt = a file about cats

[/cats]
lilly.txt = lilly
hobbes.txt = a file about Hobbes

您可以从这里指定整个布局。或者，你可以 在目录中有一个index.ini，该目录如果存在，将重写 默认配置。这样的文件在fleem子目录中 共example：

/template = index.html
fleem.txt = some fleem for ya

试试看！安装剪纸并运行paster serve decoupage.ini 把你的浏览器指向它给你的网址。

我该怎么处理剪纸呢？

因为文件名不能以/开头（试试！），和 在 章节。这是通过将setuptoolsentry_point添加到 [decoupage.formatters]。参见剪纸setup.py和 decoupage.formatters例如。例如，

从命令行运行decoupage formatters将列出 可用的格式化程序（可插入设置工具扩展点 在[decoupage.formatters]上。例如：/include=site.html可以 在正文顶部包括site.html genshi模板。

格式化程序：

排序：

确定如何对目录中的文件进行排序； 现在只按字母顺序区分大小写 *反转：反转排序顺序

全部：

只传递特定模式的文件； 忽略的反面 不带参数调用all意味着只调用带描述的文件 使用

标题：

通过 分隔符 描述。模板现在将有一个附加的 变量， “标题”，每个文件 论据： *分隔符：要使用的分隔符（默认为“：”）

描述：

从文件名获取描述 文件扩展名（如果有）将被删除，并且 空格将替换下划线

忽略：

忽略全局模式的文件。 这些文件将不会在模板中链接到。 例如/ignore = .* *.pdf  # don't list dotfiles and PDFs

包含：在正文顶部包含一个文件

css：指定使用的css（空格分隔列表）

剪纸还使用其他特殊的内部关键字：

格式化程序：要应用的格式化程序的有序列表

inherit：从某个目录继承配置（而不是 家长

transform:contenttransformer的变压器列表

测试

现在，只有很少的测试。

待办事项

• allow transformers to be configurable on a per-directory basis
• add a ^{tt17}$ query string argument
• add a ^{tt18}$ query string argument