跳转到主要内容

拼贴是一种装饰艺术,通过将彩色纸张剪裁粘贴在物体上并结合特殊的绘画效果来装饰物体。软件拼贴允许您从文件系统内容中组合索引页面。

项目描述

这是什么?

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 文件,如果存在,则覆盖默认配置。这样的文件在 examplefleem 子目录中

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

试试看!安装decoupage并运行 paster serve decoupage.ini,并将您的浏览器指向它提供的URL。

我如何使用decoupage做更多?

由于文件名不能以/开头(试试看!),因此可以通过在某个部分中添加/命令来扩展decoupage的功能。这是通过向[decoupage.formatters]添加setuptools entry_point来实现的。请参考decoupage setup.pydecoupage.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 (14.8 kB 查看哈希值)

上传时间

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面