>作者：悠悠做神仙
>
>來源：[恆生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)

手把手教你搭建自己的Raneto知識庫（二）

相關文章