博客使用指南

你好！如果你看到了这篇文章，说明你已经成功运行了博客。

0. 个人修改参考

我在 header.astro文件的第五行去掉了原有 Home 这个链接的名字，因为我认为它没有必要。

可以在src page文件夹底下修改me 和 essay 的内容

当对代码有改动并想推送到 GitHub 时，通常只需要执行这三个标准命令（就像把大象装进冰箱一样分三步）：

1. git add . (收集)
   • 这个命令是告诉 Git：“把我现在所有的改动（修改的文件、新加的文件）都放到‘暂存区’，准备打包。”
2. git commit -m “你的备注” (打包)
   • 这个命令是真正的“保存”。它会把刚才收集的改动打成一个包（Commit），并贴上一个备注标签。
3. git push (上传)
   • 这个命令是把在本地打好的包，推送到远程服务器（GitHub）。

git add .
git commit -m "写一句简单的描述，比如：修复了字体抖动问题"
git push

1. 如何写新文章？

在这个博客中，文章就像是**“食材”**，存放在 src/content/blog/ 文件夹里。

只需要在这个文件夹里新建一个 .md 文件（Markdown 格式），就可以发布新文章了。

文件头（Frontmatter）

每个文章文件的开头必须包含以下信息，就像是文章的**“身份证”**：

---
title: '你的文章标题'
description: '一句话简介'
pubDate: 2023-12-18
tags: ['标签1', '标签2']
categories: ['分类']
---

在 --- 下面，就是你的正文内容了。

2. 如何修改首页文字？

首页就像是**“客厅”**。如果你想修改刚才看到的 “spike’s blog” 这些欢迎语：

1. 打开 src/pages/index.astro 文件。
2. 找到 <h1 ...> ... </h1> 和 <p> ... </p> 标签。
3. 直接修改里面的中文文字即可。

常用样式调整位置 (src/pages/index.astro)

如果你想调整 “spike’s blog” 和下面 “这是一个关于…” 之间的距离：

// 找到这行代码：
<h1 class="text-4xl md:text-5xl font-sans font-bold mb-8 ...">
// 修改 mb-8 这个数值

• mb-8: 表示 margin-bottom: 2rem (32px)。
• 想减小间距：改为 mb-4 (16px) 或 mb-6 (24px)。
• 想增大间距：改为 mb-10 (40px) 或 mb-12 (48px)。

如果你想调整 “spike’s blog” 的字号：

// 找到 text-4xl md:text-5xl

• text-4xl: 移动端字号 (36px)。
• md:text-5xl: 电脑端字号 (48px)。
• 可选值：text-3xl, text-6xl 等。

如果你想调整下面那行小字的样式：

<p class="text-lg text-base-700 ...">

• text-lg: 字号 (18px)。
• text-base-700: 颜色 (Flexoki 深灰)。

3. 如何修改“关于我”？

“关于我”页面在 src/pages/about.astro。原理和首页一样，直接修改文件里的文字。

4. 如何修改页脚 (Footer)

页脚文件在 src/components/Footer.astro。

修改“More”标题

找到 <h3 ...>More</h3>，直接修改文字。 现在的样式统一为 text-xl font-heading font-semibold，与首页“文章”标题保持一致。

修改社交链接

找到以下代码：

<a href="https://twitter.com" ...>Twitter</a>
<a href="https://github.com" ...>GitHub</a>

修改 href="..." 引号里的链接地址即可。

5. 文件结构简介

• src/content/blog/: 存放所有博客文章（数据源）。
• src/pages/: 网站的各个页面（如首页、关于页）。
• src/layouts/: 网站的通用布局（如页眉、页脚）。
• src/components/: 可复用的小组件（如文章卡片）。

祝你写作愉快！