拼贴是一种装饰艺术,通过将彩色纸张剪裁粘贴在物体上并结合特殊的绘画效果来装饰物体。软件拼贴允许您从文件系统内容中组合索引页面。
项目描述
这是什么?
decoupage 是一个 动态 文件服务器,它允许使用genshi模板和.ini文件配置索引页面。我主要编写它是因为我厌倦了使用Apache来托管我的网站并手动生成index.html文件。Decoupage提供了对文件系统的视图。
我如何使用它?
设置一个 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 文件,如果存在,则覆盖默认配置。这样的文件在 example 的 fleem 子目录中
/template = index.html fleem.txt = some fleem for ya
试试看!安装decoupage并运行 paster serve decoupage.ini,并将您的浏览器指向它提供的URL。
我如何使用decoupage做更多?
由于文件名不能以/开头(试试看!),因此可以通过在某个部分中添加/命令来扩展decoupage的功能。这是通过向[decoupage.formatters]添加setuptools entry_point来实现的。请参考decoupage setup.py和decoupage.formatters中的示例。例如:
在命令行中运行decoupage-formatters将给出可用的格式化程序列表(这些是位于[decoupage.formatters]的pluggable setuptools扩展点)。例如:/include = site.html可以在正文的顶部包含site.html genshi模板。
格式化程序
- sort
确定如何对目录中的文件进行排序;目前仅按不区分大小写的字母顺序 * reverse:反转排序顺序
- all
仅传递具有特定模式的文件;不使用ignore调用all参数的逆操作意味着仅使用带有描述的文件
- title
通过描述中的分隔符将描述分成标题和描述。现在模板将针对每个文件有额外的变量,'title'。参数:* 分隔符:使用什么分隔符(默认为':')
- describe
从文件名中获取描述,文件扩展名(如果有)将被删除,下划线将被空格替换
- ignore
忽略glob模式匹配的文件。这些文件不会在模板中链接。例如:/ignore = .* *.pdf # 不要列出点文件和PDF文件
include:在正文的顶部包含一个文件
css:指定使用的CSS(以空格分隔的列表)
Decoupage还使用了其他特殊内置关键字
formatters:要应用的格式化程序的有序列表
inherit:从特定目录继承配置(而不是父目录)
transform:contenttransformer的变换器列表
测试
目前,测试非常有限。
待办事项
允许在每个目录的基础上配置变换器
添加一个?format=rss查询字符串参数
添加一个?template=foo.html查询字符串参数
项目详情
decoupage-0.16.0.tar.gz的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 60193bcffa3c0393ea7f8f1d782ceaf2859ab1c47e3d4fa4047a0f6cfc3e3a19 |
|
MD5 | ff9fb288bf7f0f9ebc855fb93527c36d |
|
BLAKE2b-256 | cce51ae5bce4916a65f27c5a8450e6ed79df3c4d10012892a3d29cc4f370fb75 |