Redmine

在 Redmine 预览窗格中预览各种文件类型。适用于问题附件、文档模块、文件模块和仓库。

截至版本 4.1.3，插件支持按项目激活

此插件旨在与自己的插件一起使用。即插件的插件。为了预览文件，此插件将预览文件内容转换为以下类型之一：

• pdf
• png, jpg 或 gif
• html 或内联 html
• 文本，或
• xml

适当的转换类型由插件开发者决定。可在插件配置页面选择可用的转换选项。此插件的开发考虑了线程安全。启用缓存后，它应该能够承受更高的负载。

目前，存在以下插件：

此插件要求您的系统上安装了 LibreOffice。LibreOffice 必须对由 Redmine 服务执行的用户可访问，使用 "soffice"。

Libre 使用 LibreOffice 进行转换。Libre 转换几乎可以转换 LibreOffice 可以转换的所有内容

.csv , .doc , .docm , .docx , .dotm , .dotx , .fodg , .fodp , .fods , .fodt , .odb , .odc , .odf , .odg , .odi , .odm , .odp , .ods , .odt , .otg , .oth , .otp , .ots , .ott , .oxt , .potm , .potx , .ppt , .pptm , .pptx , .rtf , .sda , .sdc , .sdd , .sdp , .sds , .sdw , .sgl , .smf , .stc , .std , .sti , .stw , .sxc , .sxd , .sxg , .sxi , .sxm , .sxw , .vor , .xls , .xlsm , .xlsx , .xltm , .xltx

转换为 pdf、html、内联、png、jpg 或 gif。

请注意，并非所有转换都已彻底测试。如果您不确定您的文件是否会被转换并在浏览器中查看，请将文件发送给我进行转换测试。此外，请注意，转换精度很大程度上取决于已安装字体的可用性。请咨询 LibreOffice 站点以了解如何安装字体。

目前彻底测试的是：.csv、.doc、.docx、.ppt、.pptx、.xls、.xlsx、.odtt、.rtf

此插件不需要在您的系统上安装任何额外的软件。

Cliff 转换

.mime, .eml

为 html。

您几乎可以像在专业的电子邮件查看器中一样查看 .eml 文件，查看邮件头并下载附件。Cliff 会从脚本、以 "on…" 开头的事件属性、CSS 样式中的 url() 和外部图像中清除 .eml 文件。要进行不安全预览，您可以按下一个按钮进行操作，并且如果您信任 .eml 或 .mime 文件

Mark 使用 Pandoc 进行转换。目前支持的是

.md, .textile, .html

Peek 允许您在浏览器中预览 pdf 文件。Peek 使用 ImageMagick 进行转换。ImageMagick 使用 Ghostscript 作为代理来处理 pdf 文件。PDF 预览可以是完整的 PDF 或第一页的 png、jpg 或 gif。请注意，转换分辨率强烈取决于您的 ImageMagick 在 delegates 文件中的配置。请参考 ImageMagick 的配置帮助以编辑 delegates 文件。

Zippy 允许您在浏览器中预览 zip、tgz 或 tar 文件。单击条目可从压缩文件中下载单个文件。

DO NOT USE NilText IN PRODUCTION

NilText 允许您查看可用于文件转换的数据。NilText 不适合生产使用。您可以浏览此插件以了解插件功能。请注意，此插件可能会揭示存储库的密码。像所有其他插件一样，此插件默认不激活。

使用¶

转到管理 -> 插件 -> Redmine 更多预览配置

选择以下选项

• 使用 embed 标签或 iframe 标签
• 缓存预览（加快查看速度，可能会略微膨胀您的 rails 根 tmp 文件夹）
• 激活上面的子插件
• 对于每个子插件，激活您希望预览的文件扩展名（如果您选择两个转换相同文件类型的子插件，则将发出警告，并最后激活的子插件将执行转换）。

祝您玩得开心！

本地化¶

• 英语
• 德语
• 西班牙语
• 法语
• 日语
• 葡萄牙语（巴西）
• 葡萄牙语
• 俄语
• 中文

母语者：请帮助改进本地化

变更日志¶

*5.0.8
- 修正了 File.exists? 为 File.exist?
- 修正了 zippy 的 URI.esacape 为 URI.encode\_www\_form\_component
- 修正了 zippy 内联 zip 文件内容表中的链接的长期问题

*5.0.7
- 另一个补丁以取悦 Zeitwerk

*5.0.6
- 另一个补丁以取悦 Zeitwerk

*5.0.5
- 另一个补丁以取悦 Zeitwerk

*5.0.4
- 添加了更多 include 语句以取悦 Zeitwerk

*5.0.3
- 移除了遗留代码以取悦 Zeitwerk

*5.0.2
- 改变了文件加载顺序以取悦 Zeitwerk

*5.0.1
- 修正了一些新的区域文件

*5.0.0
- 在 Redmine 5 下运行

• 4.1.3
  - 添加了对按项目插件激活的支持
  - 添加了对开发模式更好的支持
  - 修正了 repositories 控制器补丁找不到项目
  - 一些小错误修复

• 4.1.1
  - 添加了附件预览页面和条目（存储库）预览页面的分页链接
  - 修正了日语本地化

• 4.0.1a
  - 添加了防止插件注册的方法，如果 mimemagic 未安装。在这种情况下，将显示永久性错误消息。

• 4.0.0a
  - 将切换到使用 'prepend' 修补现有 redmine 类而不是别名链，因此与低于 4.0 的 redmine 版本不兼容。由于许多 redmine 插件现在使用 Rails 5 中引入的 'prepend' 方法，'prepend' 和别名链方法的存在，其中 'prepend' 和别名链方法是互不兼容的，因此共存无法进一步维持。

---

• 3.2.0
  - 添加了新的预览器 "vince"，用于预览 vcf 虚拟名片

• 3.1.2
  - 代码添加

• 3.1.1
  - 为 zippy 的 Gemfile 添加了修复

• 3.1.0
  - 改进了图像转换的渲染
  - 添加了将图像相互转换的新转换器 Maggie
  - 更新了 nil text 注释

• 3.0.3
  - 修复了转换器 'mark' 处理包含空格的文件名

• 3.0.2
  - 添加了名为 'pass' 的转换器

• 3.0.1
  - 修复了转换器'mark'的'文件'错误

• 3.0.0b
  - 对代码和文件进行了重新排列，以更好地匹配zeitwerk
  - 使其兼容开发模式
  - 测试版质量

• 2.0.11
  - 修正了自动加载路径

• 2.0.10
  - 修正了附件的损坏API调用

• 2.0.9
  - 简化了cliff的钩子视图

• 2.0.8
  - 修复了tmpfile方案（内部）

• 2.0.7
  - 在cliff中添加了对非ASCII电子邮件标题的支持

• 2.0.6
  - 在cliff中添加了对邮件日期的时区支持

• 2.0.5
  - 修改许可证后修复了对mimemagick的依赖

• 2.0.4
  - 修改许可证后修复了对mimemagick的依赖

• 2.0.3
  - 修复了File.read的Windows故障

• 2.0.2
  - 修复了初次启动故障。在某些事件中，插件在首次使用时崩溃
  - 从Windows平台上的libre中移除了UserInstallation参数
  - 修复了丢失资产故障

• 2.0.1
  - 修复了最后一刻的问题

• 2.0.0
  - 重新编写并发布，支持redmine 3+，redmine 4+

• 1.0.0
  - 在Redmine 3.4.6上运行，从未发布

替换¶

此插件替换

• redmine_preview_office,
• redmine_preview_docx 和
• redmine_preview_pdf

最佳搭配¶

此插件理想上与

• redmine_preview_inline
• redmine_all_thumbnails

安装¶

下载插件并将插件文件夹redmine_more_previews复制到Redmine的插件文件夹

转到redmine根文件夹

bundle install

安装必要的gem。安装LibreOfiice（用于Libre）和/或Pandoc（用于Mark）

重启服务器等。

sudo /etc/init.d/apache2 restart

卸载¶

转到插件文件夹，删除插件文件夹redmine_attachment_categories

rm -r redmine_more_previews

重启服务器等。

sudo /etc/init.d/apache2 restart

请为此软件评分。开发依赖于您的反馈。

如果不起作用：检查管理 -> 信息。LibreOffice已安装？（Libre需要）。Pandoc已安装？（##mark##需要）。否则，给我发邮件，我会很高兴帮助您。您的反馈有助于改进插件。

迄今为止的常见问题

• Libre, ##mark##
  • LibreOffice / Pandoc未安装
  • LibreOffice / Pandoc已安装，但未为redmine进程用户设置路径
  • Redmine进程用户没有运行LibreOffice / Pandoc的权限
  • LibreOffice首次启动需要一点时间
  • 转换精度取决于LibreOffice中字体可用性
  • LibreOffice表现良好 - 但可能无法转换MS Office文件的所有细微之处
  • Redmine进程没有Rails tmp文件夹的写权限
• Peek
  • ImageMagick已安装，但Ghostscript未安装（Peek正在执行pdf到png的转换）
  • ImageMagick代理配置已配置为低像素分辨率