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