Множественный онлайн-просмотр документов CastleDocpreview

Если вам понравился этот проект, пожалуйста, нажмите на звездочку в правом верхнем углу, чтобы поддержать автора, спасибо.

Модуль онлайн-просмотра файлов (перевод различных форматов в PDF)

Описание: В этом проекте объединены некоторые распространённые технологии, чтобы помочь тем, кто нуждается в онлайн-просмотре файлов или ищет конвертацию офисных файлов в PDF для просмотра. Если вы считаете, что данный проект полезен для вас, пожалуйста, нажмите на кнопку "star", большое спасибо!

Новое описание 2023 года: «Техническое описание документооборота»: https://www.yuque.com/hcwdc/open/pos2lih1vi3248g9
Учебные материалы были объединены и оптимизированы, они доступны на платформе Yuque. Древние учебные материалы также остаются доступными.

Базируясь на этой технологии была создана система управления базами знаний: https://gitee.com/hcwdc/knowledgebase> Реализованные функции:

• Конвертация различных форматов в PDF
• Конвертация офисных файлов в PNG
• Онлайн-просмотр файлов
• Просмотр файлов с мобильных устройств

Поддерживаемые форматы

• Изображения: .gif, .bmp, .jpeg, .jpg, .png, .ico, .svg
• Документы: .doc, .docx, .xls, .xlsx, .ppt, .pptx
• Файлы PDF: .pdf, сжатие PDF
• Текстовые файлы: .txt
• Аудиофайлы: .mp3, .ogg, .wav
• Видеофайлы: .mp4, .webm, .mkv

Адрес демонстрационной версии

• Адрес демонстрационной версии: http://up.icuapi.com/index

Пожалуйста, не загружайте важные файлы, временная директория будет очищена каждый месяц.
После запуска локально адрес страницы будет следующим: http://localhost:8301/index (необходимо изменить параметры конфигурации или использовать Nginx).

Способ запуска

[Обязательно] Настройте LibreOffice на вашей системе, конвертация PDF осуществляется через LibreOffice (OpenOffice также подходит).
Инструкция по установке: http://wiki.nooss.cn/archives/420.html
Установка шрифтов на Linux (без установки могут возникнуть проблемы со смешением символов): http://wiki.nooss.cn/archives/406.html

• 1. Просто скопируйте файлы из исходного кода в свой код
• 2. Упакуйте этот пример в JAR-файл и внедрите его в свой проект

Описание API

Загрузка файла

http://ip:port/demo/upload

Преобразование файла в PDF

http://ip:port/demo/toPdf

Преобразование файла в изображение

Примечание: сначала файл преобразуется в PDF, а затем с помощью PDFBox — в изображениеhttp://ip:port/demo/toPng

Преобразование файла в SVG

Примечание: сначала файл преобразуется в PDF, а затем с помощью PDFBox — в SVG

http://ip:port/demo/toSvg

Настройка параметров

castle:
  upload:
    # Конфигурируйте доступные пути самостоятельно
    fileDomain: http://up.hcses.cn/pdftools  # Адрес, доступный для просмотра файла
    fileServerPath: /www/wwwroot/up.hcses.cn/pdftools/  # Расположение хранения исходного файла на сервере

Другие замечания

• В этом примере часть конвертации PDF выполнена с использованием LibreOffice инструмента
• Преобразование PDF в изображение выполнено с использованием PDFBox компонента
• Благодарим за использование hutool компонента

Ключевые слова проекта

word to pdf, word to image, office format conversion, online file preview

Пример использования модального окна для просмотра

Добавьте <script src="preview.js"></script> в раздел head страницы

Параметры $Preview

Методы $Preview

show Открытие модального окна

window.$Preview.show : (urls: string | Array<string>, options: Options) => $Preview

// Пример
window.$Preview.show('http://123.png')
window.$Preview.show(['http://123.png', 'http://456.png'])
window.$Preview.show(['http://1s3.png', 'http://456.png'], {
	active: 1
})
```urls: Array<string> // Список адресов файлов для отображения
options: {
	active: number, // Номер активного окна при открытии (индексация начинается с нуля)
}

### closeAll Закрытие всех модальных окон

```javascript
window.$Preview.closeAll : () => void

error Обработка ошибок при парсинге пути файла

Пока обрабатывается через alert Можно переопределить по необходимости

window.$Preview.error : (msg) => void

/**
 Переопределение для использования прокси
 После переопределения alert больше не будет вызываться
 */
window.$Preview.error = (msg) => {
	console.log(msg)
}

formatType Пример грубого анализа файла по указанному пути

window.$Preview.formatType : (url: string) => 'txt' | 'img' | 'pdf' | 'mp3' | 'mp4'

formatShowType Возвращает тип файла по указанному пути

window.$Preview.formatShowType : (url: string) => FileType