开始使用你的新博客

欢迎来到由 merox-erudite 驱动的新博客！本指南将帮助你完成博客的基础设置与个性化定制。

初始设置

1. 配置站点

在 src/consts.ts 中修改站点信息：

1
export const SITE: Site = {
2
  title: 'Your Blog Name',
3
  description: 'Your blog description',
4
  href: 'https://yourdomain.com',
5
  author: 'your-author-id',
6
  // ...
7
}

2. 更新导航

在 src/consts.ts 中自定义导航链接：

1
export const NAV_LINKS: SocialLink[] = [
2
  { href: '/blog', label: 'Blog' },
3
  { href: '/about', label: 'About' },
4
  // Add more links as needed
5
]

3. 添加社交链接

更新你的社交媒体地址：

1
export const SOCIAL_LINKS: SocialLink[] = [
2
  { href: 'https://github.com/username', label: 'GitHub' },
3
  { href: 'https://twitter.com/username', label: 'Twitter' },
4
  { href: 'mailto:your@email.com', label: 'Email' },
5
]

创建内容

博客文章

在 src/content/blog/ 中创建新文章：

为你的文章创建文件夹：src/content/blog/my-post/
新增 index.mdx 文件并添加 frontmatter：

1
---
2
title: "My First Post"
3
description: "A brief description"
4
date: 2025-01-16
5
tags: ["tag1", "tag2"]
6
draft: false
7
---

使用 Markdown 或 MDX 编写正文

Tip

专业提示： 你可以在文章中使用 MDX 组件（如 Callout、代码块等）来增强排版！

作者档案

在 src/content/authors/ 中创建作者档案：

1
---
2
name: 'Your Name'
3
avatar: 'https://gravatar.com/avatar/...'
4
bio: 'Your bio'
5
github: 'https://github.com/username'
6
---

个性化

颜色

在 src/styles/global.css 中自定义配色方案：

1
:root {
2
  --primary: hsl(214 95% 52%);
3
  /* 自定义其它颜色 */
4
}

首页经验时间线

在 src/pages/index.astro 中自定义你的经验时间线：

1
const experience: ExperienceItem[] = [
2
  {
3
    role: 'Your Role',
4
    company: 'Company Name',
5
    period: '2020 - Present',
6
    current: true,
7
    icon: 'lucide:briefcase',
8
    key: '你的成就与职责'
9
  },
10
]

可选功能

邮件订阅（Brevo）

注册 Brevo
获取你的 API Key

在 .env 中添加：

1
BREVO_API_KEY=your-api-key
2
BREVO_LIST_ID=your-list-id

Disqus 评论

创建 Disqus 账户
在 .env 中添加：
```
1
PUBLIC_DISQUS_SHORTNAME=your-shortname
```

站点分析

添加 Google Analytics 或 Umami：

1
PUBLIC_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX
2
PUBLIC_UMAMI_WEBSITE_ID=your-umami-id

后续步骤

删除示例内容 - 移除 hello-world 与 getting-started 文章
更新关于页面 - 自定义 src/pages/about.astro
更新隐私与条款 - 查看并自定义法律页面
添加你的内容 - 开始撰写博客文章！

资源

写博愉快！🎉