项目效果
开源项目宣传页示例:https://xuhe2.github.io/sharelatex-ce/
实现效果:

技术选型
本项目采用以下技术栈:
- Astro 框架:适用于内容驱动型网站,生成的静态页面性能优异且对 SEO 友好。
- Claude Code:利用 AI 辅助 UI 设计与 GitHub Actions 部署逻辑编写。
部署配置
- 进入设置:在项目仓库顶栏点击 Settings。
- 定位功能:左侧侧边栏找到并点击 Pages 选项。
- 配置来源:在 Build and deployment -> Source 中选择 Deploy from a branch。
- 选定路径:在 Branch 下拉菜单选择目标分支(如 gh-pages),路径保持 / (root)。
- 生效访问:点击 Save。稍等片刻,页面顶部会出现绿色的访问 URL。




常见问题处理
原因
GitHub Pages 默认使用 Jekyll 来构建网页。在 Jekyll 的规则中,任何以下划线 _ 开头的文件夹(例如 _astro/)都会被视为内部私有文件夹,不会被发布到服务器上。
由于 Astro 默认将所有的 CSS 和 JS 文件放在 _astro/ 目录下,GitHub Pages 实际上并没有把这些文件部署出去,所以你的浏览器请求时会报 404。
解决方案 1
- 核心解决方法:添加 .nojekyll 文件

