将图像库添加到Kotti站点
kotti_image_galler的Python项目详细描述
这是Kotti CMS的扩展,允许您向Kotti站点添加带有图像的库。
它使用Bootstrap Carousel作为库视图。
兼容性
从kotti 0.7开始,kotti_image_gallery中的图像类型已移动到kotti核心。 请使用kotti_gallery包,它将用kotti versions>;=0.7取代此包。
设置
要激活kotti站点中的kotti_image_gallery加载项,您需要向粘贴部署配置中的kotti.configurators设置添加一个条目。 如果没有kotti.configurators选项,请添加一个。 然后,[app:main]部分中的行可能如下所示:
kotti.configurators = kotti_image_gallery.kotti_configure
这样,您就可以在站点中添加库和图像项。
图像URL
kotti_image_gallery通过使用plone.scale提供动态图像缩放(感谢tom lazar的提示)。
图片(包括任意比例)可以被这个url模式引用:/path/to/image_content_object/image[[/<image_scale>]/download],其中<image_scale>可以是:
- a predefined image scale (see below)
- a string of the form ^{tt10}$ or
- a URL path segment of the form ^{tt11}$
如果最后一个url路径段是download,则图像将使用Content-disposition: attachment,否则将使用Content-disposition: inline。
预定义的图像比例大小
您可以通过将kotti_image_gallery.scale_<scale_name>的值设置为<max_width>x<max_height>形式的值(例如kotti_image_gallery.scale_thumb = 160x120以及生成的缩放名称thumb)来定义.ini文件中的图像缩放大小。
thumb(160x120)和carousel(560x420)总是被定义的(因为它们在默认模板中使用),但是可以通过将kotti_image_gallery.scale_thumb和/或kotti_image_gallery.scale_carousel设置为.ini文件中的不同值来覆盖它们的值。
进行中的工作
kotti_image_gallery被认为是alpha软件,不适合在生产环境中使用。 项目的当前状态既不是功能完整的,也不是api稳定的。 如果您真的想在您的项目中使用它,请确保在您的需求中固定正确的版本。 当将来的版本可用时,不这样做可能会破坏您的项目。
开发
非常欢迎向kotti_image_gallery捐款。 只需克隆它的Github repository并将您的贡献作为请求提交。
注意,所有的开发都是在develop分支上完成的,而master是为“生产就绪状态”保留的。 因此,确保您的工作始终基于develop分支的当前状态。
这遵循了强烈推荐的A successful Git branching model模式,该模式由优秀的gitflowgit扩展实现。
测试
kotti_image_gallery有100%的测试覆盖率。 请确保您为新功能添加了测试,并且在提交拉取请求之前,所有测试都通过。 运行测试套件就像从源目录运行py.test一样简单。
待办事项
- 清除HTML/CSS
- 添加对远程库(如Flickr photosets)的支持
- 添加测试
更改
0.3.1
- 修复包装(感谢Marco Scheidhuber的报告)
0.3
- <>不要复制已经存在于Kotti 中的代码/功能
- 100%测试覆盖率
0.2
- 图像现在从文件继承。
- 将基于repoze.bitblt的图像缩放替换为更强大的基于plone.scale的版本。
0.1
- 初次发布。