借助Quarto与GitHub Pages搭建Python博客遇阻求助

1. 修复Git仓库初始化问题 #

报错fatal: not a git repository是因为你的myblog文件夹未初始化Git仓库，执行以下命令完成初始化并关联远程仓库：

# 进入myblog文件夹
cd myblog
# 初始化Git仓库
git init
# 添加远程仓库地址
git remote add origin https://github.com/MkengineTA/MkengineTA.github.io.git
# 拉取远程main分支内容（避免冲突）
git pull origin main --allow-unrelated-histories

2. 确保docs文件夹正确生成 #

单独执行quarto render Day1.ipynb只会生成单个文件的HTML，不会触发项目级别的docs目录生成。正确操作：

• 先修正_quarto.yml的CSS路径：配置里写的是css: styles.css，但你文件夹里的文件是style.css，文件名不匹配会导致样式加载失败，建议统一文件名。
• 执行项目级渲染命令，生成完整的docs目录：

quarto render

执行后，myblog文件夹下会自动生成包含所有静态页面的docs目录。

3. 上传到GitHub Pages的完整流程 #

完成上述步骤后，执行以下命令推送代码：

# 添加所有文件到暂存区
git add .
# 提交修改
git commit -m "Initial blog deployment"
# 推送到远程main分支
git push origin main

推送完成后等待几分钟，GitHub Pages会自动部署，即可访问你的博客。

Quarto替代工具推荐 #

如果Quarto的RStudio导向教程让你觉得不便，推荐以下适合Python用户的静态博客工具：

• Jekyll + nbconvert：GitHub Pages原生支持的静态站点生成器，配合nbconvert可将Jupyter Notebook转为Markdown/HTML，直接集成到项目中。
• Hugo + nbconvert：生成速度更快，同样支持通过nbconvert处理Notebook，适合快速构建博客。
• FastPages：专为数据科学用户设计，直接支持Jupyter Notebook、Markdown，无需复杂配置即可部署到GitHub Pages。

内容的提问来源于stack exchange，提问作者Tobias Averbeck