在浏览器上呈现PDF的视图插件
ckanext-pdfview的Python项目详细描述
ckanext pdfview
此扩展为使用PDF.js的pdf文件提供了一个视图插件。
除了查看PDF之外,此版本还利用了捆绑的2.3版之前的查看器中没有的最新PDF.js功能,即:
- 本地化。尽可能使用ckan的语言设置。
- 工具菜单。转到第一页/最后一页。顺时针/逆时针旋转。手动工具。文档属性。
- 全屏支持。
- PDF附件支持。
- 表演。在支持WebGL和Web Worker的浏览器中更快地呈现PDF。
- 实现hundreds of PDF.js bug fixes
要求
此扩展仅适用于ckan>;=2.3。在以前的ckan版本上 查看器包含在主ckan存储库中。
安装
安装ckanext pdfview:
激活您的CKAN虚拟环境,例如:
source /usr/lib/ckan/default/bin/activate
将ckanext pdfview python包安装到虚拟环境中:
pip install ckanext-pdfview
将pdf_view添加到ckan中的ckan.plugins设置 配置文件(默认情况下,配置文件位于 /etc/ckan/default/production.ini)。
如果要呈现的pdf文件与 ckan还需要启用resource_proxy插件。
重启ckan。例如,如果您在ubuntu上使用apache部署了ckan:
sudo service apache2 reload
开发安装
要安装ckanext pdfview进行开发,请激活ckan virtualenv并 做:
git clone https://github.com/ckan/ckanext-pdfview.git cd ckanext-pdfview python setup.py develop
运行测试
要运行测试,请执行:
nosetests --nologcapture --ckan --with-pylons=test.ini
在pypi上注册ckanext pdfview
ckanext pdfview应该在pypi上可用 https://pypi.python.org/pypi/ckanext-pdfview。如果链接不起作用,那么 您可以按照以下步骤第一次在pypi上注册项目 步骤:
创建项目的源分发版:
python setup.py sdist
注册项目:
python setup.py register
将源分发上载到pypi:
python setup.py sdist upload
在github上标记项目的第一个版本,版本号为 setup.py文件。例如,setup.py中的版本号是 0.0.1然后执行:
git tag 0.0.1 git push --tags
发布新版本的ckanext pdfview
ckanext pdfview在pypi上可用作https://pypi.python.org/pypi/ckanext-pdfview。 要将新版本发布到pypi,请执行以下步骤:
更新setup.py文件中的版本号。 见PEP 440 如何选择版本号。
创建新版本的源发行版:
python setup.py sdist
将源分发上载到pypi:
python setup.py sdist upload
在github上标记项目的新版本,版本号为 setup.py文件。例如,setup.py中的版本号是 0.0.2然后执行:
git tag 0.0.2 git push --tags
源代码安装故障排除
attributeerror:“module”对象没有属性“ckanext pdfview/main”
将ckan源安装升级到2.3+时,请确保删除旧的捆绑pdfview。
rm -rf /usr/lib/ckan/default/src/ckan/ckanext/pdfview
pdfview曾经是ckan核心的一部分,并且has been made a separate extension使迭代pdf查看器增强变得更容易。
另外,请确保注册任何新的或更新的插件:
. /usr/lib/ckan/default/bin/activate cd /usr/lib/ckan/default/src/ckan python setup.py develop