手把手教你搭建自己的Raneto知识库(二)

恒生LIGHT云社区 -
手把手教你搭建自己的Raneto知识库(二)

作者:悠悠做神仙

来源:恒生LIGHT云社区

上一篇 手把手教你搭建自己的Raneto知识库(一)主要介绍Raneto的依赖环境安装(Node.js)、Node.js安装过程中遇到的一些问题、Raneto下载安装等,所以现在启动Raneto,已经可以看到默认模板的内容了。

 title=

下面,给大家介绍一下,Raneto的使用以及做一些个性化的配置等。

1、目录结构

切换到安装文件路径下,可以看到有以下文件:

[root@yyzsx Raneto-0.16.5]# ll
总用量 316
drwxrwxr-x 7 root root   4096 1月  20 2019 app
drwxrwxr-x 2 root root   4096 1月  20 2019 bin
-rw-rw-r-- 1 root root    659 1月  20 2019 CONTRIBUTE.md
-rw-rw-r-- 1 root root    181 1月  20 2019 Dockerfile
drwxrwxr-x 3 root root   4096 1月  20 2019 example
-rw-rw-r-- 1 root root    641 1月  20 2019 gulpfile.js
-rw-rw-r-- 1 root root   8506 1月  20 2019 HISTORY.md
-rw-rw-r-- 1 root root   1083 1月  20 2019 LICENSE
drwxrwxr-x 2 root root   4096 1月  20 2019 logo
-rw-rw-r-- 1 root root    775 1月  20 2019 Makefile
-rw-rw-r-- 1 root root   2439 1月  20 2019 package.json
-rw-rw-r-- 1 root root 255479 1月  20 2019 package-lock.json
-rw-rw-r-- 1 root root   1917 1月  20 2019 README.md
drwxrwxr-x 3 root root   4096 1月  20 2019 test
drwxrwxr-x 3 root root   4096 1月  20 2019 themes
[root@yyzsx Raneto-0.16.5]#

关于文件这里大体说一下,主要的几个文件夹和文件:

文件夹:

app:一些主要的js文件,index.js主页,还有core下包括一些搜索用的js文件等。bin:下面就一个raneto文件,主要是一些索引配置,后面会涉及到这个文件修改。example:默认的文章结构等,我们启动后看到的一些资料都是来自于这个文件夹。logo:一些log图片存放的位置。test:一些文件,有点类似example里的,暂时用不到。themes:存放一些主题网页,还有后面写文章的一些图片存放的位置。

文件:

package.json:一个json文件,主要是给bin目录下的raneto文件使用。

以及其他文件。

2、个性化配置

该部分主要的配置,是修改一些默认的配置,主要包括以下几个方面:

浏览器的小图标浏览器窗口的title知识库主名(项目组或公司名)登录界面的显示和图标网站的权限显示修改汉化显示&文章编辑后的时间显示

 title=

 title=

 title=

浏览器图标:

默认图标存放地址:./Raneto-0.16.5/themes/default/public/favicon.ico

(1)首先准备一个有代表的ico格式的图标,例如,我是悠悠做神仙,那就找一朵云吧。

 title=

(2)将图标上传到服务器,以下地址:./Raneto-0.16.5/themes/default/public/

 title=

(3)修改加载图标的参数(如果你的图标也叫 favicon.ico,那就不用改了)。

./Raneto-0.16.5/app/index.js

 title=

启动后,可以看到效果(比较小哈):

 title=

浏览器窗口的title:

该部分主要是文库里面的一个配置文件,后面创建文库的时候还会说,这里先用默认的例子库来演示。

需要修改的文件路径:./Raneto-0.16.5_online/example/config.default.js

 title=

 title=

登录界面的显示和图标:

修改文件的路径:./Raneto-0.16.5/themes/default/templates/login.html

本部分修改后,需要重启服务生效。

 title=

 title=

 title=

网站的权限显示修改:

该部分主要是文库里面的一个配置文件,后面创建文库的时候还会说,这里先用默认的例子库来演示。

需要修改的文件路径:./Raneto-0.16.5_online/example/config.default.js

 title=

 title=

 title=

汉化显示&文章编辑后的时间显示:

该部分主要是文库里面的一个配置文件,后面创建文库的时候还会说,这里先用默认的例子库来演示。

需要修改的文件路径:./Raneto-0.16.5_online/example/config.default.js

 title=

 title=

 title=

 title=

 title=

3、创建自己的文库

默认一个知识库叫:example,我们可以根据自己的项目重现创建一个文件夹,例如:YyzsxWiki。

./Raneto-0.16.5_online/example文件下的 .js.json文件复制到 YyzsxWiki下,然后在 YyzsxWiki下创建一个名叫 content的文件夹。

 title=

栏目:

本身会默认有一个【主要文章】的默认栏目。在content文件夹里,与那些栏目的文件夹同级。

然后,content下,是所有文件的存放。

content下的文件名一般是栏目名称,栏目下是.md文件和sort文件(文件里面只有一个数字),sort是栏目的一个排序。

 title=

 title=

 title=

 title=

文章:

创建.md结尾的文件,然后按照markdown语法来写。

其中文档结构(文章标题,和一个排序的参数。):

 title=

注意:如果需要图片,需要先上传到 ./Raneto-0.16.5/themes/default/public/images 路径下,然后用markdown语法进行引用即可。

知识库展示:

将默认的仓库索引,换成自己的仓库。

需要修改文件的路径:./Raneto-0.16.5/package.json

 title=

看效果:

 title=

 title=

4、权限管理

如果需要在线编辑以及一些浏览限制,可以修改配置文件。

需要修改文件路径:./Raneto-0.16.5_online/YyzsxWiki/config.default.js

 title=

5、中文搜索

到这里几乎就大功告成了,但是,有一点问题,就是不支持中文搜索。

网上找到一些方法,但是往往在安装 nodejieba的时候各种报错,后来虽然报错解决了,但是最后又卡到缺少一个so依赖,又告诉我需要升级gcc,过于曲折,目前这部分没有成功过。:kelian:

但是,我们也是有小敲门的。那就是可以把文章标题内容部分,增加一些特有的文章缩写。

比如:《jenkins异常排错参考》一文,可以在描述中增加内容:jenkins等,也是一个思路。

后续如果成功了,回来更新。

到此,我想大家已经搭建好自己的知识库了!其实,本文介绍的都是主要的一些配置,一些其他的配置可以参考官网介绍,以及查看example里面的一些配置!

看完记得一键三连哈(点赞、收藏、转发)!

感谢大家支持,我是悠悠做神仙!

特别申明:本文内容来源网络,版权归原作者所有,如有侵权请立即与我们联系(cy198701067573@163.com),我们将及时处理。

Tags 标签

node.jsranetomarkdown

扩展阅读

加个好友,技术交流

1628738909466805.jpg