📄️ 使用 Docusaurus 部署到 GitHub Pages
1. 初始化 Docusaurus 项目
📄️ 修复 Git 推送问题
这是因为远程仓库已经有提交记录,而你的本地仓库没有同步这些记录。你需要先将远程仓库的更改拉取到本地,然后再推送。以下是解决步骤:
📄️ 修复 Docusaurus 部署到 GitHub Pages 的问题
根据错误信息,问题的根本原因是未正确设置 GITUSER 环境变量,或未启用 USESSH。Docusaurus 的 deploy 命令需要指定 Git 用户身份,用于推送构建后的静态文件到 GitHub Pages。
📄️ 修复 GitHub Pages 部署问题
从错误信息中可以看出,部署失败的原因是 GitHub 的访问权限问题,你的账户 (Andromedasm) 没有推送到目标仓库的权限。下面是解决方法的步骤:
📄️ 部署到 GitHub Pages
根据你的仓库名称和 URL(https://github.com/Andromedasm/docusaurus-github),以下是确保正确部署到 GitHub Pages 的完整步骤:
📄️ 为 GitHub Pages 添加自定义域名
在 GitHub Pages 上为你的项目添加自定义域名(Custom Domain)需要完成以下步骤:
📄️ 修复 GitHub Pages 自定义域名问题
问题出在 baseUrl 的配置不正确。由于你已经绑定了自定义域名,baseUrl 不应包含仓库名称 /docusaurus-github/,而应该设置为 /。
📄️ 修复自定义域名问题
问题出在 baseUrl 的配置不正确。由于你已经绑定了自定义域名,baseUrl 不应包含仓库名称 /docusaurus-github/,而应该设置为 /。
📄️ 自动生成侧边栏
在 Docusaurus 中,sidebar.ts 文件默认是手动定义的,但你可以通过使用 自动生成侧边栏 功能,让 Docusaurus 自动根据文件夹结构生成侧边栏内容。
📄️ 部署后自定义域名失效
这个问题是因为每次 npm run deploy 会覆盖 gh-pages 分支的内容,而默认会重新生成 CNAME 文件。如果 CNAME 文件缺失或被覆盖,GitHub Pages 会回退到默认的 URL。
📄️ 部署到 GitHub Pages
从错误信息来看,gh-pages 分支并不存在。这通常是因为 npm run deploy 尚未被成功运行,或者该分支还没有被初始化。
📄️ 推送到 GitHub Pages 时出现错误
你的问题是因为 gh-pages 分支已经存在于远程仓 库,并且远程分支的内容与你本地的 gh-pages 分支不同步。Git 拒绝推送是为了避免冲突。
📄️ 解决 git pull --rebase 时出现 error: cannot pull with rebase: You have unstaged changes. 错误
这个错误表明你的本地分支有未暂存或未提交的更改,Git 需要你先处理这些更改才能继续执行 git pull --rebase。
📄️ 部署到 GitHub Pages
这是正常现象,因为 gh-pages 分支是用来存放 静态文件 的,它是由 npm run build 命令生成的 HTML、CSS 和 JS 文件组成。这些文件是为了部署到 GitHub Pages,直接用于展示你的 Docusaurus 网站。