DocHub文库PC端模板

文库简介

还在读大学的时候，当时就想着要搭建一个类似百度文库的文库站点，实现文档在线浏览。

然而，时间一晃，好几年过去了，自己终于亲自动手开发实现了一套开源文库程序。

尽管离百度文库还有着巨大的差距，尽管可(一)能(定)会存在Bug，但是，整套程序从前端到后端到数据库再到丑陋的LOGO设计，都是自己独立完成的，满满的成就感...

程序命名

起初开发这套程序，是想自己做一个IT行业的文库站点，也就是现在的IT文库(http://wenku.it)，当初给文库起名就叫IT文库，但是决定开源出来之后，觉得这样不妥，于是起了个叫DocHub的名字。

毕竟，有个Git仓库管理的站点叫GitHub，那文档(Doc)仓库也就是文库，我干嘛不叫DocHub呢？

DocHub的中文名叫多哈，程序猿，写代码就要开心，开心就要哈哈哈哈哈哈哈哈，多哈...(好幼稚)

源码地址

程序源码，托管在GitHub和Gitee

• GitHub: https://github.com/truthhun/DocHub

• Gitee: https://gitee.com/truthhun/DocHub

QQ交流群

为方便相互学习和交流，建了个QQ群，加群请备注来自DocHub

QQ交流群：457803862(猿军团)

同时要说明的是，这个是学习交流群，如果是程序相关问题，请提交issue，再把issue链接发群里。

主要技术栈

后端

Go语言框架Beego

前端

基于Bootstrap的前端框架Flat-UI

数据库

MySQL，数据存储

依赖环境

Libreoffice(或Openoffice)

用于将office文档转PDF

使用命令:

soffice --headless --invisible --convert-to pdf path/to/officefile --outdir path/to/outdir

pdf2svg

注意，这个要用最新版的pdf2svg

pdf2svg，用于将PDF转成svg矢量图片，以供阅读。

使用命令：

pdf2svg <in file.pdf> <out file.svg> [<page no>]

calibre

用于将mobi、chm、epub等文档转成PDF，然后再将pdf转成svg

注意：目前mobi、epub等文档的在线阅读功能还没有实现

阿里云OSS

存储office文档、PDF文档以及svg等文件

注意：目前只支持阿里云的OSS云存储，暂时不支持其他云存储(后期我再抽时间开发和扩展其他云存储)，不支持本地化存储(现在云存储和CDN价钱比以前便宜多了)

功能特点

文档在线阅读

DocHub文库通过svg矢量图来实现文档阅读体验的，我知道的文库站点中，新浪爱问是通过png等图片提供文档阅读体验的。

SVG相比png、jpeg等图片格式有很大的优势，至少放大不会失真，而且与JPEG 和 GIF 图像比起来，svg尺寸更小，可压缩性更强，DocHub通过gzip，将svg文件压缩，一般情况下，能减少70%的文件大小，比如200kb的svg，gzip压缩后，只有60kb左右的大小。

使用svg，大大提升了加载速度，优化了内容的阅读体验。

office文档在线阅读

这个需要经过两层转化:

office --> pdf --> svg

之前有考虑过office文档不经过转化，然后直接在线浏览的，但是方案比较复杂，部署不容易，至少我没部署成功过...

PDF文档在线阅读

将PDF文档通过pdf2svg转化，提供在线阅读

没有使用mozila的pdf.js作为PDF文档阅读的实现方案，主要是我没有解决pdf.js分片分页加载的问题，每次都需要将整个PDF文档下载下来才能提供阅读。如果文档大的话，用户需要等待好长时间，而且也比较耗费服务器带宽资源。

mobi、epub、chm文档在线阅读

使用calibre将文档转成PDF，然后pdf再转svg。

目前该功能还没实现，epub、mobi等文档，现在还是暂时不能在线阅读

全文搜索

全文搜索功能，之前是使用coreseek开发实现了这个功能的，但是现在coreseek的官网都已经挂了...打算用elasticsearch重新实现这个功能。

文档采集功能【TODO】

建站初期，站点内容的填充，是一个大难点。

然而，GitBook、ReadTheDoc等站点上，就有一大堆的开源技术文档，提供mobi、pdf、epub离线文档下载。

初略统计了一下，GitBook有10多万文档，按可用文档为5万估算，每份文档，提供3种格式的下载，光从gitbook采集文档，做成文库，就有15万多的文档了。

然后，你再借助下搜索引擎，搜索filetype:文档格式 + 搜索关键字，如filetype:pdf 入门教程，你就会发现惊喜！不信，你试着赋值下面两个链接地址在浏览器打开：

https://cn.bing.com/search?q=filetype%3apdf+%E5%85%A5%E9%97%A8%E6%95%99%E7%A8%8B&first=11

https://www.sogou.com/web?query=filetype%3Apdf+%E5%85%A5%E9%97%A8%E6%95%99%E7%A8%8B

如果再爬其他文档，一年之内，单枪匹马搞个上百万文档的文库站点，应该不是个事儿。

不过，现在综合类的文库站点，如百度文库等已经做起来了，如果你打算做综合类的文库站点，还是不现实，因为空间太小了.

但是，你可以做专注于某一个方向的文库站点，比如课后习题答案文库站点、IT行业文库站点、教育类文库站点等，专注于一个行业领域方向，还是有很大成长空间的。就好比图片站点，现在很多搜索引擎都能搜索图片，但是Pinterest、花瓣网等还不是做起来了吗？

给你提供了程序，还给你提供了思路，给个star鼓励一下？

积分功能

用户签到、上传分享文档，获得积分奖励；用户下载文档，需要消耗积分

阅读文档水印功能

在提供阅读的svg文件上添加水印

页面一览

没有哪一个时代不是看脸的...

• 首页

• 文档阅读页

• 用户中心

• 管理后台

• 搜索结果

使用教程

当运行程序的时候，程序会自动初始化数据，默认的初始管理员账号密码均是admin

但是由于环境依赖安装问题，所以有必要整理一个使用教程处理，使用教程放在书栈网(BookStack)上，教程地址：https://www.bookstack.cn/books/dochub

演示站点

目前还没有搭建演示站点，争取在这周内搭建出来。

不过，在这之前，你可以访问IT文库(http://wenku.it)看网站效果，但是由于这个站点，在进行迁移的时候，部分依赖没配置好，所以上传的office、PDF等文档，暂时不支持预览，搜索功能也用不了。

所以，请耐心等待，届时搭建好了演示站点，会把演示站点的管理员账号密码放出来，以便体验使用。

文库模板

DocHub文库的前端模板，包括PC模板和移动端模板，也会放出来。但是，模板可能跟套在程序上的有差距，毕竟在开发的时候有对页面做了一些调整。

PC端模板

• GitHub: https://github.com/truthhun/DocHubTemplate4PC

• Gitee: https://gitee.com/truthhun/DocHubTemplate4PC

移动端模板

• GitHub: https://github.com/truthhun/DocHubTemplate4Mobile

• Gitee: https://gitee.com/truthhun/DocHubTemplate4Mobile