环境依赖

在开始使用 Twilight 之前，您需要确保系统满足以下要求：

• Node.js >= 20
• pnpm >= 9
• Git

安装 Node.js

访问 Node.js 官网 下载并安装最新版本的 Node.js。建议使用 LTS 版本。

安装完成后，打开终端或命令提示符，运行以下命令验证 Node.js 是否安装成功：

node -v
npm -v

如果显示版本号，则表示安装成功。

安装 pnpm

如果您尚未安装 pnpm，可以通过 npm 安装：

npm install -g pnpm

安装完成后，打开终端或命令提示符，运行以下命令验证 pnpm 是否安装成功：

pnpm -v

如果显示版本号，则表示安装成功。

安装 Git

访问 Git 官网 下载并安装适合您操作系统的 Git 版本。

安装完成后，打开终端或命令提示符，运行以下命令验证 Git 是否安装成功：

git --version

如果显示版本号，则表示安装成功。

项目启动步骤

0. Fork 仓库

点击仓库页面右上角的 Fork 按钮，将仓库 Fork 到自己的 GitHub 账户下

1. 克隆仓库

点击 Code -> Open with GitHub Desktop，或者执行 git clone <仓库地址> (需要安装 Git)

2. 安装依赖

在项目目录下执行以下命令：

# 安装 pnpm 如果未安装
npm install -g pnpm
# 安装项目依赖
pnpm install

3. 配置博客

• 在 twilight.config.yaml 中 自定义博客设置
• 在 src/content 中 管理站点内容

4. 本地调试

在项目目录下执行以下命令：

pnpm dev

启动成功后，您可以在浏览器中访问 http://localhost:4321 查看您的博客。

5. 打包网站

运行以下命令将网站打包成静态文件，生成到 dist 目录中：

pnpm build

生成的 dist 目录可以部署到您自己的服务器上。