解决Jekyll生成绝对路径无法本地打开的问题

1. 调整baseurl为相对路径 #

修改_config.yml中的baseurl配置，从绝对路径改为.（当前目录）或者空字符串，让Jekyll生成相对路径开头的链接：

baseurl: "." # 也可设置为 baseurl: ""

生成后的链接会变成get-started/install.html这类相对路径，解压后本地打开时，浏览器会自动基于当前HTML文件的路径解析跳转。

2. 批量替换已生成的绝对链接 #

如果已经完成静态站点构建，不想重新编译，可以批量修改HTML文件中的链接前缀：

• 用文本编辑器的批量替换功能，把所有href="/en/sptest/test-suite/test-product/test-release/01-book-with-toc/替换为href="file:///C:/Users/abc/Downloads/xyz/html/（根据实际解压路径调整）
• 也可以用脚本批量处理，比如Python脚本：

import os

# 替换为你的解压后HTML目录路径
target_dir = "C:/Users/abc/Downloads/xyz/html"
# 原绝对链接前缀
prefix_old = "/en/sptest/test-suite/test-product/test-release/01-book-with-toc/"
# 目标file://前缀
prefix_new = "file:///C:/Users/abc/Downloads/xyz/html/"

for root, dirs, files in os.walk(target_dir):
    for file in files:
        if file.endswith(".html"):
            file_path = os.path.join(root, file)
            with open(file_path, "r", encoding="utf-8") as f:
                content = f.read()
            content = content.replace(prefix_old, prefix_new)
            with open(file_path, "w", encoding="utf-8") as f:
                f.write(content)

3. 自定义Jekyll过滤器生成file://链接（进阶） #

如果想在构建阶段直接生成带file://前缀的链接，可自定义Liquid过滤器：
在站点根目录的_plugins文件夹下创建file_link_filter.rb文件，内容如下：

module Jekyll
  module FileLinkFilter
    def file_link(url, local_root)
      # 去掉链接开头的斜杠，拼接本地路径
      "file:///#{local_root}/#{url.sub(/^\//, '')}"
    end
  end
end

Liquid::Template.register_filter(Jekyll::FileLinkFilter)

之后在模板文件中使用这个过滤器：

<a href="{{ page.url | file_link: 'C:/Users/abc/Downloads/xyz/html' }}">Install</a>

注意：这种方式需要提前确定本地解压路径，适合固定分发路径的场景。

关键提示 #

• 相对路径方案通用性更强，用户将压缩包解压到任意目录都能正常访问，无需提前指定路径
• 如果站点存在多层目录结构，要确保相对路径的层级正确性，比如子目录页面跳转上级目录时需用../

内容的提问来源于stack exchange，提问作者Shreya Sheel Sachan