阶段三：日常写作与预览工作流

阶段三：日常写作与预览工作流

现在你已经拥有了一个完美的本地环境。以后每次你想更新网站（比如发一篇新笔记）时，流程如下：

3.1 启动本地服务器

在你的项目文件夹 (~/Projects/TuGuo.github.io) 中：

bundle exec jekyll serve

• bundle exec 确保你使用的是当前项目 Gemfile 中指定的 jekyll 版本，而不是系统里的其他版本。
• 终端会显示服务器已启动，并给你一个地址，通常是： Server address: http://127.0.0.1:4000/

3.2 实时编辑与预览

1. 打开编辑器： 强烈推荐使用 VS Code。
   • 在终端中输入 code . 即可在 VS Code 中打开当前文件夹。
   • 推荐插件： Markdown All in One (提供 Markdown 快捷键和预览)，Better TOML (如果需要编辑 .toml 文件)。
2. 创建/编辑文件：
   • 写新笔记： 在 _posts/ 文件夹下创建 YYYY-MM-DD-my-note.md 文件。
   • 改 “About” 页： 编辑 _pages/about.md。
3. 实时预览：
   • 打开你的浏览器 (Chrome, Safari, Firefox …)，访问 http://127.0.0.1:4000/。
   • 当你保存文件时 (例如在 VS Code 中按 Cmd + S)，Jekyll 会自动侦测到更改，重新生成网站。
   • 你只需要刷新浏览器页面，就可以立刻看到你的修改（包括 LaTeX 公式渲染效果！）。

3.3 发布到线上

当你对本地预览的效果感到满意后，就可以将更改发布到 GitHub Pages。

1. 回到你的终端。

2. 按 Ctrl + C 停止本地服务器。

3. 使用 Git 三连：

   # 1. 查看更改状态 (可选)
   git status
      
   # 2. 添加所有更改
   git add .
      
   # 3. 提交更改，并写清楚你做了什么
   git commit -m "发布新笔记：关于XXX的思考"
      
   # 4. 推送到 GitHub
   git push origin main
   

推送完成后，GitHub Pages 大约需要 1-2 分钟来重新构建你的线上网站。