>作者：悠悠做神仙
>
>来源：[恒生LIGHT云社区](https://developer.hs.net/thread/1139 "恒生LIGHT云社区")

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

![啓動.jpg](https://developer.hs.net/storage/attachments/2021/07/08/8dtG6JlNmlMTR6cY0CPAo3wiEg00NmeXFyLJKjo1_thumb.jpg "2068")

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

![2-1.png](https://developer.hs.net/storage/attachments/2021/07/12/3NDk3xbodEFC1xAGlz6ACnTTcpH9YQiKVvoCAuRN_thumb.png "2106")

![2-2.jpg](https://developer.hs.net/storage/attachments/2021/07/12/wyufQLaVO03WRIqj2F3uGEnzHZDmLxQtuuQeCOUS_thumb.jpg "2107")

![2-3.jpg](https://developer.hs.net/storage/attachments/2021/07/12/cE3LgPf7UD4SvVN9jGE4uqtV6qwq4GgLLgFxefVv_thumb.jpg "2108")

**浏览器图标：**

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

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

![云 (1).png](https://developer.hs.net/storage/attachments/2021/07/12/8LwzENRzZ1rSoXQ0rrSxGuIGFofh9ggzZCUN0dzL_thumb.png "2109")

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

![2-4.jpg](https://developer.hs.net/storage/attachments/2021/07/12/1GlNdHNyxPIYRRkxzwmSjOvMa1lQwkcUnDpwwcfX_thumb.jpg "2110")

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

`./Raneto-0.16.5/app/index.js`

![2-5.jpg](https://developer.hs.net/storage/attachments/2021/07/12/CCjod75MEHCMWqkvtmHfDtiaSCXd2s7aTwdrgcLJ_thumb.jpg "2111")

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

![3.jpg](https://developer.hs.net/storage/attachments/2021/07/12/wyOOHxlfzjqdoSNaazsdBXOHilNOh2h8TciqtRRd_thumb.jpg "2112")

**浏览器窗口的title：**

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

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

![3-1.jpg](https://developer.hs.net/storage/attachments/2021/07/12/A2JmX8I3wCXODkxm1e2Zi1qZQTwBrVJN7mRwhFOC_thumb.jpg "2113")

![3-2.jpg](https://developer.hs.net/storage/attachments/2021/07/12/fiaHOgkpitvqcaeVzUIbgC6v2wEXR6ve9lkgUfAO_thumb.jpg "2114")

**登录界面的显示和图标：**

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

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

![3-3.jpg](https://developer.hs.net/storage/attachments/2021/07/12/m8eNeiHMCIUEkQVi0VzsBOALwOJGgUvN61mxW7xU_thumb.jpg "2115")

![3-5.jpg](https://developer.hs.net/storage/attachments/2021/07/12/X1lXLslyETcfZpj4xKgoR8fNDX9eP2Zo5wBipVcu_thumb.jpg "2116")

![3-6.jpg](https://developer.hs.net/storage/attachments/2021/07/12/4qfBxABmnxuQuVWhdHULsMRBFcRYjkm7rNN4bfgp_thumb.jpg "2117")

**网站的权限显示修改：**

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

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

![4.jpg](https://developer.hs.net/storage/attachments/2021/07/12/N03f2lT1JzoRa3PalHvt6L4xdbIIQDKeCb9J28iX_thumb.jpg "2118")

![4-1.jpg](https://developer.hs.net/storage/attachments/2021/07/12/a7tJy6RRkR5JBSAtOL6O686sg5uhx0zWbWaziCfJ_thumb.jpg "2119")

![3-9.jpg](https://developer.hs.net/storage/attachments/2021/07/12/xMwrlJo4ZDRiq0F6KXK7Tpb0VxeVg6KhHIqvCDEE_thumb.jpg "2121")

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

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

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

![4-5.jpg](https://developer.hs.net/storage/attachments/2021/07/12/yJ2NZy2XS8I5mvFU7OBQl3WaWK2pf5m7DDOzerRU_thumb.jpg "2122")

![4-6.jpg](https://developer.hs.net/storage/attachments/2021/07/12/LCCxDiyFuBZkK5EfW7HP3OO3NGX2rXgfRVgiRTse_thumb.jpg "2123")

![4-7.jpg](https://developer.hs.net/storage/attachments/2021/07/12/fKJd83GIlraRdprVw0wKrNhKVCP2xJ1a56WKGrNx_thumb.jpg "2124")

![4-8.jpg](https://developer.hs.net/storage/attachments/2021/07/12/Q4f7LMXHVjYxjqCnumcsnixLWbnTySWlx6uNzq64_thumb.jpg "2125")

![4-9.jpg](https://developer.hs.net/storage/attachments/2021/07/12/j7iQnEvaJ5Cz3hwz0yV6ZDpZtbwTFjz7XiIr0338_thumb.jpg "2126")

### 3、创建自己的文库

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

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

![5-1.jpg](https://developer.hs.net/storage/attachments/2021/07/12/mKmb7q0C5BXsNgtRaHZ5QLw6YeSorjZovLgWRVCq_thumb.jpg "2127")

**栏目：**

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

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

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

![6.jpg](https://developer.hs.net/storage/attachments/2021/07/12/TBoAsjj9uKgRoTojuUMLaiX5rNmbpVLK95xK7jy4_thumb.jpg "2128")

![8-1.jpg](https://developer.hs.net/storage/attachments/2021/07/12/60nnWEGkc3Ebamo9eYpUk4oK2bLem6QRzmqg8Alr_thumb.jpg "2129")

![8-2.jpg](https://developer.hs.net/storage/attachments/2021/07/12/aOv0QcnPGR2UGx9RW5ZYb99MPcorN1TayDkLaUBm_thumb.jpg "2131")

![8-3.jpg](https://developer.hs.net/storage/attachments/2021/07/12/iFddT8vjFhk3UtE4eUIkJqBtTeYusWyCl3iBx9CK_thumb.jpg "2132")

**文章：**

创建.md结尾的文件，然后按照[markdown](https://daringfireball.net/projects/markdown/syntax#list)语法来写。

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

![8.jpg](https://developer.hs.net/storage/attachments/2021/07/12/s0fBR6hyt2421Ci2p339TGYSU9dL08PdoMBGOpHK_thumb.jpg "2130")

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

**知识库展示：**

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

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

![9.jpg](https://developer.hs.net/storage/attachments/2021/07/12/YZ5LQS1VFUJdutvYa5NsX1Gs38qhRo4rmL4vDD4s_thumb.jpg "2133")

看效果：

![9-1.jpg](https://developer.hs.net/storage/attachments/2021/07/12/MqknPLz6uckBRs9zRO3yBh9Ufmu8q45waH055mle_thumb.jpg "2134")

![9-2.jpg](https://developer.hs.net/storage/attachments/2021/07/12/VEFcbuXrvs3eKGvfmrHiRcnd5rKL5NdEETiGuDTd_thumb.jpg "2135")

### 4、权限管理

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

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

![10.jpg](https://developer.hs.net/storage/attachments/2021/07/12/qPJTU4hFUgnyoLYn8Zft8o4ntH8ez2ybhkVX25EB_thumb.jpg "2136")

### 5、中文搜索

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

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

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

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

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

---

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

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

![](https://img1.baidu.com/it/u=3164470878,1382098835&fm=26&fmt=auto&gp=0.jpg)

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

![](https://img2.baidu.com/it/u=1073611648,831330028&fm=11&fmt=auto&gp=0.jpg)

ITPub博客

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

最新文章