macOS 本地部署 HonKit 教程

环境准备

1. 安装 Node.js

HonKit 依赖 Node.js 环境。用 Homebrew 安装。

如果你的 Mac 上已经装了 Homebrew，可以直接用它来安装 Node.js：

1. 确保 Homebrew 是最新的：

brew update

1. 安装 Node.js：

brew install node

1. 验证安装：

node -v
npm -v

如果你没装 Homebrew，可以用下面命令安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 HonKit

创建项目

1. 新建目录

mkdir mybook
cd mybook

2. 初始化 HonKit 项目

npx honkit init

执行后会生成两个文件：

• README.md：书籍的简介
• SUMMARY.md：目录结构文件

你可以开始编辑这两个文件，添加自己的内容。

本地预览

开发过程中，可以启动本地服务器实时预览：

npx honkit serve

默认访问地址是：

http://localhost:4000

修改 .md 文件后浏览器会自动刷新，非常方便。

构建静态网站

如果你希望将电子书打包成静态 HTML 文件，执行：

npx honkit build

生成的文件会保存在 _book 目录下，可以直接部署到静态服务器或托管平台，比如 GitHub Pages、Vercel 等。

常见问题

1. 权限问题

如果你遇到安装时权限不足问题，可以考虑加上 sudo，但更推荐用 nvm 安装 Node.js，避免全局权限冲突。

2. 端口占用

如果 4000 端口被占用，可以手动指定端口：

honkit serve --port 5000