陈精华 2019-05-08 18:33:37 +08:00
parent 438ded6063
commit 217fe4f8ee
1 changed files with 69 additions and 2 deletions

71
Home.md

@ -1,5 +1,72 @@
## [kkFileView使用指南](https://gitee.com/kekingcn/file-online-preview/wikis/kkFileView使用指南)
## [kkFileView部署指南](https://gitee.com/kekingcn/file-online-preview/wikis/kkFileView部署指南)
## [kkFileView配置说明](https://gitee.com/kekingcn/file-online-preview/wikis/kkFileView配置说明)
## [kkFileView常见问题](https://gitee.com/kekingcn/file-online-preview/wikis/kkFileView常见问题)
## [kkFileView常见问题](https://gitee.com/kekingcn/file-online-preview/wikis/kkFileView常见问题)
## 项目简介
此项目为文件文档在线预览项目解决方案,对标业内付费产品有【[永中office](http://dcs.yozosoft.com/)】【[office365](http://www.officeweb365.com/)】【[idocv](https://www.idocv.com/)】等在取得公司高层同意后以Apache协议开源出来反哺社区在此特别感谢@唐老大的支持以及@端木详笑的贡献。该项目使用流行的spring boot搭建易上手和部署基本支持主流办公文档的在线预览如doc,docx,Excel,pdf,txt,zip,rar,图片等等
## 项目特性
1. 支持word excel pptpdf等办公文档
2. 支持txt,java,php,py,md,js,css等所有纯文本
3. 支持zip,rar,jar,tar,gzip等压缩包
4. 支持jpgjpegpnggif等图片预览翻转缩放镜像
5. 使用spring boot开发预览服务搭建部署非常简便
6. rest接口提供服务跨平台特性(java,php,python,go,php....)都支持,应用接入简单方便
7. 抽象预览服务接口,方便二次开发,非常方便添加其他类型文件预览支持
8. 最最重要Apache协议开源代码pull下来想干嘛就干嘛
## 预览展示
### 1. 文本预览
支持所有类型的文本文档预览, 由于文本文档类型过多,无法全部枚举,默认开启的类型如下 txt,html,xml,properties,md,java,py,c,cpp,sql
如有没有未覆盖全面,可通过配置文件[指定文本类型](https://gitee.com/kekingcn/file-online-preview/wikis/kkFileView%E9%85%8D%E7%BD%AE%E8%AF%B4%E6%98%8E?#simtext)
文本预览效果如下
![文本预览](https://images.gitee.com/uploads/images/2019/0508/170813_be41ec02_528790.jpeg"文本.png.jpg")
### 2. 图片预览
支持jpgjpegpnggif等图片预览翻转缩放镜像预览效果如下
![图片预览](https://images.gitee.com/uploads/images/2019/0508/164650_874c9f41_528790.png "image.png")
### 3. word文档预览
支持docdocx文档预览word预览有两种模式一种是每页word转为图片预览另一种是整个word文档转成pdf再预览pdf。两种模式的适用场景如下
* 图片预览word文件大前台加载整个pdf过慢
* pdf预览内网访问加载pdf快
默认为每页word转为图片预览可通过点击右边的pdf图标转也可通过配置文件[调整默认预览模式](https://gitee.com/kekingcn/file-online-preview/wikis/kkFileView%E9%85%8D%E7%BD%AE%E8%AF%B4%E6%98%8E?#officepreviewtype)
图片预览模式预览效果如下
![word文档预览1](https://images.gitee.com/uploads/images/2019/0508/164731_cea117ea_528790.png "word-image.png")
pdf预览模式预览效果如下
![word文档预览2](https://images.gitee.com/uploads/images/2019/0508/164801_834dfac8_528790.png "word-pdf.png")
### 4. ppt文档预览
支持pptpptx文档预览和word文档一样有两种预览模式
图片预览模式预览效果如下
![ppt文档预览1](https://images.gitee.com/uploads/images/2019/0508/164842_c07f38a3_528790.png "ppt-image.png")
pdf预览模式预览效果如下
![ppt文档预览2](https://images.gitee.com/uploads/images/2019/0508/164932_a7ff3e23_528790.png "ppt-pdf.png")
### 5. pdf文档预览
支持pdf文档预览和word文档一样有两种预览模式
图片预览模式预览效果如下
![pdf文档预览1]![pdf文档预览1](https://images.gitee.com/uploads/images/2019/0508/174325_24b3f827_528790.png "pdf-image.png")
pdf预览模式预览效果如下
![pdf文档预览2](https://images.gitee.com/uploads/images/2019/0508/174340_cb026ba7_528790.png "pdf-pdf.png")
### 6. excel文档预览
支持xlsxlsx文档预览预览效果如下
![excel文档预览](https://images.gitee.com/uploads/images/2019/0508/165123_d68a0c01_528790.png"excel.png")
ps如碰到excel预览乱码问题可参考 [预览乱码](https://gitee.com/kekingcn/file-online-preview/wikis/kkFileView%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98?#q%E9%A2%84%E8%A7%88%E4%B9%B1%E7%A0%81)
### 7. 压缩文件预览
支持zip,rar,jar,tar,gzip等压缩包预览效果如下
![压缩文件预览1](https://images.gitee.com/uploads/images/2019/0508/165215_8bc89491_528790.png "zip.png")
可点击压缩包中的文件名,直接预览文件,预览效果如下
![压缩文件预览2](https://images.gitee.com/uploads/images/2019/0508/165234_32d2ef34_528790.png "zip-inner.png")
### 8. 多媒体文件预览
理论上支持所有的视频、音频文件,由于无法枚举所有文件格式,默认开启的类型如下
mp3,wav,mp4,flv
如有没有未覆盖全面,可通过配置文件[指定多媒体类型](https://gitee.com/kekingcn/file-online-preview/wikis/kkFileView%E9%85%8D%E7%BD%AE%E8%AF%B4%E6%98%8E#convertedfilecharset)
视频预览效果如下
![多媒体文件预览1](https://images.gitee.com/uploads/images/2019/0508/170047_cb41920b_528790.png "media.png")
音频预览效果如下
![多媒体文件预览2](https://images.gitee.com/uploads/images/2019/0508/170106_6c5b01a4_528790.png "audio.png")