外掛目錄 » Redmine 更多預覽
|
|
作者 | Stephan Wenzel |
|---|---|---|
| 網站 | https://github.com/HugoHasenbein/redmine_more_previews | |
| 程式碼庫 | https://github.com/HugoHasenbein/redmine_more_previews | |
| 註冊日期 | 2020-11-13 (超過 3 年前) | |
| 目前版本 | 5.0.8 | |
| 相容於 | Redmine 5.0.x, 4.2.x, 4.1.x, 4.0.x, 3.4.x | |
| 使用者評分 |
在 Redmine 的預覽窗格中預覽各種檔案類型。適用於議題附件、文件模組、檔案模組和版本庫。
從 4.1.3 版開始，支援每個專案啟用外掛
此一外掛設計用於與自身的外掛搭配使用。也就是外掛的外掛。為了預覽檔案，此一外掛會將預覽的檔案內容轉換為
- png、jpg 或 gif
- html 或內嵌 html
- 文字，或
- xml
適當的轉換類型由外掛開發人員決定。可以在外掛設定頁面上選擇可用的轉換選項。此一外掛在開發時已考慮到執行緒安全。啟用快取後，它應該可以承受更高的負載。
目前，存在以下外掛
此一外掛需要在您的系統上安裝 LibreOffice。執行 Redmine 服務的使用者必須可以使用「soffice」連線到 LibreOffice。
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、.oddt、.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。請注意，轉換解析度很大程度上取決於 delegates 檔案中 ImageMagick 的配置。請參閱 ImageMagick 的配置說明來編輯 delegates 檔案。
Zippy 讓您可以在瀏覽器中預覽 zip、tgz 或 tar 檔案。點擊一個條目即可從壓縮檔案中下載一個單獨的檔案。
DO NOT USE NilText IN PRODUCTIONNilText 讓您可以查看哪些數據可用於檔案轉換。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
- 添加了對每個專案插件啟用的支援
- 添加了對開發模式的更好支援
- 修正了儲存庫控制器修補程式找不到專案的問題
- 小錯誤修正
- 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 文字註釋
- 3.0.3
- 修復了轉換器 'mark' 處理包含空白字元文件名的問題
- 3.0.2
- 新增了名為 'pass' 的轉換器
- 3.0.1
- 修復了轉換器 'mark' 的 'File' 错误
- 3.0.0b
- 重新排列了代碼和文件，以便更好地匹配 zeitwerk
- 與開發模式兼容
- Beta 版本
- 2.0.11
- 修改了自動加載路徑
- 2.0.10
- 修復了附件 API 調用的錯誤
- 2.0.9
- 簡化了 cliff 的鉤子視圖
- 2.0.8
- 修復了臨時文件方案（內部）
- 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安裝必要的 gems。安裝 LibreOffice（適用於 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 臨時文件夾的寫入權限
- Peek
- 已安裝 ImageMagick，但未安裝 Ghostscript（Peek 正在將 pdf 轉換為 png）
- ImageMagick Delegates 配置的像素分辨率較低
更新日誌
5.0.8 (2023-04-10)
與 Redmine 5.0.x、4.2.x、4.1.x、4.0.x、3.4.x 兼容。
4.1.3 (2022-05-26)
與 Redmine 4.2.x、4.1.x、4.0.x、3.4.x 兼容。
- 添加了對每個項目啟動的支持
- 小錯誤修正
4.1.1 (2022-05-05)
與 Redmine 4.2.x、4.1.x、4.0.x、3.4.x 兼容。
3.2.0 (2022-05-03)
與 Redmine 4.2.x、4.1.x、4.0.x、3.4.x 兼容。
添加了新的轉換器 'vince' 來預覽 .vcf（vCard）文件
3.1.1 (2022-04-15)
與 Redmine 4.2.x、4.1.x、4.0.x、3.4.x 兼容。
2.0.3 (2021-05-21)
與 Redmine 4.2.x、4.1.x、4.0.x、3.4.x 兼容。
- 修復了 File.read 的 Windows 故障
2.0.2 (2021-05-12)
與 Redmine 4.2.x、4.1.x、4.0.x、3.4.x 兼容。
- 修復了 HTML 模式下 HTML 轉換缺少資源的錯誤
- 修復了在 Windows 上運行的 'libre' 插件的 soffice UserInstallation 問題
2.0.1 (2020-11-16)
與 Redmine 4.2.x、4.1.x、4.0.x、3.4.x 兼容。
2.0.1 修復了最後一刻的問題