Obsidian

Hugo 博客自动化工作流完整指南 这是一份详尽的工作流文档，记录了从零搭建 Hugo + Obsidian + GitHub Actions 自动化博客系统的完整过程，包括所有细节、注意事项和故障排除方法。 📋 目录 系统架构 仓库结构 配置步骤 工作流详解 日常使用 故障排除 注意事项 进阶优化 🏗️ 系统架构 设计理念 目标： 实现"写作 → 提交 → 自动发布"的无缝工作流。 核心原则： 内容与配置分离 环境可复现 自动化部署 本地与 CI 一致 三仓库架构 hugo-server (主仓库) ├── jesse-blog/ │ ├── content/ → obsidian-notes (子模块) │ ├── public/ → JiashuaiXu.github.io (子模块) │ ├── themes/ │ └── hugo.toml └── flake.nix obsidian-notes (内容仓库) ├── posts/ ├── about/ ├── archive/ └── .github/workflows/deploy.yml JiashuaiXu.github.io (部署仓库) └── (Hugo 生成的静态文件) 职责划分 仓库 用途 操作频率 是否需要手动操作 hugo-server Hugo 配置、主题、Nix 环境 偶尔更新配置 是 obsidian-notes 编写内容（日常工作） 频繁提交 是 JiashuaiXu.github.io 托管静态网站 自动更新 否 📁 仓库结构 hugo-server (主仓库) hugo-server/ ├── .gitmodules # ⚠️ 关键：子模块配置 ├── flake.nix # Nix 环境定义 ├── deploy.sh # 本地部署脚本 └── jesse-blog/ ├── content/ # → obsidian-notes (子模块) ├── public/ # → JiashuaiXu.github.io (子模块) ├── themes/ │ └── hugo-PaperMod/ # 当前使用的主题 └── hugo.toml # Hugo 配置文件 obsidian-notes (内容仓库) obsidian-notes/ ├── .github/workflows/ │ └── deploy.yml # ⚠️ 自动部署工作流 ├── README.md ├── posts/ # 博客文章目录 ├── about/ └── archive/ ⚙️ 配置步骤 1. 创建 obsidian-notes 仓库 在 GitHub 创建空仓库： ...

博客自动化部署配置全记录 记录从零开始搭建 Hugo + Obsidian + GitHub Actions 自动化博客系统的完整过程。 🎯 目标 实现一个完全自动化的博客发布流程： 在 Obsidian 中编写 Markdown 文章 提交到 Git 仓库 自动编译并发布到 GitHub Pages 🏗️ 架构设计 仓库结构 hugo-server (主仓库) ├── jesse-blog/ │ ├── content/ → obsidian-notes (子模块) │ ├── public/ → JiashuaiXu.github.io (子模块) │ ├── themes/ │ └── hugo.toml └── flake.nix obsidian-notes (内容仓库) ├── posts/ ├── about/ ├── archive/ └── .github/workflows/ └── deploy.yml # 自动部署工作流 JiashuaiXu.github.io (部署仓库) └── (Hugo 生成的静态文件) 三个仓库的职责 仓库 用途 操作频率 hugo-server Hugo 项目配置、主题管理 偶尔更新 obsidian-notes 编写内容（日常操作） 频繁提交 JiashuaiXu.github.io 托管静态网站 自动更新 📝 实施步骤 1. 子模块化内容管理 问题： 原来 content/ 目录直接在主仓库中，不便于独立管理。 ...

Obsidian 与 Hugo 完美集成 使用 Obsidian 管理笔记内容，通过 Git 子模块连接到 Hugo 站点。 优势 📝 在 Obsidian 中舒适地写作 🔄 通过 Git 版本控制 🚀 自动发布到博客 🎨 保持 Markdown 格式一致 工作流 # 1. 在 Obsidian 中编写 # 2. 提交到 obsidian-notes 仓库 git add . git commit -m "New article" git push # 3. GitHub Actions 自动完成剩余工作！ 完美的写作体验！✨

写作规范与命名规范 本文档定义了博客文章的写作规范、文件命名规范，以及如何在博客中融合双链笔记（双向链接）功能。 📋 目录 文件命名规范 写作规范 双链笔记融合指南 Front Matter 规范 目录结构规范 最佳实践 📝 文件命名规范 基本原则 使用小写字母和连字符（kebab-case） ✅ 正确：hugo-blog-setup-guide.md ❌ 错误：Hugo_Blog_Setup_Guide.md、hugoBlogSetupGuide.md 使用有意义的描述性名称 ✅ 正确：obsidian-hugo-integration-tutorial.md ❌ 错误：post1.md、article.md、untitled.md 避免特殊字符 不允许：空格、中文标点、特殊符号（!@#$%^&*()） 允许：连字符 -、下划线 _（推荐使用连字符） 包含关键词 文件名应反映文章的核心主题 便于 SEO 和文件查找 命名模式 模式 1：主题-描述（推荐） 技术栈-具体主题.md 示例： hugo-automation-setup.md obsidian-daily-workflow.md github-actions-deployment.md 模式 2：日期-主题（可选） YYYY-MM-DD-主题描述.md 示例： 2025-01-20-writing-guidelines.md 2025-01-15-weekly-summary.md 注意： 如果使用日期前缀，确保在 Front Matter 中也设置正确的 date 字段。 模式 3：分类-主题 分类-主题描述.md 示例： tutorial-hugo-setup.md review-obsidian-plugins.md tutorial-git-workflow.md 命名检查清单 创建新文件前，确认： 文件名全小写 使用连字符分隔单词 文件名清晰描述内容 无空格和特殊字符 长度适中（建议 20-50 个字符） 避免重复（检查现有文件） ✍️ 写作规范 文章结构 每篇博客文章应包含以下部分： ...