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

news2024/11/26 5:33:49

一、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>