加入CODE CHINA

· 不限速    · 不限空间    · 不限人数    · 私仓免费

免费加入
    README.md

    BookStack 配套手机APP BookChatApp 开源地址

    BookChatApp下载体验地址

    目录:

    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向我反馈意见和建议

    支付宝打赏赞助

    支付宝打赏赞助

    微信打赏赞助

    微信打赏赞助

    项目简介

    🚀 Github 镜像仓库 🚀

    源项目地址

    https://github.com/TruthHun/BookStack

    发行版本 20

    BookStack v2.9 发布,提升程序稳定性

    全部发行版

    贡献者 7

    开发语言

    • Go 86.7 %
    • HTML 6.5 %
    • JavaScript 6.4 %
    • CSS 0.2 %
    • PHP 0.2 %