Git Blog

Git Blog 是什么？

Git Blog 是 iPhone 和 iPad 上的 Markdown 博客应用，可直接将博客文章草稿编辑并发布到你的 GitHub 仓库。它专为希望在移动设备上创作内容并使用静态站点工作流的作者设计，支持 Jekyll、Hugo、Astro 等静态站点生成器。

应用连接到你的仓库，让你管理新文章和现有 Markdown 文件的编辑，然后使用匹配 Git 分支或拉取请求习惯的工作流发布更改。

主要功能

• 基于块的 Markdown 编辑器，支持拖拽重排序，便于写作时调整标题、列表、引用和代码块
• 相机和照片库集成，应用会处理并将图像作为文章一部分上传
• 图像布局选项（全宽、半宽、并排及额外布局类），控制图像在文章中的显示方式
• 灵活的前置元数据模板，支持自定义字段（包括文本、下拉菜单和图像选择器），并可从仓库现有文章导入前置元数据
• 多种发布模式：直接推送到主分支、创建新分支，或打开拉取请求
• 仓库浏览器，用于查看文件结构、打开现有 Markdown 文件、编辑并重新发布
• 浅色、深色和系统外观模式
• 使用设备钥匙串的安全令牌存储

如何使用 Git Blog

1. 在 iPhone 或 iPad 上打开 Git Blog 并连接到你的 GitHub 仓库。
2. 使用基于块的编辑器创建新 Markdown 文章，添加内容并插入所需图像。
3. 使用前置元数据模板设置必填字段（或从现有文章导入前置元数据），使文章符合你的站点结构。
4. 使用首选工作流发布——推送到主分支、创建分支或打开拉取请求——应用会处理提交（包括图像）。
5. 要修改现有内容，使用仓库浏览器打开 Markdown 文件、编辑并重新发布。

使用场景

• 在远离笔记本电脑时起草新博客文章，然后通过单一移动工作流发布到你的 GitHub 支持的站点
• 通过浏览仓库结构打开文件、应用更新并重新发布，来编辑已发布的 Markdown 文章
• 管理依赖前置元数据字段的静态站点生成器文章（例如从下拉菜单选择值或提供图像选择器）
• 使用基于块的编辑器和写作时重排序块，来构建和格式化需要代码块及一致结构的的技术文章
• 通过团队友好的 Git 工作流发布更改——合适时直接推送到主分支，或在需要审查时创建分支/拉取请求

常见问题

• Git Blog 支持静态站点生成器吗？
  是的。它支持 Jekyll、Hugo、Astro 以及任何静态站点生成器。

• 我能以拉取请求形式发布更改，而不是推送到主分支吗？
  是的。应用支持通过打开拉取请求发布，也支持直接推送到主分支或创建新分支。

• 图像上传如何工作？
  你可以拍摄照片或从图库选择，Git Blog 会处理并将图像与文章一起上传。发布时应用会将图像纳入提交。

• 我能编辑仓库中的现有 Markdown 文件吗？
  是的。Git Blog 包含仓库浏览器，可打开现有 Markdown 文件、编辑并重新发布。

• 它需要哪些设备和 OS 版本？
  App Store 列表显示：iPhone 需要 iOS 17.0 或更高，iPad 需要 iPadOS 17.0 或更高，Mac 需要 macOS 14.0 或更高且配备 Apple M1 芯片或更高，Apple Vision 需要 visionOS 1.0 或更高。

替代方案

• 支持 GitHub 的 Markdown 编辑器（桌面/移动）： 这些也能生成 Markdown 并同步到 GitHub，但可能依赖手动 Git 操作或不同于基于块编辑器的体验。
• 静态站点 CMS 工具（基于 Web 的内容编辑器）： 这些专注于无需直接 Git 分支/拉取请求工作流的创作，可简化发布，但可能不匹配 Git 中心化流程。
• 本地静态站点工作流（编辑 Markdown 并本地构建）： 这提供对渲染和预览的完全控制，但通常需要电脑，而不是直接从手机或平板起草和发布。
• GitHub 基于 Web 的编辑： 这将一切保留在 GitHub 界面中，便于快速编辑，但不提供 Git Blog 描述的移动优先 Markdown 块编辑器和前置元数据模板。