您现在的位置是:首页 >技术教程 >两种知识库软件:BookStack和DokuWiKi在Debian12中的安装网站首页技术教程

两种知识库软件:BookStack和DokuWiKi在Debian12中的安装

lggirls 2024-06-16 06:01:02
简介两种知识库软件:BookStack和DokuWiKi在Debian12中的安装

一、BookStack的安装

1. 架设 LNMP系统环境

Debian12、php8.2-fpm、 nginx

2. 下载bookstack源码

3. 按照官网说明进行手动安装。

注意1:composer命令的安装,针对php的命令

 下载、更名、安装

wget https://getcomposer.org/installer
mv installer installer.php
php installer.php --install-dir=/usr/bin --filename=composer

注意2: .env 的配置,除了数据库,还要配置下列项,否则会自动转跳到默认的 example.com.  

APP_URL=http://your-domain.com
APP_LANG=zh_CN

4. 需要的php扩展

php -m

[PHP Modules]
calendar
Core
ctype
curl
date
dom
exif
FFI
fileinfo
filter
ftp
gd
gettext
hash
iconv
json
libxml
mbstring 
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
Phar
posix
random
readline
Reflection
session
shmop
SimpleXML
sockets
sodium
SPL
standard
sysvmsg
sysvsem
sysvshm
tokenizer
xml
xmlreader
xmlwriter
xsl
Zend OPcache
zlib

注意 mbstring 尤为重要,否则引用、链接、显示等会出问题

BoookStack的使用较为简单,其内容组织形式是: 书架→图书→页面→章节,都可以从左侧进行直观的添加。

5. 屏蔽掉左侧显示的 近期活动 信息

以管理员用户登录, 在 设置个性化页面,最下面的“自定义HTML头部内容” 这一项中添加下列样式设置内容

## 绝杀版:屏蔽掉游客浏览时的左、右两边的侧边栏
<style>
  .tri-layout-left { visibility: hidden; }
  .tri-layout-right { visibility: hidden; }
</style>
<script>
	window.addEventListener('DOMContentLoaded', (event) => {
		const loginShowing = document.querySelector('a[href$="/login"]') == null;
		const leftPanel = document.querySelector("div.tri-layout-left");
		const rightPanel = document.querySelector("div.tri-layout-right");
		if (loginShowing) {
			leftPanel.style.visibility = 'visible';
			rightPanel.style.visibility = 'visible';
		}
	});
</script>

## 如果仅仅是隐藏左侧活动记录信息
<script>
    window.addEventListener('DOMContentLoaded', (event) => {
        const loginShowing = document.querySelector('a[href$="/login"]') !== null;
        const leftActivity = document.querySelector("#recent-activity");
        if (loginShowing && leftActivity) {
            leftActivity.style.visibility = 'hidden';
        }
    });
</script>

## 如果要彻底清除左侧活动记录信息
<script>
	window.addEventListener('DOMContentLoaded', (event) => {
	    const loginShowing = document.querySelector('a[href$="/login"]') !== null;
		const leftActivity = document.getElementById("recent-activity");
	    if (loginShowing && leftActivity) {
	    	leftActivity.innerHTML = "";
	    }
	});
</script>

## 屏蔽右侧的侧边栏
<script>
	window.addEventListener('DOMContentLoaded', (event) => {
	    const loginShowing = document.querySelector('a[href$="/login"]') !== null;
	    const rightPanel = document.querySelector("div.tri-layout-right");
	    if (loginShowing && rightPanel) {
	    	rightPanel.style.visibility = 'hidden';
	    }
	});
</script>

 

二、Dokuwiki的安装

Dokuwiki的特点是易安装,内容组织和编辑较麻烦

1. 安装按照官方说明就可以,同样要求php支持,但是不用数据库

2.新建项目、页面

dokuwiki没有直观的新建页面、项目等的按钮、菜单等,需要通过直接在浏览器中修改url,引起“没有这个页面”,然后新建才可以。

修改格式 doku.php?id=项目:次级项目:页面名

 3. 删除页面、项目

3.1 在web登录后的UI界面,将页面的内容完全删除,然后保存,即可删除页面;将每个项目中 的所有页面删除,则项目也会消失。

3.2 用ssh以命令行模式进入根目录进行删除

因为dokuwiki不使用数据库,其内容都是存放在 ~/dokuwiki/data/ 这个目录中的。进一步的,项目、页面的内容,都是放在 data/pages/中的。直接用rm 物理删除即可

 3.3 文件夹内中文无法正常显示的问题

可以看到在上图中,有几个中文的项目和页面,名称都是%E*..... 需要修改配置文件,强制指定编码

vim ~/dokuwiki/conf/local.php
## 在最下方增加:
$conf['fnencode'] = 'utf-8'; 

 4. 所见即所得的编辑插件

通过管理员账户进行管理,进入扩展管理器,然后搜索 prosemirror  这个插件,进行安装和启用即可。启用后,进入页面编辑,会有一个切换按钮。

5. 利用ACL配置,设定每个项目、页面的访问权限

1.先选择要设定哪部分内容的权限; 2.选择要许可给哪个用户或者组;3.点击选择进行确定;4.选择何种权限(从左向右呈包含关系,删除权限为最大权限); 5.设定权限后点击保存; 6.点击右下角的更新。 至此设定完成。

 解释: @ALL 设定为读取即可,如果设定为编辑,则不用登录dokuwiki也可以进行编辑; 为 @user设定编辑权限; 指定具体的用户,给与创建、上传、删除等权限,按需进行。

6. 安全设置

按照官方说明进行调整即可:     安全设定:https://www.dokuwiki.org/zh:security

风语者!平时喜欢研究各种技术,目前在从事后端开发工作,热爱生活、热爱工作。