快速入门

欢迎使用 RefactX主题！本指南将带您完成基于Astro.js构建的现代化博客主题RefactX的安装与配置流程。

环境准备h2

开始前请确保开发环境中已安装以下工具：

• Node.js - 运行开发环境必需
• pnpm - 推荐的包管理工具
• Git - 版本控制工具
• VS Code - 推荐代码编辑器

项目初始化h2

创建项目h3

通过Fork仓库开始您的RefactX项目：

1. 访问RefactX主题仓库
2. 点击”Fork”按钮创建您的副本
3. 本地克隆仓库：

git clone https://github.com/[您的用户名]/[仓库名].git
cd [仓库名]

安装依赖h3

克隆完成后安装项目依赖：

# 安装所有依赖
pnpm install

# 启动开发服务器
pnpm dev

项目配置h2

自定义站点前请先熟悉项目结构，主要配置集中在三个区域：

1. 基础站点配置

   • 文件：src/config.ts
   • 功能：配置站点元数据、导航和核心设置
   • 详情：基础配置指南

2. 代码块样式

   • 文件：ec.config.mjs
   • 功能：自定义代码块外观和行为
   • 详情：ExpressiveCode配置

3. Markdown扩展

   • 文件：/plugins/index.ts
   • 功能：配置Markdown插件和扩展
   • 详情：Markdown扩展语法

内容创作h2

RefactX支持标准Markdown和增强语法：

• 基础Markdown语法 - 核心格式化语法
• 扩展Markdown功能 - 高级格式化选项

文章元数据配置请参考文章配置指南。