1.4 安装mindoc 和 bookstack
MinDoc 是一款针对IT团队开发的简单好用的文档管理系统。
MinDoc 的前身是 SmartWiki 文档系统。SmartWiki 是基于 PHP 框架 laravel 开发的一款文档管理系统。因 PHP 的部署对普通用户来说太复杂,所以改用 Golang 开发。可以方便用户部署和实用,同时增加Markdown和HTML两种编辑器。
开发缘起是公司IT部门需要一款简单实用的项目接口文档管理和分享的系统。其功能和界面源于 kancloud 。
可以用来储存日常接口文档,数据库字典,手册说明等文档。内置项目管理,用户管理,权限管理等功能,能够满足大部分中小团队的文档管理需求。
官网: https://www.iminho.me/
书栈网:是mindoc二次开发的产品。
官网https://www.bookstack.cn/
我们采用ubuntu18.04安装mindoc
mindoc : 端口8282
bookstack:8383
- 启动容器
docker run -itd \
--name ubuntu_mindoc_bookstack \
--net lnmp \
--link centos_bt:db \
-p 8282:8282 \
-p 8283:8283 \
--mount type=bind,src=/www/data,dst=/www/ \
ubuntu:18.04
- 进入容器
docker exec -it ubuntu_mindoc_bookstack bash - 换成163的源
cp /etc/apt/sources.list /etc/apt/sources.list.bak && sed -i "s/archive\.ubuntu\.com/mirrors\.163\.com/g" /etc/apt/sources.list
rm -rf /var/lib/apt/lists/*
apt-get update
apt install -y wget vim sudo python
安装字体
apt install -y ttf-wqy-zenhei fonts-wqy-microhei
安装calibre中,出现报错时,基本上是因为OpenGL没有安装
所以在安装calibre之前安装
安装OpenGL
sudo apt-get install -y build-essential libgl1-mesa-dev
sudo apt-get install -y freeglut3-dev
sudo apt-get install -y libglew-dev libsdl2-dev libsdl2-image-dev libglm-dev libfreetype6-dev
安装calibr之前,libXcomposite 没有安装,
下载地址: http://us.archive.ubuntu.com/ubuntu/pool/main/libx/libxcomposite/
cd /www/src
wget http://us.archive.ubuntu.com/ubuntu/pool/main/libx/libxcomposite/libxcomposite1_0.4.4-2_amd64.deb
apt-get install ./libxcomposite1_0.4.4-2_amd64.deb
安装calibr
sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.py | sudo python -c "import sys; main=lambda:sys.stderr.write('Download failed\n'); exec(sys.stdin.read()); main()"
ebook-convert --version
查看版本号
ebook-convert --version
测试:
echo "Hello BookStack。你好,书栈。" > test.txt
ebook-convert test.txt test.pdf
安装chromium-browser
apt install -y chromium-browser
输入Y
测试
chromium-browser --headless --disable-gpu --dump-dom --no-sandbox https://www.baidu.com
supervisor安装
apt install -y supervisor
查看安装版本
supervisord --version
mindoc:
下载mindoc版本到服务器内https://github.com/lifei6671/mindoc/releases
在宿主机上,创建goweb,src 存放源码包,bin作为启动目录
mkdir -p /www/data/goweb/src
mkdir -p /www/data/web/gourl/mindoc
cd /www/data/goweb/src
下载速度很慢,推荐下载后,上传到指定目录
wget https://github.com/lifei6671/mindoc/releases/download/v0.10.1/mindoc_linux_amd64.zip
``
unzip mindoc_linux_amd64.zip -d /www/data/web/gourl/mindoc
创建数据库
创建mindoc 和 bookstack 数据库
需要注意权限问题哦,不成功重新建数据库,有可能是宝塔这个软件有问题哦,我遇到过一次。
修改app.conf 中配置文件,修改端口为8282,数据库信息
需要修改/etc/profile
vim /etc/profile
如果你的服务器上没有安装golang程序请手动设置一个环境变量如下:键名为 ZONEINFO,值为MinDoc跟目录下的/lib/time/zoneinfo.zip 绝对路径。
export ZONEINFO=/www/goweb/bin/mindoc/lib/time/zoneinfo.zip
可能以上方案不行,需要这样
export PATH=$PATH:/www/wwwroot/你建立的目录/lib/time
立即生效
source /etc/profile
在 MinDoc 根目录下使用命令行执行如下命令,用于初始化数据库:
./mindoc_linux_amd64 install
加入系统守护进行
1、进入supervisor的配置目录
cd /etc/supervisor/conf.d/
2、配置守护进程
创建bookstack.conf文件,并配置。
[program:BookStack]
directory = 你的程序目录
command =你的程序执行命令
autostart = true
autorestart=true
user = 启动该程序的用户
redirect_stderr = true
stdout_logfile = 日志地址
配置示例:
[program:BookStack]
directory = /www/wwwroot/demo.bookstack.cn
command =/www/wwwroot/demo.bookstack.cn/BookStack
autostart = true
autorestart=true
user = root
redirect_stderr = true
stdout_logfile = /var/log/supervisor/BookStack.log
配置完成之后,重启supervisor
supervisorctl reload
默认管理员账号和密码
admin
admin
其他参考
centos:
firewall-cmd --zone=public --add-port=8181/tcp --permanent
firewall-cmd --reload
设置环境变量
echo ‘export ZONEINFO=/opt/mindoc/lib/time/zoneinfo.zip’>>/etc/profile
source /etc/profile
yum install -y libXrender libXext zlib fontconfig freetype libGL libXcomposite
sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.py | sudo python -c “import sys; main=lambda:sys.stderr.write(‘Download failed\n’); exec(sys.stdin.read()); main()”
root@local-centos7 ~]#echo ‘123’ >test.txt #创建测试文件
[root@local-centos7 ~]#ebook-convert test.txt test.pdf #测试格式转换