关于node.js:手把手教你搭建自己的Raneto知识库二

41次阅读

共计 2835 个字符,预计需要花费 8 分钟才能阅读完成。

作者:悠悠做神仙

起源:恒生 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 外面的一些配置!

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

感激大家反对,我是悠悠做神仙!

正文完
 0