手把手教你搭建自己的Raneto知识库（二）

作者：悠悠做神仙

来源：恒生LIGHT云社区

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

下面，给大家介绍一下，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
• 知识库主名（项目组或公司名）
• 登录界面的显示和图标
• 网站的权限显示修改
• 汉化显示&文章编辑后的时间显示

浏览器图标：

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

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

（2）将图标上传到服务器，以下地址：./Raneto-0.16.5/themes/default/public/。

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

./Raneto-0.16.5/app/index.js

启动后，可以看到效果（比较小哈）：

浏览器窗口的title：

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

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

登录界面的显示和图标：

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

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

网站的权限显示修改：

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

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

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

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

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

3、创建自己的文库

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

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

栏目：

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

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

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

文章：

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

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

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

知识库展示：

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

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

看效果：

4、权限管理

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

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

5、中文搜索

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

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

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

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

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

---

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

看完记得一键三连哈（点赞、收藏、转发）！

感谢大家支持，我是悠悠做神仙！