切换主题
笔记类的个人博客使用教程
字数
836 字
阅读时间
4 分钟
| 分类 | 内容 |
| 教程名称 | 笔记类个人博客使用教程 |
| 前置条件 | 已完成笔记类个人博客部署 |
| 所需工具 | GitHub Desktop、Obsidian |
卡片 1：安装与登录 GitHub Desktop
| 步骤 | 操作内容 | 注意事项 |
| 1 | 下载并安装 GitHub Desktop | 可从官网获取安装包，安装路径建议使用英文路径 |
| 2 | 打开 GitHub Desktop，点击「文件」>「选项」 | 确保软件正常运行，若无法打开可尝试重启或检查安装完整性 |
| 3 | 在「选项」中登录 GitHub 账号，可选择账号密码登录或使用 Token 登录 | 登录需网络支持，若登录失败检查账号密码或 Token 是否正确 |
卡片 2：克隆仓库到本地
| 步骤 | 操作内容 | 注意事项 |
| 1 | 在 GitHub Desktop 中点击「文件」>「克隆仓库」 | 确保已登录 GitHub 账号，否则无法获取仓库列表 |
| 2 | 在「克隆仓库」窗口切换到 GitHub 标签页，选中已部署的博客项目 | 若项目较多，可通过搜索框快速定位 |
| 3 | 点击 … 选择本地保存路径，路径需为英文 | 避免中文路径，防止后续操作出现异常 |
| 4 | 确认路径和项目无误后，点击 Clone 开始克隆 | 克隆过程需保持网络稳定，克隆完成后可在文件管理器查看仓库文件 |
卡片 3：安装与配置 Obsidian
| 步骤 | 操作内容 | 注意事项 |
| 1 | 从官网下载 Obsidian 并安装 | 根据系统选择对应版本（Windows/macOS/Linux） |
| 2 | 打开 Obsidian，点击左下角 齿轮图标 > 管理仓库 | 若图标不显示，检查软件是否正常加载 |
| 3 | 点击 打开本地仓库，选择之前克隆的 GitHub 项目路径 | 确保路径选择正确，否则无法关联仓库 |
卡片 4：编辑并保存文章
| 步骤 | 操作内容 | 注意事项 |
| 1 | 在 Obsidian 编辑界面使用 Markdown 语法撰写内容 | 支持标题、图片、链接等 Markdown 语法，可参考官方文档学习 |
| 2 | 编辑完成后按 Ctrl+S（Windows）或 Cmd+S（macOS）保存文章 | 定期保存，防止内容丢失 |
卡片 5：同步更新到线上博客
| 步骤 | 操作内容 | 注意事项 |
| 1 | 切回 GitHub Desktop，左侧勾选所有变更文件 | 绿色标记为新增 / 修改文件，确保勾选所有需提交的文件 |
| 2 | 在底部 摘要 栏填写变更说明，如 "Update blog post" | 说明需简洁明确，方便后续追溯 |
| 3 | 点击 Commit to main 提交修改 | main 为默认分支，若使用其他分支需确认分支名称 |
| 4 | 点击右上角 Push origin 将修改推送到 GitHub | 推送需网络支持，完成后会显示绿色对勾和时间戳 |
| 5 | 打开博客网址，按 F5 刷新页面查看更新 | 若未显示更新，检查推送是否成功或稍等片刻再次刷新 |
贡献者
Qiu"一叶知秋"Ye