Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
你正在查看中文版本。切换到英文 →
Fuwari 是一款基于 Astro 静态站点框架的博客主题，设计简洁且性能优秀，本文介绍项目初始化与目录结构说明、文章 frontmatter 格式（title/published/tags/category/draft）配置、分类与标签设置方法以及博客搭建部署流程。
# 克隆项目
git clone https://github.com/saicaca/fuwari.git
cd fuwari
# 安装依赖
npm install
# 本地开发
npm run dev
# 构建
npm run build
src/config.ts 文件：
export const siteConfig = {
title: '你的博客标题',
subtitle: '副标题',
lang: 'zh-CN',
description: '博客描述',
author: '作者名',
avatar: '/avatar.jpg',
// 社交链接
socialLinks: [
{ name: 'github', url: 'https://github.com/username' },
{ name: 'twitter', url: 'https://twitter.com/username' },
],
}
src/content/posts/ 目录下创建 Markdown 文件：
---
title: 文章标题
published: 2024-01-01
description: 文章描述
tags: [标签1, 标签2]
category: 分类
draft: false
---
文章内容...
# .github/workflows/deploy.yml
name: Deploy
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 18
- run: npm install
- run: npm run build
- uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: ./dist
npm run builddistnpm run builddistsrc/styles/global.css：
:root {
--primary: #your-color;
}