本文以Webinoly提供的LNMP环境，记录安装BookStack的过程。

目前，安装BookStack要求的配置是：

• 命令行访问权限 并安装 gnupg git unzip curl 软件包
• PHP 版本>= 8.2
  • 需要在命令行执行php命令的权限
  • 要求开启的PHP扩展：gd, dom, iconv, mbstring, mysqlnd, openssl, pdo, pdo_mysql, tokenizer, xml, zip
  • 可选扩展：ldap （用于 LDAP 身份验证），exif （用于图像处理）
  • 对于PHP MySQL数据库驱动，首选 nd (Native Driver) 扩展，否则使用默认 mysql 驱动扩展。
• MySQL 版本>= 8.0 或MariaDB 版本>= 10.6
  • 用于存储 BookStack 内容和数据
  • 建议单独创建拥有所有权限的单个数据库
• Git 用于下载与更新
• Composer 版本>= v2.2.0 用于安装和管理依赖项
• 兼容 PHP 的 Web 服务器 例如 Nginx

创建网站

先通过Webinoly的site命令创建PHP网站、及其对应目录与数据库。顺带配置SSL证书：

site domain.ltd -php -mysql
site domain.ltd -ssl=on 
# 可选：自定义证书参数 -ssl-crt=[证书位置] -ssl-key=[证书私钥位置]

手动安装

前往 /var/www/domain.ltd/ 目录，克隆BookStack的Git存储库：

cd /var/www/domain.ltd/ 
git clone https://source.bookstackapp.com/bookstack.git --branch release --single-branch bookstack

进入bookstack目录，执行Composer安装：

cd ./bookstack
composer install --no-dev

基本配置

基于.env.example 模板复制，创建 .env 配置文件，填入网址和数据库信息：

# Application URL
APP_URL=https://example.com

# Database details
DB_HOST=localhost
DB_DATABASE=database_database
DB_USERNAME=database_username
DB_PASSWORD=database_user_password

后续可通过命令 php artisan bookstack:update-url 更新应用网址也就是APP_URL：

随后在终端执行生成应用密钥的命令：

php artisan key:generate

配置Nginx

下文的Nginx配置，以book.lan域名并以HTTP（仅80端口）访问为例：

# WebinolyNginxServerStart
server {
	listen 80;
	listen [::]:80;

	server_name book.lan;

	access_log /var/log/nginx/book.lan.access.log we_log;
	error_log /var/log/nginx/book.lan.error.log;

	root /var/www/book.lan/bookstack/public;

	index index.php index.html index.htm;

	include common/auth.conf;

	# WebinolyCustom
	  location / {
	    try_files $uri $uri/ /index.php?$query_string;
	  }
  
	  location ~ \.php$ {
	    include fastcgi_params;
	    fastcgi_pass unix:/run/php/php-fpm.sock;
	  }
	# WebinolyCustomEnd

	#include common/phpx.conf;
	include common/locations.conf;
	include common/header.conf;
	include /var/www/book.lan/*-nginx.conf;
	include /etc/nginx/conf.d/*.conf.srv;
}

分析：

Webinoly默认的php配置 include common/phpx.conf;
不适用Bookstack要求的query_string，需要将其注释而不调用。

官方文档位于 location ~ \.php$ { 部分的配置行： include snippets/fastcgi-php.conf;
也不适用于目前Webinoly安装的配置（没有这个目录与文件）， 不然会无法调用PHP FastCGI导致白屏。

取而代之的是：include fastcgi_params;
后者文件实际位置位于nginx目录根。

使用

此时打开浏览器即可使用 Bookstack ，创建并登入账号……

来源

另外由于MkDocs本体未曾更新，MkDocs-Material项目组的开发成员另外推出了Zensical，后续或许是更合适的选择。主要是我有Material偏好加上编辑CSS比较方便（其实不熟悉Git我还是对于编辑同步不知所措）。

安装和使用mkdocs(material)

安装 mkdocs-material 其实自带了mkdocs本体，因此只需通过pip安装即可：

pip install mkdocs-material

创建项目目录：

mkdocs new .

预览：

mkdocs serve

基本信息

编辑 mkdocs.yml
配置网站名称、URL和版权信息：

site_name: 名称
site_url: https://domain.ltd
copyright: Copyright © 2026 版权信息

主题与外观

设置主题、语言、特性以及站点图标

theme:
  name: material
  language: zh
  features:
    - search
    - htmlproofer
    - search.suggest
    - navigation.instant
    - navigation.sections
    - navigation.indexes
    - navigation.expand
    - navigation.tabs
    - header.autohide
    - tags
  favicon: ./assets/favicon.png
  logo: ./assets/sitelogo.png

接下来是配色板，针对系统暗色模式引用自定义样式：

  palette:

    # Palette toggle for automatic mode
    - media: "(prefers-color-scheme)"
      primary: cyan
      accent: cyan
      toggle:
        icon: material/brightness-auto
        name: Default Light mode

    # Palette toggle for light mode
    - media: "(prefers-color-scheme: light)"
      primary: black
      accent: cyan
      scheme: v1sta
      toggle:
        icon: material/brightness-7
        name: Dark mode

    # Palette toggle for dark mode
    - media: "(prefers-color-scheme: dark)"
      primary: cyan
      accent: cyan
      scheme: slate
      toggle:
        icon: material/brightness-4
        name: Aurora Mode

引用自定义CSS文件，其文件应存放在docs目录下，引用文件时会将docs作为根目录起始。
如下例的extracss，保存在 [mkdocs目录]/docs/stylesheets目录下：

extra_css:
  - stylesheets/extra.css

创建额外的css配置文件，配置系统的暗色模式支持：

[data-md-color-scheme="v1sta"] {
  --md-primary-fg-color:        #22a2ac;
  --md-primary-fg-color--light: #21d9d9;
  --md-primary-fg-color--dark:  #105474;
  --md-accent-fg-color:#00b0c7;
  --md-typeset-a-color:#00b0c7;
  
  .md-header {
      background-image: linear-gradient(180deg, rgba(0, 0, 0, 1) 1px, rgba(200, 200, 200, 1) 1.2px, rgba(126, 126, 126, 1) 2px, rgba(64, 64, 64, 1) 24px, rgba(25, 25, 25, 1) 24px, rgba(0, 0, 0, 1) 48px, rgba(0, 0, 0, 1) 50px, rgba(20, 20, 20, 1) 100%);;   
  }
  .md-tabs {
    background-color: black;
  }
}
[data-md-color-scheme="slate"] {
  --md-primary-fg-color:        #22a2ac;
  --md-primary-fg-color--light: #00e8e8;
  --md-primary-fg-color--dark:  #105474;
  --md-default-bg-color: #051824;
  --md-code-bg-color: #12252f;
  --md-accent-fg-color:#6de6e6;
  --md-typeset-a-color:#46c8da;
  
  .md-header {
      background-image: linear-gradient(180deg, rgba(0, 0, 0, 1) 1px, rgba(200, 200, 200, 1) 1.2px, rgba(126, 126, 126, 1) 2px, rgba(64, 64, 64, 1) 24px, rgba(25, 25, 25, 1) 24px, rgba(0, 0, 0, 1) 48px, rgba(0, 0, 0, 1) 50px, rgba(20, 20, 20, 1) 100%);;   
      background-blend-mode: luminosity;    
  }
  .md-tabs {
    background-color: black;
  }
}

插件

调用额外插件：

plugins:
  - search
  - ezlinks
  - blog

i18n翻译插件

安装i18n插件：

pip install mkdocs-static-i18n

在plugins部分添加翻译的配置项，例如导航部分的自定义术语：

plugins:
...
  - i18n:
      default_language: zh
      docs_structure: folder
      languages:
        - locale: zh
          default: true
          name: 中文（简体）
          build: true
          nav_translations:
            Command: 命令

未完待续……

一句老话：做菜容易备菜难，mkdocs的配置文件其实很简洁，根据官方手册来都能学会；但更难的问题还是在于如何同步文档。

需要先在本地同步源目录与docs目录的内容，并在docs下使用 mkdocs build 命令构建生成site目录，再就是应该如何把site目录跟VPS上的静态站同步。并且，这一切应该有一种自动化或是控制面板的方式执行。

我真得学一下git和svn的技术。

其他参考：

https://qiita.com/tomoten/items/aa25af4deba5817202fe

https://qiita.com/tomoten/items/26706f2eafe84f70b1a6

https://github.com/wdk-docs/nest-docs

https://zhuanlan.zhihu.com/p/383582472

https://yiruru.com/6%E4%BB%A3%E7%A0%81%E5%A6%82%E8%AF%97/Mkdocs%E7%AE%80%E5%8D%95%E9%83%A8%E7%BD%B2/#22

来源

好奇去后台发现他们的VPS机房已经重建地差不多了，
给了一些聊胜于无的补偿——只有折合不到七块钱，除了让我感觉有点吝啬之外，我很奇怪为什么是这个数。

网上查了一下，CC给每位客户都提供了两个月的等效费用的补偿金，而我的VPS套餐是在优惠时期入手的，而且年付的价格、便宜到甚至不足一个中档套餐的月付费用，
其实能陪五年多没有跑路已经是摩西之奇迹，这建立在双方的信任之上。

不过对于年付来说，确实是聊胜于无就是了。

大概也是告一段落了。不过，现实并没有告一段落。

随之而来的是令人恐慌的台海战争，

其实我现在完全不关心台湾统一的看法——我又不是闽台人，我自己因为身份受到歧视的例子也不少。

对我来说什么时候辽宁省沈大两派（加上鞍山吉吉国）先相互认同、或者肯给烟大两地修个大桥再说吧，再不济，先承认周边县市的认同感——而这是难以达到的……

现在的新闻分析除了造船厂句句不提，
因为青泥洼这片地方随时可以被替代，
怕不是和老檀一样已经没有价值了。咳咳，说多了。
不过，这和本题有什么关系呢？

我更担心的是，一旦开战，
无论是内部防火墙限制、还是外部安保阻拦，
这都不是什么好兆头。

参考露西亚的前嫌，一般民众基于SWIFT的国际消费也被受限。
也就是说，如果黑暗的时代真的到来，即使服务商不跑路，也有可能会被禁止/调查。
本来，商家就是吃风险饭赚钱的。

即便在中国仍有民众倡导和平谈判，也是问答无用的，现实不是日本特摄和机战萝卜。而且，在中国还会进一步受到那些保守者的精神嘲讽——外国的月亮不圆。
那些人，不会同情，却手握社会的话语权。
或者，受到打击而无法在振作起来的重度科技依赖者。

会变成北朝吗？

最近Chrome频繁爆内存甚至出现了“您被禁止访问互联网”的报错，
当然，这只是客户端内存泄露导致网络栈崩溃的纯技术问题。
但是这也使我警觉，一旦栖息在自由派系的民众，真的被禁止访问互联网，又该何去何从呢？

在技术上能做的，也只是本地保存一份服务器备份，获得慰藉而已。

时至如今，台积电已经选择在日本建厂以转移供应商风险。
本地备份，实际上也是类似的道理，但将这种想法传授出去，在中国国内发布绝对是不受欢迎的。“能用为什么要折腾？”

最坏的情况是……
计算机工业和信息化设备管理所、计算机驾驶证、禁机令……一旦落实，远远比忍者杀手还要恐怖百倍。所以，请当成某种妄想症（笑）

无论是现实还是网络社会都有大大小小的圈子、
出现那些想要滥用威权的帝王。不过，这不是我该讨论的。
该去玩人狼村二周目了。

煽风点火的新闻令我恐慌。我必须谨慎对待下一个工作和社交机会。

来源