Skip to content
BookStack,基于MinDoc,使用Beego开发的在线文档管理系统,功能类似Gitbook和看云。
Go JavaScript HTML CSS PHP Shell
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github issue提交模板 Mar 2, 2018
commands 管理员初始密码调整为 admin888 Aug 14, 2019
conf 配置文件注释 Aug 12, 2019
controllers 小程序富文本标签处理 Aug 14, 2019
dictionary 假装第一次提交 Feb 22, 2018
graphics 代码优化 Sep 28, 2018
lib/time 假装第一次提交 Feb 22, 2018
models 书籍收录管理 Aug 11, 2019
oauth 微信小程序登录 Jul 16, 2019
routers 书籍收录管理 Aug 11, 2019
static
utils 采集时间调长 Aug 12, 2019
vendor 微信小程序登录 Jul 16, 2019
views 书籍收录管理 Aug 11, 2019
.gitattributes 假装第一次提交 Feb 22, 2018
.gitignore 管理后台可根据用户名、昵称、邮箱和角色对用户进行检索和管理 Aug 10, 2019
API.md 介绍页内容错误修正 Aug 10, 2019
Dockerfile 增加Dockerfile Jun 26, 2018
LICENSE 合并冲突文件 Feb 25, 2018
LICENSE.md 假装第一次提交 Feb 22, 2018
README.md README Aug 12, 2019
build-linux.sh shell Jun 9, 2019
change.md README Aug 12, 2019
crawl.js 采集超时时间 Aug 14, 2019
favicon.ico 假装第一次提交 Feb 22, 2018
main.go 限制API请求接口 Jul 4, 2019

README.md

BookStack 配套微信小程序BookChat开源地址

微信扫描小程序码体验

BookChat

目录:

BookStack 简介

BookStack,分享知识,共享智慧!知识,因分享,传承久远!

BookStack是基于Mindoc开发的,为运营而生。

在开发的过程中,增加和移除了一些东西,目前已经不兼容MinDoc了(毕竟数据表结构、字段、索引都有了一些不同),同时只支持markdown编辑器。

开源

两年前还在做PHP开发的时候,无意间遇到了Gitbook,以及看云,还有readthedoc。

当时想着自己也开发一套,但是后来没时间,当时也没那个技术积累。

后来学了Go语言,又在无意间遇到了Mindoc,然后我们公司(掘金量化 )也恰巧让我开发公司官网和文档系统,然后我就对Mindoc做了二次开发。

本来是不想开源的,因为自己写代码的时候,写着写着,代码改来改去,然后代码就乱七八糟了,怕开源出来丢人现眼。但是踏入IT行业三年多时间以来,自身也受益于各种开源项目和开源组件,所以最终还是决定将BookStack开源出来。

其中肯定还是有不足的地方,大家在使用的过程中,遇到问题,欢迎反馈。

源码托管:

QQ交流群

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

QQ交流群:457803862(猿军团)

同时要说明的是,该群是一个学习交流群,如果是程序相关问题,请直接提交issues,不接受邮件求助、微信求助和QQ私信求助

BookStack 安装使用手册:https://www.bookstack.cn/books/help

站点

演示站点

服务器资源有限,不再提供演示站点

正式站点

书栈网https://www.bookstack.cn

更新、维护和升级

  • 程序下载与升级日志,看这里--> Release

功能与亮点

书籍分类(V1.2 +)

用户就像你的老板,他不知道自己需要什么,但是他知道自己不需要什么...

用户主页(V1.2 +)

在用户主页,展示用户分享的书籍、粉丝、关注和手册,增加用户间的互动

一键导入markdown项目

这个功能,相信是很多人的最爱了。目前这个功能仅对管理员开放。

经实测,目前已完美支持各种姿势写作的markdown项目的文档导入,能很好地处理文档间的链接以及文档中的图片链接

一键导入项目

一键拉取markdown项目

看到GitHub、Gitee等有很多开源文档的项目,但是一个一个去拷贝粘贴里面的markdown内容不现实。于是,做了这个一键拉取的功能。 目前只有管理员才有权限拉取,并没有对普通用户开放。要体验这个功能,请用管理员账号登录演示站点体验。 用法很简单,比如我们拉取beego的文档项目,在创建项目后,直接点击"拉取项目",粘贴如" https://github.com/beego/beedoc/archive/master.zip ",然后就会自动帮你拉取上面的所有markdown文档并录入数据库,同时图片也会自动帮你更新到OSS。 拉取项目

经实测,目前已完美支持各种姿势写作的markdown项目的拉取,能很好地处理文档间的链接以及文档中的图片链接

目前已支持Git Clone导入项目

生成和导出PDF、epub、mobi等离线文档

这个需要安装和配置calibre。 我将calibre的使用专门封装成了一个工具,并编译成了二进制,源码、程序和使用说地址:https://github.com/TruthHun/converter 在BookStack中,已经引入这个包了。使用的时候,点击"生成下载文档"即可

文档排序和批量创建文档

很多时候,我们在写作文档项目的时候,会习惯地先把文档项目的章节目录结构创建出来,然后再慢慢写内容。 但是,文档项目中的文档少的时候,一个个去创建倒没什么,但是文档数量多了之后,简直就是虐待自己,排序的时候还要一个一个去拖拽进行排序,很麻烦。现在,这个问题已经解决了。如下:

  • 在文档项目中,创建一个文档标识为summary.md的文档(大小写不敏感)
  • 在文档中,填充无序列表的markdown内容,如:
<bookstack-summary></bookstack-summary>
* [第0章. 前言]($ch0.md)
* [第1章. 修订记录]($ch1.md)
* [第2章. 如何贡献]($ch2.md)
* [第3章. Docker 简介]($ch3.md)
    * [什么是 Docker]($ch3.1.md)
    * [为什么要用 Docker]($ch3.2.md)
* [第4章. 基本概念]($ch4.md)
    * [镜像]($ch4.1.md)
    * [容器]($ch4.2.md)
    * [仓库]($ch4.3.md)
  • 然后保存。保存成功之后,程序会帮你创建如"第0章. 前言",并把文档标识设置为"ch0.md",同时目录结构还按照你的这个来调整和排序。

注意:

必须要有<bookstack-summary></bookstack-summary>,这样是为了告诉程序,我这个summary.md的文档,是用来创建文档和对文档进行排序的。当然,排序完成之后,当前页面会刷新一遍,并且把<bookstack-summary></bookstack-summary>移除了。有时候,第一次排序并没有排序成功,再添加一次这个标签,程序会自动帮你再排序一次。 我自己也常用这种方式批量创建文档以及批量修改文档的标题

文档间的跳转

你在一个文档项目中会有很多文档,其中一个文档的文档标识叫readme.md,另外一个文档的文档标识叫quickstart.md,两个文档间如何跳转呢? 如果你知道站点的路由规则,倒是可以轻松链过去,但是,每次都要这样写,真的很麻烦。自己也经常写文档,简直受够了,然后想到了一个办法。如下: 我从readme.md跳转到quickstart.md,在readme.md中的内容这样写:

[快速开始]($quickstart.md)

如果跳转到quickstart.md的某个锚点呢?那就像下面这样写:

[快速开始-步骤三]($quickstart.md#step3)

好了,在发布文档的时候,文档就会根据路由规则以及你的文档标识去生成链接了(由于是后端去处理,所以在编辑文档的时候,前端展示的预览内容,暂时是无法跳转的)。 那么,问题就来了,我文档项目里面的文档越来越多,我怎么知道我要链接的那个文档的文档标识呢?不用担心,在markdown编辑器的左侧,括号里面的红色文字显示的就是你的文档标识。

文档标识

采集功能

看到一篇很好的文章,但是文章里面有代码段、有图片,手工复制过来,格式全乱了,所以,相信采集功能,会是你需要的。采集功能,在markdown编辑器的功能栏上面,对,就是那个瓢虫图标,就是那个Bug,因为我找不到蜘蛛的图标...

功能见下图,具体体验,请到演示站点体验。

采集

SEO

后台管理,个性化定制你的SEO关键字;并且在SEO管理这里,可以更新站点sitemap(暂时没做程序定时自动更新sitemap)

版本控制

MinDoc之前本身就有版本控制的,但是版本控制的文档内容全都存在数据库中,如果修改频繁而导致修改历史过多的话,数据库可能会被撑爆。当时没有好的解决办法,所以将该功能移除了。

目前加上该功能,是因为这个功能呼声很高,所以加回来了。但是版本控制的内容不再存储到数据库中,而是以文件的形式存储到本地或者是云存储上。

功能在管理后台->配置管理中进行开启

更美观、简洁的页面布局和更为完善的移动端兼容

这是个看脸的时代...

首页

首页

介绍页

介绍页

内容阅读页

内容阅读页

个人项目页

个人项目页

手机端首页

个人项目页

TODO

  • 文档阅读书签
  • 微信第三方登录
  • 微博第三方登录
  • 收费下载和收费阅读(放在最后开发)
  • 签到功能
  • 增加广告位和广告管理
  • 积分功能
  • 除了数据库配置项外,其余配置项尽可能在管理后台可配置
  • 增强搜索功能,上elasticsearch
  • 简化程序部署,上docker
  • 微信小程序(放到2.x版本开发)
  • 版本管理 ?(待找到更优解决方案了再实现)
  • 使用weex开发手机端APP ? (vue.js熟练了再抽时间实现)
  • 使用electron开发桌面端,实现类似网易有道云笔记的功能 ? (vue.js熟练了再抽时间实现)

Tips:

更多功能,期待您的想象力,然后通过issue向我提出来,或者到HC-CMS(http://www.hc-cms.com) 发帖提出

安装与使用

为了方便,安装和使用教程,请移步到这里:http://www.bookstack.cn/read/help/Ubuntu.md

目前只写了Ubuntu下的安装教程,Windows下的安装和使用教程,暂时没时间

有两个模板文件,需要手动修改下: /views/widgets/pdf_footer.html 导出PDF文档时,pdf的footer显示内容 /views/document/tpl_statement.html 修改成你想要的文案内容或者删除该文件。如果保留该文件,必须要有h1标签,因为程序要提取你的h1标签用于导出文档的目录生成

默认的管理员账号密码均是admin

v1.0升级到v1.1,直接下载对应系统的发行版本,然后根据配置文件的配置提示修改配置文件,然后覆盖升级即可。本次升级,没有改动数据库。

关于二次开发,请看这个issue README.md中能否添源码编译说明

关于本人

2014年7月本科"毕业"踏入IT行业;Web全栈工程师;什么都懂一点,什么都不精通。

赞助我

如果我的努力值得你的肯定,请赞助我,让我在开源的路上,做更好,走更远。 赞助我的方式包括:支付宝打赏微信打赏给BookStack一个star向我反馈意见和建议

支付宝打赏赞助

支付宝打赏赞助

微信打赏赞助

微信打赏赞助

You can’t perform that action at this time.