跳转到主要内容

为数据集生成缩略图。

项目描述

此CKAN扩展添加了对生成和显示缩略图的支持。辅助函数 thumbnail_url 可以从模板中调用,例如这个例子

{% block thumbnail %}
{% set thumbnail = h.thumbnail_url(package.id) %}
{% if  thumbnail %}
    <a href="{{ h.url_for(controller='package', action='read', id=package.name) }}">
    <img class="dataset-list-thumbnail" src="{{ thumbnail }}">
    </a>
{% endif %}
{% endblock %}
  • 如果存在名为 thumbnail.png 的资源,将使用该资源。

  • 如果不存在此名称的资源,并且登录用户有足够的访问权限,则将从第一个匹配的JPEG或PNG资源生成缩略图。

  • 如果此时不存在缩略图,将使用占位符图像。

需求

  • CKAN 2.5.2

  • Pillow 3.2.0(带有PngImagePlugin和JpegImagePlugin)

安装

要安装 ckanext-datasetthumbnail

  1. 激活您的 CKAN 虚拟环境,例如

    . /usr/lib/ckan/default/bin/activate
  2. 将 ckanext-datasetthumbnail Python 软件包安装到您的虚拟环境中

    pip install ckanext-datasetthumbnail
  3. datasetthumbnail 添加到您的 CKAN 配置文件中的 ckan.plugins 设置(默认情况下,配置文件位于 /etc/ckan/default/production.ini)。

  4. 重启 CKAN。例如,如果您在 Ubuntu 上使用 Apache 部署了 CKAN

    sudo service apache2 reload

配置设置

# Show thumbnails
# (optional, default: False).
ckan.datasetthumbnail.show_thumbnail = True

# Autogenerate thumbnails
# (optional, default: False).
ckan.datasetthumbnail.auto_generate = True

# Generated thumbnail width
# (optional, default: 140).
ckan.datasetthumbnail.thumbnail_width = 140

# Generated thumbnail height
# (optional, default: int(width * 1.415)
ckan.datasetthumbnail.thumbnail_height = 140

开发安装

要为开发安装 ckanext-datasetthumbnail,激活您的 CKAN 虚拟环境并执行以下操作

git clone https://github.com/aptivate/ckanext-datasetthumbnail.git
cd ckanext-datasetthumbnail
python setup.py develop
pip install -r dev-requirements.txt

运行测试

要运行测试,请执行以下操作

nosetests --nologcapture --with-pylons=test.ini

要运行测试并生成覆盖报告,请首先确保您已在虚拟环境中安装了覆盖(pip install coverage),然后运行

nosetests --nologcapture --with-pylons=test.ini --with-coverage --cover-package=ckanext.datasetthumbnail --cover-inclusive --cover-erase --cover-tests

在PyPI上注册 ckanext-datasetthumbnail

ckanext-datasetthumbnail 应可在PyPI上作为 https://pypi.python.org/pypi/ckanext-datasetthumbnail 获得。如果该链接不起作用,则可以通过以下步骤首次在PyPI上注册项目

  1. 创建项目的源分发版

    python setup.py sdist
  2. 注册项目

    python setup.py register
  3. 将源分发版上传到 PyPI

    python setup.py sdist upload
  4. 使用 setup.py 文件中的版本号在 GitHub 上标记项目的第一个版本。例如,如果 setup.py 中的版本号为 0.0.1,则执行以下操作

    git tag 0.0.1
    git push --tags

发布 ckanext-datasetthumbnail 的新版本

ckanext-datasetthumbnail 作为 https://pypi.python.org/pypi/ckanext-datasetthumbnail 在 PyPI 上可用。要发布新版本到 PyPI,请按照以下步骤操作

  1. 更新 setup.py 文件中的版本号。有关如何选择版本号的说明,请参阅 PEP 440

  2. 创建新版本的源分发版

    python setup.py sdist
  3. 将源分发版上传到 PyPI

    python setup.py sdist upload
  4. 使用 setup.py 文件中的版本号在 GitHub 上标记项目的新的发布版本。例如,如果 setup.py 中的版本号为 0.0.2,则执行以下操作

    git tag 0.0.2
    git push --tags

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解有关 安装包 的更多信息。

源分发版

ckanext-datasetthumbnail-1.0.1.tar.gz (7.1 kB 查看哈希值)

上传时间

支持