2018-01-17 05:55:28 +00:00
# file-online-preview
2018-01-17 14:44:02 +00:00
[](https://github.com/kekingcn/kkFileView/blob/master/LICENSE)
### Introduction
This kekingcn kkFileView project is intended to be a solution for previewing documents online. At present,there are some similar paid products in the industry.
Such as 【[永中office](http://dcs.yozosoft.com/)】,【[office365](http://www.officeweb365.com/)】,【[idocv](https://www.idocv.com/)】, etc...
It is an open source implementation and released under the Apache License version 2.0. Finally,It is aimed to feedback the community after obtaining the consent of company executives,
2018-01-17 07:44:55 +00:00
special thanks to the supports of @唐老大 and the contributions of @端木详笑.
2018-01-17 14:44:02 +00:00
### Features
- Build with the popular frame spring boot
- Easy to build and deploy
- Basically support online preview of mainstream office documents, such as Doc, docx, Excel, PDF, TXT, zip, rar, pictures, etc
- REST API
- Abstract file preview interface so that it is easy to extend more file extensions and develop this project on your own
2018-01-17 07:44:55 +00:00
2018-01-17 14:44:02 +00:00
### Live demo
2018-01-17 07:44:55 +00:00
> Please treat public service kindly, or this would stop at any time.
2018-01-17 05:55:28 +00:00
URL：
2018-01-17 14:44:02 +00:00
### Documentation
2018-01-17 07:53:21 +00:00
1. 中文文档：
1. English document：
2018-01-17 07:44:55 +00:00
### Contact us && Join us
2018-01-17 14:44:02 +00:00
> We will answer everyone's questions in use of this project.
And please Google or Baidu first before asking a question, so that we can solve it efficiently.
2018-01-17 07:44:55 +00:00
Cherish life away from ineffective communication.
2018-01-17 05:55:28 +00:00
QQ group：
### Pictures for some samples
> Excel
> doc
> zip,rar
> png,jpeg,jpg,etc., support for zooming with mouse scroll, rotation, inversion,etc.
2018-01-17 14:44:02 +00:00
Considering space issues, the pictures of other types of documents will not be shown here.You can deploy it by yourself if you are interested in our project.There is a way to deploy it as below.
2018-01-17 05:55:28 +00:00
### Quick Start
2018-01-17 14:44:02 +00:00
> Technology stack
- Spring boot： spring boot Development Reference Guide ](http://www.kailing.pub/PdfReader/web/viewer.html?file=springboot )
- Freemarker
- Redisson
- Jodconverter
> Dependencies
2019-04-08 09:50:13 +00:00
- Redis(Optional, Unnecessary by default)
2018-01-17 05:55:28 +00:00
- OpenOffice or LibreOffice
2018-01-17 14:44:02 +00:00
1. First step：
2018-01-17 05:55:28 +00:00
2018-01-17 07:44:55 +00:00
2. Second step： ，
2018-01-17 05:55:28 +00:00
```
##The folder for files which are uploaded to the server(Because of running as jar)
file.dir = C:\\Users\\yudian\\Desktop\\dev\\
## openoffice configuration
office.home = C:\\Program Files (x86)\\OpenOffice 4
```
2018-01-17 07:44:55 +00:00
'file.dir' is the real storage address of the converted files, please end with '/'.
2018-01-17 05:55:28 +00:00
2018-01-17 14:44:02 +00:00
3. Third step： `http://localhost:8012/` .
2018-01-17 07:44:55 +00:00
If everything is ok,you will see the picture below.
2018-01-17 05:55:28 +00:00
2018-01-17 14:44:02 +00:00
### Changelog
2019-04-08 10:33:52 +00:00
> April 8th 2019
1. Cache and queue implementations abstract, providing JDK and REDIS implementations (REDIS becomes optional dependencies)
2. Provides zip and tar.gz packages, and provides a one-click startup script
2018-01-17 14:44:02 +00:00
> January 17th 2018
1. Refined the project directory, abstract file preview interface, Easy to extend more file extensions and depoly this project on your own
1. Added English documentation (@幻幻Fate，
1. Support for more image file extensions
1. Fixed the issue that image carousel in zip file will always start from the first
2018-01-17 05:55:28 +00:00
2018-01-17 14:44:02 +00:00
> January 12th 2018
2018-01-17 05:55:28 +00:00
1. Support for multiple images preview
2018-01-17 07:44:55 +00:00
1. Support for images rotation preview in rar/zip
2018-01-17 05:55:28 +00:00
2018-01-17 14:44:02 +00:00
> January 2nd 2018
2018-01-17 05:55:28 +00:00
2018-01-17 14:44:02 +00:00
1. Fixed gibberish issue when preview a txt document caused by the file encoding problem
1. Fixed the issue that some module dependencies can not be found
1. Add a spring boot profile, and support for Multi-environment configuration
1. Add `pdf.js` to preview the documents such as doc,etc.,support for generating doc headlines as pdf menu，
2018-01-17 05:55:28 +00:00
### Register Usage
If this project is helpful for you, please register on 'https://gitee.com/kekingcn/file-online-preview/issues/IGSBV',
2018-01-17 07:44:55 +00:00
If this project helps you to economize the service charge for preview of documents, as well as you are willing to support us, click 【donate】 below to donate a cup of coffee, we would appreciate it.
