Github Pages | My Site

📄️ 使用 Docusaurus 部署到 GitHub Pages

1. 初始化 Docusaurus 项目

这是因为远程仓库已经有提交记录，而你的本地仓库没有同步这些记录。你需要先将远程仓库的更改拉取到本地，然后再推送。以下是解决步骤：

根据错误信息，问题的根本原因是未正确设置 GITUSER 环境变量，或未启用 USESSH。Docusaurus 的 deploy 命令需要指定 Git 用户身份，用于推送构建后的静态文件到 GitHub Pages。

从错误信息中可以看出，部署失败的原因是 GitHub 的访问权限问题，你的账户 (Andromedasm) 没有推送到目标仓库的权限。下面是解决方法的步骤：

根据你的仓库名称和 URL（https://github.com/Andromedasm/docusaurus-github），以下是确保正确部署到 GitHub Pages 的完整步骤：

在 GitHub Pages 上为你的项目添加自定义域名（Custom Domain）需要完成以下步骤：

问题出在 baseUrl 的配置不正确。由于你已经绑定了自定义域名，baseUrl 不应包含仓库名称 /docusaurus-github/，而应该设置为 /。

问题出在 baseUrl 的配置不正确。由于你已经绑定了自定义域名，baseUrl 不应包含仓库名称 /docusaurus-github/，而应该设置为 /。

在 Docusaurus 中，sidebar.ts 文件默认是手动定义的，但你可以通过使用自动生成侧边栏功能，让 Docusaurus 自动根据文件夹结构生成侧边栏内容。

这个问题是因为每次 npm run deploy 会覆盖 gh-pages 分支的内容，而默认会重新生成 CNAME 文件。如果 CNAME 文件缺失或被覆盖，GitHub Pages 会回退到默认的 URL。

从错误信息来看，gh-pages 分支并不存在。这通常是因为 npm run deploy 尚未被成功运行，或者该分支还没有被初始化。

你的问题是因为 gh-pages 分支已经存在于远程仓库，并且远程分支的内容与你本地的 gh-pages 分支不同步。Git 拒绝推送是为了避免冲突。

这个错误表明你的本地分支有未暂存或未提交的更改，Git 需要你先处理这些更改才能继续执行 git pull --rebase。

这是正常现象，因为 gh-pages 分支是用来存放静态文件的，它是由 npm run build 命令生成的 HTML、CSS 和 JS 文件组成。这些文件是为了部署到 GitHub Pages，直接用于展示你的 Docusaurus 网站。

Git 正在提示你在 gh-pages 分支和 main 分支之间有未解决的冲突。这是因为你之前尝试合并或拉取时没有完成冲突的解决流程。

问题出在 git push 阶段，Docusaurus 的部署脚本试图推送到错误的远程仓库地址 https//github.com/Andromedasm/docusaurus-github.git。

如果你在主目录中创建了 CNAME 文件，但它没有显示在 GitHub 仓库中，可能是以下原因之一：

你的配置总体是正确的，尤其是对于绑定自定义域名的场景。但这里提供一些优化建议和解释，以确保配置更加稳健。