龙空技术网

开源免费的Wiki.js搭建漂亮的知识库系统

ITPro进化论 1496

前言:

此时你们对“javascript离线文档”大致比较讲究,看官们都需要分析一些“javascript离线文档”的相关资讯。那么小编在网络上搜集了一些有关“javascript离线文档””的相关内容,希望各位老铁们能喜欢,咱们一起来了解一下吧!

Wiki.js是一款知识共享wiki,有权限管理系统、支持多人协作共同维护、支持markdown格式、支持评论、风格简洁等等。适合作为个人博客,或者小团队的文档知识库。

今天就介绍一下Dokcer下部署Wiki.js的方法。

1.创建postgres数据库容器

Wiki.js官方推荐的数据库是postgresql,我们就选择这个数据库;

#下载postgres13.5镜像docker pull postgres:13.5#创建自定义网络docker network create -d bridge --subnet 172.18.0.0/24 --gateway 172.18.0.1 mynet#创建数据持久化目录mkdir -p /db-data/postgresql#启动postgres容器docker run --name postgres --ip=172.18.0.2 --net=mynet --restart=unless-stopped -e POSTGRES_PASSWORD=123456 -p 5432:5432 -v /db-data/postgresql:/var/lib/postgresql/data -d postgres:13.5#命令解释:- **docker run** #创建容器- **–name postgres** # 设置容器名为postgres- **--ip=172.18.0.2** #指定容器的ip地址- **--net=mynet** #指定容器的网络- **--restart=always** #设置容器开机启动- **-e POSTGRES_PASSWORD=123456** # 设置密码- **-p 5432:5432** # 设置访问端口- **-v /db-data/postgresql:/var/lib/postgresql/data** # 将容器中的数据挂载到本地- **-d postgres:15-alpine** #选择镜像#进入postgres容器docker exec -it postgres bash
#容器内查看系统版本cat /etc/issue

正常应该是Debian系统;

修改国内软件源,要不然下载软件速度太慢,没有vim和vi命令,可以通过sed修改/etc/apt/sources.list文件增加国内软件源;

sed -i '1i deb-src  bullseye-backports main non-free contrib\ndeb  bullseye-backports main non-free contrib\ndeb-src  bullseye-updates main non-free contrib\ndeb  bullseye-updates main non-free contrib\ndeb-src  bullseye-security main\ndeb  bullseye-security main\ndeb-src  bullseye main non-free contrib\ndeb  bullseye main non-free contrib\n' /etc/apt/sources.list
2.安装Zhparser中文分词插件

后面中文分词全文索引会用到,依次执行下面命令;

apt-get updateapt-get install gccapt-get install wgetapt-get install makeapt-get install gitapt-get install bzip2apt install postgresql-server-dev-13cd /tmp/wget  -jxvf scws-1.2.2.tar.bz2 cd scws-1.2.2./configure makemake installcd ..git clone  zhparser/makemake install
3.创建数据库、用户、授权
#切换到postgres用户su postgres#登录数据库psql
CREATE DATABASE wikijs;CREATE USER wiki with password 'xxxxxx';GRANT CONNECT ON DATABASE wikijs to wiki;GRANT USAGE ON SCHEMA public TO wiki;GRANT SELECT,update,INSERT,delete ON ALL TABLES IN SCHEMA public TO wiki;ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO wiki;ALTER USER wiki WITH SUPERUSER;
4.启用数据库中文分词能力
##使用wiki账号进入psqlpsql -U wiki -d wikijsCREATE EXTENSION pg_trgm;CREATE EXTENSION zhparser;CREATE TEXT SEARCH CONFIGURATION pg_catalog.chinese_zh (PARSER = zhparser);## 忽略标点影响ALTER ROLE wiki SET zhparser.punctuation_ignore = ON;## 短词复合ALTER ROLE wiki SET zhparser.multi_short = ON;##查看chinese_zh\dF##返回结果如下,则成功               List of text search configurations   Schema   |    Name    |              Description------------+------------+--------------------------------------- pg_catalog | arabic     | configuration for arabic language pg_catalog | chinese_zh |

退出 session,重新连入 postgres 数据库,关闭 wiki superuser权限

psql -U postgres -d postgres##取消 wikijs 用户的临时超管权限ALTER USER wiki WITH NOSUPERUSER;
5.创建Wiki容器
#拉取Wiki.js镜像docker pull ghcr.io/requarks/wiki:2
#启动容器docker run -d -p 8000:3000 --name wiki --ip=172.18.0.3 --net=mynet --restart=unless-stopped  -e TZ=Asia/Shanghai -v /docker_containers/wikidata:/wiki/data/content -e "DB_TYPE=postgres" -e "DB_HOST=172.18.0.2" -e "DB_PORT=5432" -e "DB_USER=wiki" -e "DB_PASS=wiki@2023" -e "DB_NAME=wikijs" ghcr.io/requarks/wiki:2
#配置搜索引擎vi server/modules/search/postgres/definition.yml###enum list 添加一个元素 chinese_zh- chinese_zh
#重启容器docker restart wiki
6.初始化Wiki.js

通过访问wiki;

注册管理账号,点击INSTALL进行安装,完成后自动进入登录页面;

7.配置Wiki.js 7.1设置中文;

下载中文语言包——选择中文语言——点击应用即可;

7.2创建组

创建组的目的主要是进行权限的管理,默认是有Administrators和Guests两个组:

这里用的是最新版的Wiki.js组这里没有翻译过来,不过没关系,咱们有很多翻译软件,网页也可以直接翻译;

7.3设置搜索引擎7.4离线安装语言包

内网环境无法直接下载语言包,此时需要按照如下步骤手动导入语言包:

修改配置文件

进入wiki容器,修改config.yml文件,告诉wiki.js 当前运行在离线环境中:

offline: true

创建离线资源目录

安装目录下创建一个文件夹 data/sideload 用来存放离线资源,比如我是安装在 /wiki/ 下,配置文件中配置的数据文件夹为 /wiki/data ,那么我就创建一个新的文件夹 /wiki/data/sideload 即可。

获取语言包

官方提供的语言包资源可以在这里下载:

务必下载 locales.json ,之后下载您需要的语言包(如 zh.json )。

将下载好的 locales.json , zh.json , en.json 等资源拷入上面创建好的文件夹中。

最后重启服务即可。

标签: #javascript离线文档 #js离线手册