文章图片
文章图片
【docker|支持中文!秒建 wiki 知识库的开源项目,构建私人知识网络】
文章图片
文章图片
文章图片
不知道有没有人和我一样 , 觉得自建的东西是互联网上的“自留地”、私人空间 , 有一种自己的一亩三分地随心所欲的痛快 。
比如自建的博客想写什么随笔就写什么 , 不用取悦读者可以自娱自乐;再比如自建的 wiki 有不会的知识点就可以直接记录 , 不用担心被嘲笑低级 。 抛开共建这块不聊 , Wiki 不同于博客的随性 , 记录的内容更注重知识点和分类 , 可以用来构建自己的知识网络 。
如果把博客比作“日记本” , 那 wiki 就是“笔记本”它用来记录知识点 , 方便用时查阅和更新 , 有清晰的目录而且一个知识点还可以关联到其它知识点 , 逐步拓展成“百科全书” 。
一、介绍知识在于积累 , 还不能忘记梳理 。
今天 , 我们要介绍的开源项目是专门用来构建 wiki 平台 , 助你梳理知识点的 wiki.js
地址:github.com/requarks/wiki它是一款轻量级、功能强大的 wiki 开源项目 , 拥有评论、Markdown 编辑器、图片上传、标签、全局搜索、协同编辑、编辑历史、用户管理、谷歌分析等功能 , 而且支持高度自定义 。
用到的技术栈也不同于老旧的 wiki 系统 , 它采用了 Node.js、PostgreSQL、Vue.js、Docker 等技术 。 基于 Docker 实现的一键部署 , 颇有 WordPress 之风 , 不要太爽!
重点是支持中文 , 而且界面简洁还不失美感 , 这点足以让它在众多同类项目中脱颖而出 。
看到这儿 , 你是不是手痒了呢?下面就和我一起来让它跑起来吧!
二、安装开源项目成功的必要因素之一就是有详细易懂的文档 , 而安装说明又是重中之重 。
Wiki.js 官方文档提供了多种部署方法 , 包括:Linux、macOS、Windows、Docker、k8s 等 , 涵盖了几乎所有可能性 , 十分全面 。
下面我就介绍其中最快捷和通用的一种 , 即基于 Docker 的 Docker Compose 部署 。
Tips:如果你不懂 Docker 建议跟着 docs.requarks.io/install/ubuntu 逐步执行
下面我将主要介绍 Linux 下的安装步骤 , 其它系统有桌面版不再赘述 。
如果你机器上有 Docker 仅需两步即可完成安装 。
第一步 , 安装 docker-compose:
1、下载
curl -L https://get.daocloud.io/docker/compose/releases/download/v2.4.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose2、加执行权限
$ sudo chmod +x /usr/local/bin/docker-compose3、创建快捷方式
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose至此 , 你就可以在任何地方使用docker-compose 命令了 。
第二步 , 运行 docker-compose:
1、创建配置文件docker-compose.yml 内容如下:
整个项目分为数据库和项目代码两部分 , 与之对应的是pg 容器 和 wiki 容器 。
2、在配置所在的目录下 , 执行命令:
- 运行:docker-compose up -d
- 查看容器:docker ps
- 停止:docker-compose down
Caddyfile 的配置内容如下:
8001 端口对应的是上面 wiki 容器的 ports 端口映射
域名 {reverse_proxy 127.0.0.1:8001执行caddy start 启动 Caddy 服务器 , 浏览器中访问对应的域名 , 网站初始化的引导界面 , 就会出现在你的面前了 。
至此 , 以上就是 wiki.js 安装的全过程 , 你跑起来了吗?
三、瑕不掩瑜Wiki.js 并不是十全十美的 , 虽然我也是刚上手 , 但还是发现了一些美中不足:
- 第一次访问加载速度较慢
- 虽然 wiki.js 更新积极、提交频繁 , 但目前它还不支持自定义主题
- 对中文搜索不友好 , 默认不支持中文搜索 , 需要采用 ES 但这样就不再轻量 , 或者采用 pg 插件让 pg 支持中文分词
- 5G|国产CPU手机正式发布:6nm工艺 支持5G!
- 努比亚|中兴大力支持,1024G旗舰卖到5999元
- 官宣|鸿蒙3.0支持机型名单出炉,趁着618赶紧入手,千万别买错了
- 硬盘|85元入手IBM的M5110阵列卡,完美变身直通卡,单盘最高支持18T
- docker|三大卖点曝光,该有的都有,vivo T2即将发布
- iPhone|iPhoneXSMax上线512G版本,提升性价比之后,多少人会支持?
- 液晶显示器|雷军晒出520“情书”:重金定制LCD屏幕,你会支持吗?
- 小米科技|小米Max5规格曝光:LCD直屏+6.9英寸+天玑8000,支持侧边指纹
- 武汉|武汉首家 Apple Store 明日开业!拥有中国首家支持到店取货区域
- iPhone|你的iphone将迎来重大升级,终于支持分屏?还有多个隐藏新功能