基于 Astro 和 Claude Code 为 ShareLatex-CE 构建 GitHub Pages 落地页

项目效果

开源项目宣传页示例：https://xuhe2.github.io/sharelatex-ce/

实现效果:

技术选型

本项目采用以下技术栈：

• Astro 框架：适用于内容驱动型网站，生成的静态页面性能优异且对 SEO 友好。
• Claude Code：利用 AI 辅助 UI 设计与 GitHub Actions 部署逻辑编写。

部署配置

1. 进入设置：在项目仓库顶栏点击 Settings。
2. 定位功能：左侧侧边栏找到并点击 Pages 选项。
3. 配置来源：在 Build and deployment -> Source 中选择 Deploy from a branch。
4. 选定路径：在 Branch 下拉菜单选择目标分支（如 gh-pages），路径保持 / (root)。
5. 生效访问：点击 Save。稍等片刻，页面顶部会出现绿色的访问 URL。

常见问题处理

原因

GitHub Pages 默认使用 Jekyll 来构建网页。在 Jekyll 的规则中，任何以下划线 _ 开头的文件夹（例如 _astro/）都会被视为内部私有文件夹，不会被发布到服务器上。

由于 Astro 默认将所有的 CSS 和 JS 文件放在 _astro/ 目录下，GitHub Pages 实际上并没有把这些文件部署出去，所以你的浏览器请求时会报 404。

解决方案 1

• 核心解决方法：添加 .nojekyll 文件