向 django CMS 添加图像插件
项目描述
django CMS 图像 是一个用于 django CMS 的插件，允许您在网站上添加图像。
为该项目贡献力量，赢得奖励
由于这是一个开源项目，我们欢迎每个人参与项目并为其贡献获得奖励。成为我们精彩社区的一员，帮助我们使 django CMS 成为世界上最优秀的 CMS。
我们很高兴收到您的反馈，形式为问题和拉取请求。在提交拉取请求之前，请查阅我们的贡献指南。
我们感谢所有帮助创建和维护此包的贡献者。贡献者名单在 贡献者 部分列出。
文档
在 setup.py 文件中查看 REQUIREMENTS 以获取其他依赖项
Django Filer 1.7 或更高版本
确保 django-filer 已安装并正确配置。
安装
手动安装
运行 pip install djangocms-picture
将 djangocms_picture 添加到您的 INSTALLED_APPS
运行 python manage.py migrate djangocms_picture
配置
请注意，提供的模板在设计上非常简约。我们鼓励您根据项目需求对其进行调整和覆盖。
此插件为所有实例提供一个 默认 模板。您可以通过添加 DJANGOCMS_PICTURE_TEMPLATES 设置来提供额外的模板选择
DJANGOCMS_PICTURE_TEMPLATES = [
('background', _('Background image')),
]
您需要在 templates/djangocms_picture/ 内创建 background 文件夹，否则您将收到一个 模板不存在 错误。您可以通过复制该目录中的 default 文件夹并将其重命名为 background 来完成此操作。
另一个设置是 DJANGOCMS_PICTURE_NESTING，它允许您将图像作为同时包含其他内容（文本、图标等）的容器的背景图像进行渲染。
DJANGOCMS_PICTURE_NESTING = True
将此启用（默认为 False）。当设置为 True 时，您将能够将额外的插件放置在图片插件内。
您可以使用 DJANGOCMS_PICTURE_ALIGN 覆盖对齐样式，例如
DJANGOCMS_PICTURE_ALIGN = [
('top', _('Top Aligned')),
]
这将生成一个以 align- 为前缀的类。上面的示例将产生一个 class="align-top"。将 class 键添加到图像属性中会自动将对齐与属性类合并。
您可以通过将 DJANGOCMS_PICTURE_RESPONSIVE_IMAGES 设置为 True 来启用响应式图像技术。在这种情况下，上传的图像将根据 DJANGOCMS_PICTURE_RESPONSIVE_IMAGES_VIEWPORT_BREAKPOINTS（默认为 [576, 768, 992]）创建不同尺寸的缩略图，浏览器将负责选择最佳图像进行显示（基于屏幕视口）。
如果您没有在图像上明确设置宽度和高度值，您可以使用 DJANGOCMS_PICTURE_RATIO 来设置图像的宽高比
DJANGOCMS_PICTURE_RATIO = 1.618
我们使用 黄金比例，大约为 1.618，作为此的默认值。
在确定图像尺寸时，系统将使用以下值（按优先级排序）
在 缩略图选项 中设置的宽度和高度
自动缩放
宽度 和 高度
我们建议在占位符周围设置宽度和高度值，这样当插件使用自动缩放时，它可以找到它们
{% with 720 as width and 480 as height %}
{% placeholder content %}
{% endwith %}
可以通过django Filer设置进一步配置。
运行测试
你可以通过执行以下命令来运行测试：
virtualenv env source env/bin/activate pip install -r test_requirements/base.txt python setup.py test
从cmsplugin-filer更新
历史上，cmsplugin-filer用于在您的django CMS项目中创建文件、文件夹、图像、链接、摘要和视频插件。现在cmsplugin-filer已被存档，您仍然可以迁移旧实例，而无需手动将它们复制到新的djangocms-
有一个第三方管理命令支持您的迁移
此管理命令仅是一个起点。它已经为一些人开箱即用，但我们鼓励您阅读代码，了解它的作用，并在将它们运行在生产服务器之前在开发环境中对其进行测试。
该管理命令仅配置为将您的cmsplugin_link、cmsplugin_file、cmsplugin_folder和cmsplugin_image插件传输到现代djangocms_*插件。如果您需要传输其他cmsplugin_*插件，您将不得不编写自己的代码。
或者，您可以使用deprecate_cmsplugin_filer应用程序，该应用程序仅添加一个小迁移，将旧的cmsplugin-filer插件实例传输到新的djangocms-
下载文件
下载适合您平台文件的文件。如果您不确定选择哪个，请了解更多关于安装包的信息。
