Local Preview

这个仓库支持使用 Jekyll 在本地预览页面。下面这套流程适用于当前仓库已经采用的 repo-local Ruby 依赖方式，也就是把 bundler 安装到 .gem/，把站点依赖安装到 vendor/bundle/。

1. 首次配置系统依赖

这一步只需要执行一次，需要 root 权限：

apt-get update
apt-get install -y ruby-dev build-essential

如果机器上已经装过这些依赖，可以跳过。

2. 首次配置仓库内 Ruby 环境

在仓库根目录执行：

gem install --install-dir "$PWD/.gem" --bindir "$PWD/.gem/bin" bundler -v 2.5.10 --no-document
GEM_HOME=$PWD/.gem GEM_PATH=$PWD/.gem PATH=$PWD/.gem/bin:$PATH ./.gem/bin/bundle _2.5.10_ install

这一步会：

• 把 bundler 安装到仓库内的 .gem/
• 把 Jekyll 运行依赖安装到 vendor/bundle/

这些目录都已经加入 .gitignore，不需要提交。

3. 启动本地预览

在仓库根目录执行：

bash run_server.sh

启动成功后，在浏览器打开：

http://127.0.0.1:4000/
http://127.0.0.1:4000/publications/

修改页面内容后，Jekyll 会自动重新生成页面，本地刷新浏览器即可查看。

4. 停止服务

在运行服务器的终端里按：

Ctrl+C

5. 日常使用

如果系统依赖和 Ruby 依赖都已经装好，后面通常只需要：

bash run_server.sh

6. 常见问题

如果 run_server.sh 提示 bundle is not available，说明仓库内的 bundler 还没装好，重新执行第 2 步即可。

如果 bundle install 报 native extension 相关错误，通常是系统里缺 ruby-dev 或编译工具，重新确认第 1 步是否已完成。

如果 4000 端口被占用，可以先关闭已有 Jekyll 进程，或者临时改 run_server.sh 里的端口。