启鑫的黑板报

标签： WIKI

使用 Zensical 构建本地个人 Wiki 知识库
Zensical 是一个现代化的开源静态网站生成器（Static Site Generator, SSG），主要用于将 Markdown 文本文件编译成美观、响应迅速的技术文档网站或个人知识库。

1. 创建并进入项目目录

打开终端（Terminal），为你的 Wiki 创建一个独立的文件夹并进入：
```
mkdir zensical
cd zensical
```
2. 创建并激活虚拟环境

为了保证依赖隔离，我们使用 Python 包管理工具 uv 来创建虚拟环境，并将其激活：
```
# 创建虚拟环境（默认目录为 .venv）
uv venv

# 激活虚拟环境
source .venv/bin/activate
```
3. 安装 Zensical 核心库

在激活的虚拟环境中，使用 pip 安装 zensical：
```
pip install zensical
```
4. 初始化项目骨架

在当前目录下生成 Wiki 的基础结构和默认配置文件：
```
zensical new .
```
5. 启动本地开发服务器

启动开发服务器。这里我们指定了 --dev-addr 参数，允许通过 0.0.0.0:8000 访问，方便在局域网内访问
```
zensical serve --dev-addr=0.0.0.0:8000
```
访问 http://IP:8000 即可看到你的 Zensical
2026年5月25日