如何将Docusaurus网站部署至ruixey.github.io根域名

1. 仓库命名规则 #

• 必须命名为 ruixey.github.io，这是GitHub Pages根域名部署的硬性要求，只有该命名的仓库才能直接映射到你的根域名。

2. 配置文件修改要点 #

结合你的配置场景，需调整docusaurus.config.js中的核心字段：

• 将url字段设置为 https://ruixey.github.io
• 把baseUrl字段改为 /（根域名部署无需子路径）
• 确认organizationName填ruixey，projectName填ruixey.github.io
• 若themeConfig里的导航栏、页脚包含路径链接，确保所有链接以/开头，避免子路径跳转错误

3. 分支用途划分 #

• main分支：存放Docusaurus源代码（含Markdown文档、配置文件、主题代码等），日常开发、文档更新都在该分支操作。
• gh-pages分支：存储构建后的静态文件，使用Docusaurus自带的yarn deploy命令时，会自动将构建产物推送至该分支，GitHub Pages将从这里读取内容并发布到根域名。

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