甜甜圈发文指南

发布文章

使用 GitHub Desktop 在基于 GitHub 的 AstroPaper 网站上发布文章涉及几个步骤。以下是详细指南：

前提条件

甜甜圈博客发文依赖 Github 服务，请先确定注册了 GitHub 服务，具有 fork donut-zone/blogs 的权限，并安装了 GitHub Desktop。

1. GitHub 账号：确保你有一个 GitHub 账号。
2. AstroPaper 仓库：确保你在 GitHub 账号中 fork 了 donut-zone/blogs 仓库。
3. GitHub Desktop：确保你的计算机上安装了 GitHub Desktop。

步骤

1. 克隆仓库并新建作者

1. 打开 GitHub Desktop。
2. 点击 File > Clone repository。
3. 选择你 fork 的仓库（your-username/blogs）并将其克隆到本地计算机。
4. 在 src/content/posts/ 目录下新建文件夹并更名为你希望展示的 ID。

2. 确认 fork 的仓库与 donut-zone/blogs 版本一致

1. 在浏览器中打开你 fork 的仓库。
2. 查看文件列表上方是否有 Sync fork 按钮，如有请先点击 Update branch，避免冲突。

3. 创建文章

1. 使用文件资源管理器打开你克隆的仓库。
2. 打开 src/content/posts/，复制 example-draft-post.md 到自己的文件夹中，并修改文件名（文件名会作为文章的 url）。

4. 编写你的文章

1. 使用文本编辑器（例如 VS Code、Sublime Text 或其他任何文本编辑器）打开 Markdown 文件。
2. 使用 Markdown 语法撰写你的文章。
3. 请注意：你需要修改 Markdown 模板中的 frontmatter，其中 slug 建议与文件名保持一致，draft 设置为 false 且 pubDatetime 早于上传至 GitHub 时间时，文章才会被发表至网页。 pubDatetime 属性使用的时间是 UTC 时间。
4. 写好文章后保存文件。

5. 提交更改

1. 回到 GitHub Desktop。
2. 你应该会看到新文件列在 Changes 下。
3. 填写 Summary 和 Description（例如，“Add new article”和“Add ‘writing-guide’ to lin0u0”）。
4. 点击 Commit to main。

6. 推送分支到 GitHub

1. 点击 Push to origin 将你的更改推送到 GitHub。

7. 创建 Pull Request

1. 使用浏览器打开 GitHub 仓库。
2. 点击 Contribute > Open pull request。
3. 审查 pull request 并根据需要添加其他评论或描述。
4. 点击 Create pull request。

最后步骤

创建 pull request 后，需要管理员合并，请呼叫斯斯。合并后，你的新文章将成为 Donut-Zone Blogs 的一部分。

按照这些步骤，你可以轻松地使用 GitHub Desktop 在 Donut-Zone Blogs 网站上发布新文章。