整套解决方案:BookStack: BookStack,基于MinDoc
优采云 发布时间: 2022-11-01 23:15整套解决方案:BookStack: BookStack,基于MinDoc
BookStack 支持手机APP BookChatApp 开源地址
BookChatApp下载体验地址
目录:
BookStack 简介
BookStack,分享知识,分享智慧!知识,因为分享,流传久远!
BookStack 基于Mindoc 开发,为运营而生。
在开发的过程中,添加和删除了一些东西,不再兼容MinDoc(毕竟数据表结构、字段、索引有些不同),只支持markdown编辑器。
开源
两年前还在做PHP开发的时候,无意中遇到了Gitbook、Kanyun、readthedoc。
那个时候想自己开发一个,但是后来没时间,也没有那个时候的技术积累。
后来学了Go语言,无意中遇到了Mindoc,然后我们公司(Nuggets Quantization)也正好让我开发公司官网和文档系统,然后我做了Mindoc的二次开发。
本来我是不想开源的,因为自己写代码的时候,自己写写写,代码改改改,然后代码就乱了。我害怕开源会丢人。但进入IT行业三年多以来,也受益于各种开源书籍和开源组件,所以最终决定开源BookStack。
它肯定还有不足之处。如果您在使用过程中遇到问题,欢迎反馈。
源代码托管:
QQ交流群
为方便相互学习交流,建立了QQ群。请备注从 BookStack 添加组
QQ交流群:457803862(猿军团)
同时需要注意的是,本群是学习交流群。如果是程序相关的问题,请直接提交issues。不接受邮件帮助、微信帮助和QQ私信帮助。
BookStack 安装手册:
站点演示站点
服务器资源有限,演示站点不再可用
官方网站
书库网络:
更新、维护和升级功能并突出显示图书类别(V1.2+)
用户就像你的老板,他不知道自己需要什么,但他知道自己不需要什么……
用户主页(V1.2+)
在用户首页,展示用户分享的书籍、粉丝、关注和手册,增加用户之间的互动
markdown书籍一键导入
这个功能相信是很多人的最爱。目前此功能仅对管理员可用。
根据实测,已经完美支持了各种姿势书写的markdown书籍的文档导入,文档之间的链接和文档中的图片链接都可以很好的处理。
一键拉出markdown书籍
看到有很多书籍有GitHub、Gitee等开源文档,但是把markdown内容一一复制粘贴在里面是不现实的。所以,我做了这个一键拉取功能。目前只有管理员有拉取权限,不向普通用户开放。要体验此功能,请使用管理员帐户登录演示站点体验。用法很简单。比如我们拉取beego书的时候,创建好书后,直接点击“拉书”,粘贴为“ ”,然后它会自动为你拉取上面所有的markdown文档,并录入数据库。同时,图片也会自动更新到OSS。
根据实测,完美支持各种姿势书写的markdown书籍的拉取,能够很好的处理文档之间的链接和文档中的图片链接。
目前支持 Git Clone 导入书籍
生成和导出离线文档,例如 PDF、epub、mobi 等。
这需要安装和配置 calibre。我特地把calibre的使用封装成一个工具,编译成二进制,源码,程序和使用地址:在BookStack中,已经引入了这个包。使用时点击“生成下载文件”
文档排序和文档的批量创建
很多时候,我们在写书的时候,习惯于先创建书的章节目录结构,再慢慢写内容。但是,书的文档少的时候,一个一个地创建就好,但是文档数量多的时候,简直是自取其辱。排序的时候,一一拖拽很麻烦。现在,这个问题已经解决了。如下:
* [第0章. 前言]($ch0.md)
* [第1章. 修订记录]($ch1.md)
* [第2章. 如何贡献]($ch2.md)
* [第3章. Docker 简介]($ch3.md)
* [什么是 Docker]($ch3.1.md)
* [为什么要用 Docker]($ch3.2.md)
* [第4章. 基本概念]($ch4.md)
<p>
* [镜像]($ch4.1.md)
* [容器]($ch4.2.md)
* [仓库]($ch4.3.md)</p>
注意:
必须有,这是告诉程序我的summary.md文件是用来创建文件和排序文件的。当然,排序完成后,当前页面会被刷新并移除。有时,第一次排序不成功,再添加这个标签,程序会自动为你重新排序。我自己经常使用这种方法批量创建文档,批量修改文档的标题。
在文档之间跳转
你有一本书有很多文件。一个文档的文档 ID 称为 readme.md,另一个文档的文档 ID 称为 quickstart.md。如何在两个文件之间跳转?如果知道站点的路由规则,就可以轻松上链,但是每次都这么写,实在是太麻烦了。经常自己写文件,看腻了,再想办法。如下:我从readme.md跳转到quickstart.md,readme.md中的内容是这样写的:
[快速开始]($quickstart.md)
跳到 quickstart.md 中的锚点怎么样?那将是这样写的:
[快速开始-步骤三]($quickstart.md#step3)
那么,文档发布的时候,文档会根据路由规则和你的文档ID生成一个链接(因为是后端处理的,所以在编辑文档的时候,前端显示的预览内容不能暂时跳了。的)。那么问题来了,我的书中文档越来越多,我怎么知道我要链接的文档的文档ID呢?不用担心,markdown 编辑器的左侧,括号中的红色文本显示了您的文档 ID。
采集特点
看到一个很不错的文章,但是文章里面有代码片段和图片,手工复制的,格式都乱了,所以相信采集函数会成为你所需要的。采集函数,在markdown编辑器的功能栏上,没错,就是瓢虫图标,就是bug,因为找不到蜘蛛图标……
功能如下图所示。具体体验请到demo现场体验。
搜索引擎优化
后台管理,个性化您的SEO关键词;并且在SEO管理中,可以更新站点地图(没有自动更新站点地图的程序)
版本控制
MinDoc 本身之前有版本控制,但版本控制文档的内容都存储在数据库中。如果由于频繁修改而导致修改历史过多,可能会导致数据库不堪重负。当时没有很好的解决方案,所以去掉了这个功能。
目前添加了这个功能,因为这个功能很流行,所以加回来了。但是,版本控制的内容不再存储在数据库中,而是以文件的形式存储在本地或云存储中。
该功能在管理后台->配置管理中启用
更美观简洁的页面布局和更完善的移动兼容性
是时候看看了...
成熟的解决方案:WordPress采集
WordPress采集
WordPress采集,通过在全网对应的关键词中搜索文章,进行全网文章采集。可以快速大量填充网站的内容,丰富网站的文章数据库。这为网站增加收录提供了基本条件,可以为网站关键词的排名提供相应的帮助,所以内容建设是网站的第一点> ,而WordPress采集是为了帮助站长优化网站的文章内容,增加网站的文章内容数量。
WordPress的文章采集会自动修改标题和内容,目的是为了减少在搜索引擎中的重复,修改后不能将原文的意思改得面目全非,这样它就会丢失。以伪原创的初衷,内容的修改和写作一定要有一个中心思想,内容不能再更改。文章 更改标题以匹配文章 的内容和用户的阅读习惯,从而达到伪原创 意想不到的效果。
WordPress采集 的完整单词不能拆分为锚文本。例如,有些词已经是一个名字。虽然也可以进行切分,但是切分后就失去了原来的意义,所以不能切分。有很多时间我们都喜欢拆分完整的单词,所以这是不正确的。如果一个页面上有多个关键词,则只有一个链接是第一个。当一个页面出现多个关键词时,只需要一个链接。链接多个链接只会浪费资源,链接太多也会被认为是过度优化导致网站降低权重,得不偿失。
WordPress采集自创功能第一段:自动写文章首页的开场介绍,文章首页的介绍前120字可以打一个在被搜索引擎搜索到的页面中起到很大的作用收录,如果你有精力看文章,知道大意的可以写开篇介绍,也可以自己加入网站 的 关键词 在这里。在文本中插入锚文本链接:你应该知道锚文本是什么,它的作用可以帮助提高相关的关键词排名。但是,添加锚文本必须对用户有用。如果没用,最好不要添加。
WordPress采集自动添加图片或视频:文章带有图片可以更好的说明问题,容易抓住用户的注意力,增加页面停留时间,但是添加图片是为了表达和解决用户问题的依据。虽然目前大部分搜索引擎无法读取图片的内容,但是图片中的alt属性是可以识别的,合适的图片会让搜索引擎焕然一新。我认为您的 文章 是高质量的新 文章,当然还有视频添加。
WordPress采集 然后按段落替换:即相互替换内容的顺序,但注意不要影响原文的阅读。但是,这种方法并不适合所有人,不应该使用逻辑 文章。结尾自创:把整个文章做个总结,看起来比较连贯。其实对于搜索引擎优化来说,不仅是这些内容,小技巧也是要注意的,所以不仅要能做到,而且要能思考,能从别人那里推断,才能更快的提高和进步。