al-folio 如何部署到 Netlify？

al-folio 如何部署到 Netlify？

【免费下载链接】al-folioA beautiful, simple, clean, and responsive Jekyll theme for academics项目地址: https://gitcode.com/GitHub_Trending/al/al-folio

al-folio 是面向学术主页的 Jekyll 主题，默认的部署路径是 GitHub Pages，但如果你打算把基于 al-folio 的个人站、项目站放到 Netlify 上托管，docs/INSTALL.md的 "Deploy on Netlify" 小节给出了完整操作路径：用模板创建独立仓库、在 Netlify 导入项目、设置构建命令与环境变量，最后触发部署。完成后可获得一个已发布的 al-folio 站点，之后也可以按 Netlify 官方文档接入自己的域名。

准备：从模板创建独立仓库

部署的前提是有一个你自己的 al-folio 站点仓库。文档推荐的方式是在 GitHub 上点击 al-folio 的 "Use this template" 按钮，选择 "Create a new repository"（INSTALL.md提供了直达链接）。

文档同时提醒：不要用 fork 的方式创建自己的站点。Fork 会保留与原仓库的关联，容易误把你的个人站点改动提交成对 al-folio 上游的 pull request。如果之前已经 fork 了，站点本身可以继续使用，只是改动时注意新建分支并推送到自己的仓库。

仓库创建好之后，先确认部署分支。仓库模板的默认主分支是main，下面 Netlify 侧的部署分支就按main配置。

在 Netlify 导入项目并配置构建

在 Netlify 控制台按以下顺序操作（均来自INSTALL.md）：

1. Add new site→Import an existing project→ 选择GitHub，授予 Netlify 访问刚才创建的仓库的权限。

2. 在 deploy settings 中设置：

   • Branch to deploy：main
   • Base directory：留空
   • Build command：

   sed -i "s/^\(baseurl: \).*$/baseurl:/" _config.yml && bundle exec jekyll build

   构建命令由两段组成：先用sed把_config.yml中baseurl行的值清空，再执行bundle exec jekyll build。这样无论仓库里_config.yml原本写了什么baseurl（比如仓库自带的baseurl: /al-folio），Netlify 构建时都会以根路径生成站点。

   • Publish directory：_site

3. 添加两个环境变量：

   Key	Value
   JEKYLL_ENV	production
   RUBY_VERSION	填.github/workflows/deploy.yml中的 Ruby 版本

   RUBY_VERSION的取值要求是对齐仓库里的部署工作流：打开 deploy.yml，Setup Ruby步骤中ruby-version当前为3.3.5，环境变量就填这个值（INSTALL.md也举例为3.3.5）。如果你的仓库版本中该值不同，以你仓库的deploy.yml为准。

触发部署并验证结果

点击 Netlify 上的Deploy，等待构建和发布完成，站点即可访问。文档中的成功标志就是部署流程走完、站点被发布（site to be published），之后访问 Netlify 分配给你的站点地址即可看到 al-folio 页面。

如果要绑定自己的域名，文档指引读者按 Netlify 关于 custom domains 的官方文档操作，该部分不展开。

边界与后续

• 仓库模板的 _config.yml 自带url: https://alshedivat.github.io和baseurl: /al-folio，构建命令会自动处理baseurl；url的填写遵循仓库的一般部署说明：构建前确保_config.yml中url、baseurl与站点实际访问地址一致，部署到your-domain.com/your-project/这类子路径时，url设为your-domain.com、baseurl设为/your-project/，直接部署到域名根路径时baseurl留空且不要删除该字段（INSTALL.md"Deployment to another hosting server" 小节）。
• 构建命令里已包含JEKYLL_ENV=production环境变量对应的一般要求，环境变量表中的JEKYLL_ENV与仓库工作流 deploy.yml 里export JEKYLL_ENV=production的用法一致。
• 如果之后不想用 GitHub Pages 的自动部署、改为自建服务器托管，INSTALL.md也提供了手动bundle exec jekyll build后拷贝_site/的通用路径，可与本文 Netlify 流程互为参照。

【免费下载链接】al-folioA beautiful, simple, clean, and responsive Jekyll theme for academics项目地址: https://gitcode.com/GitHub_Trending/al/al-folio