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

作者：悠悠做神仙
来源：恒生LIGHT云社区

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

文章图片

下面，给大家介绍一下，Raneto的使用以及做一些个性化的配置等。
1、目录结构
切换到安装文件路径下，可以看到有以下文件：

[root@yyzsx Raneto-0.16.5]# ll 总用量 316 drwxrwxr-x 7 root root4096 1月20 2019 app drwxrwxr-x 2 root root4096 1月20 2019 bin -rw-rw-r-- 1 root root659 1月20 2019 CONTRIBUTE.md -rw-rw-r-- 1 root root181 1月20 2019 Dockerfile drwxrwxr-x 3 root root4096 1月20 2019 example -rw-rw-r-- 1 root root641 1月20 2019 gulpfile.js -rw-rw-r-- 1 root root8506 1月20 2019 HISTORY.md -rw-rw-r-- 1 root root1083 1月20 2019 LICENSE drwxrwxr-x 2 root root4096 1月20 2019 logo -rw-rw-r-- 1 root root775 1月20 2019 Makefile -rw-rw-r-- 1 root root2439 1月20 2019 package.json -rw-rw-r-- 1 root root 255479 1月20 2019 package-lock.json -rw-rw-r-- 1 root root1917 1月20 2019 README.md drwxrwxr-x 3 root root4096 1月20 2019 test drwxrwxr-x 3 root root4096 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里面的一些配置！
看完记得一键三连哈（点赞、收藏、转发）！

感谢大家支持，我是悠悠做神仙！
【手把手教你搭建自己的Raneto知识库（二）】