无法为插件生成的Jekyll页面添加自定义前置默认配置

以下几种方法可以帮你确认生成页面的前置配置是否正确加载：

1. 开启Jekyll verbose日志输出 #

运行构建命令时加上--verbose参数，会打印每个页面的详细处理流程：

bundle exec jekyll build --verbose

在日志中找到你插件生成的标签页面条目，里面会包含该页面读取到的前置数据（front matter），能直接看到libs、layout等字段是否存在。

2. 在Ruby插件中直接打印页面数据 #

既然是你修改的插件脚本，在生成页面的代码逻辑里，添加一行调试输出：

# 在生成page对象后添加
puts "Generated page data: #{page.data.inspect}"
# 或者输出为YAML格式，更易读
puts page.to_yaml

执行构建命令时，控制台会直接输出该页面的完整前置数据，能快速确认libs是否被正确赋值。

3. 在模板中临时插入调试代码 #

在对应的layout模板里，添加以下代码：

{{ page | inspect }}
<!-- 或者输出为YAML格式 -->
{{ page.data | yaml_dump }}

构建后打开生成的HTML页面，就能看到Jekyll传递给模板的page对象完整结构，包括所有前置字段的实际值——虽然是生成后的HTML，但能直接验证模板接收到的内容。

额外提示：排查自定义字段未生效的原因 #

你的permalink和layout能生效但libs不行，大概率是插件生成页面时，没有把_config.yml中的默认libs字段合并到页面的data中。官方文档生成器的代码可能只处理了layout和permalink这两个内置字段，你需要在插件里手动添加：

# 在创建page对象后，添加这行
page.data['libs'] = site.config['libs'] unless page.data.key?('libs')

内容的提问来源于stack exchange，提问作者e-diamond