返回首页
头像

博客搭建与管理指南

博客搭建与管理指南

本文档总结了使用GitHub Pages搭建和管理个人博客的关键步骤和命令，方便日后查阅参考。

1. 添加新文章到博客

使用脚本添加文章

python3 scripts/update_blog.py "文章路径.md" 文章目录名 "发布日期"

例如：

python3 scripts/update_blog.py "/Users/xingshuhao/Documents/博客文章/ChatGPT 眼中的星树浩.md" chatgpt-view "2025年04月12日"

提交并推送更改

git add .
git commit -m "添加新文章：文章标题"
git push

2. 删除文章

删除文章目录和文件

# 删除文章目录
rm -rf posts/要删除的文章目录

# 删除Markdown源文件
rm -f posts/要删除的文件.md

更新首页文章列表

需要编辑index.html文件，删除不需要的文章链接。

更新其他文章页面底部的文章列表

需要编辑每篇保留文章的index.html文件，更新底部的文章列表。

提交并推送更改

git add .
git commit -m "删除文章：文章标题"
git push

3. Markdown写作指南

基础语法

标题

# 一级标题 (最大)
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题 (最小)

段落和换行

段落之间用一个空行分隔：

这是第一段文字。

这是第二段文字。

如果想在段落内换行，可以在行末添加两个空格，然后回车：

这是一行文字，
这是新的一行。

强调文本

*斜体文字* 或 _斜体文字_
**粗体文字** 或 __粗体文字__
***粗斜体文字*** 或 ___粗斜体文字___

列表

无序列表：

- 项目1
- 项目2
  - 子项目A
  - 子项目B

有序列表：

1. 第一项
2. 第二项
3. 第三项

链接

[链接文字](https://www.example.com)

图片

![替代文字](图片URL)

引用

> 这是一段引用文字。
>
> 这是引用的第二段。

代码

行内代码：

使用 `print("Hello World")` 命令

代码块：

```python
def hello():
    print("Hello, World!")
```

水平线

---

高级语法

表格

| 姓名 | 年龄 | 职业 |
| --- | --- | --- |
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |

任务列表

- [x] 已完成任务
- [ ] 未完成任务

4. 博客文章工作流

  1. 在VSCode中使用Markdown格式编写文章
  2. 保存文件到适当位置
  3. 使用脚本将文章添加到博客
  4. 提交并推送到GitHub
  5. 访问网站查看更新

5. 常见问题解决

文章不显示或显示错误

删除文章后仍然显示

6. 自定义域名（未来可选）

如果将来想添加自定义域名，可以考虑：

  1. 使用Netlify（最简单选项）
  2. 使用Freenom注册免费顶级域名
  3. 配置DNS设置指向GitHub Pages

7. 有用的Git命令

# 查看状态
git status

# 查看变更
git diff

# 查看提交历史
git log

# 撤销未提交的更改
git checkout -- 文件名

# 创建新分支
git checkout -b 分支名

# 切换分支
git checkout 分支名

# 合并分支
git merge 分支名

希望这个指南对您有所帮助！如有任何问题，可以随时向AI助手咨询。