1.windows简易版(功能较弱)——MkDocs
MkDocs目前支持Python2.7,3.4,3.6,3.7版本
安装MkDocs
pip install mkdocs
确认是否安装正确
mkdocs --version
创建一个Wiki
mkdocs new my-wiki
cd my-wiki
成功创建后,就如下图所示:
docs文件夹下存放的就是自己写的Markdown文章,系统默认会生成一个index.md文件
mkdocs.yml是wiki网站的配置文件(主题、目录、语言等)
3.预览wiki
首先启动mkdocs服务
mkdocs serve
然后打开浏览器输入127.0.0.1:8000访问wiki
如果以上步骤都执行成功,你将看到如下界面:
我已经添加好了我的个人示例文档。
页面展示
搜索功能演示(仅支持英文)
在其最基本的功能中,搜索插件将简单地提供一个索引文件,该文件只不过是包含所有页面内容的JSON文件。主题需要在客户端实现自己的搜索功能。但是,通过一些设置和必要的模板,该插件可以提供基于lunr.js的完整功能客户端搜索工具。
至此,一个wiki系统已经搭建完成,下面我们来学习一下如何向wiki系统中添加新的内容吧!
添加新内容
添加新的文字内容
首先在docs文件夹下面创建test.md文件,并使用你喜欢的markdown编辑器写入内容,如下所示:
This is a new page.
编辑mkdocs.yml文件,写入以下内容:
nav:
- Home: index.md
- First: first.md
插入图片
在docs文件夹下创建图片文件夹,并将图片放入此文件夹,然后在markdown文件中引用:
博客参考:搭建自己的wiki知识管理系统
2. Linux版(较为成熟)——wiki.js
2.1先看一下搭建好后的效果。
配置node环境
设置node软连接,配置环境变量
查看数据库运行状态
systemctl status postgresql-14
把peer改成trust
改了配置后,要重启数据库。然后重新连接数据库。
systemctl restart postgresql- 14
psql -U postgres
新建数据库,修改用户名密码。
postgres=# alter user postgres with password 'postgres';