如何在jekyll serve的post_write钩子调用Python脚本并解决循环问题？

一、确保钩子正确触发 #

首先要确认Jekyll能加载并执行你的钩子脚本：

1. 新建_plugins/tag_trigger.rb文件（必须放在_plugins目录，且以.rb结尾），写入以下代码：

Jekyll::Hooks.register :posts, :post_write do |post|
  puts "触发post_write钩子，调用标签生成脚本..." # verbose模式下可查看触发日志
  # 根据你的环境选择python或python3，确保脚本路径正确
  execution_result = system('python3 _plugins/compile_tags.py')
  puts execution_result ? "标签生成脚本执行成功" : "标签生成脚本执行失败"
end

2. 启动本地服务时带上--verbose参数：bundle exec jekyll serve --verbose，查看控制台是否有上述打印内容。如果没触发，检查：
   • 插件文件名是否符合.rb后缀要求
   • 文章是否在_posts目录下，且命名符合YYYY-MM-DD-标题.md的规范
   • _config.yml中是否禁用了插件（默认是启用状态）

二、解决无限循环问题 #

循环的核心原因是：Python脚本生成的标签页文件被Jekyll监测到变化，触发增量构建，进而再次触发钩子形成闭环。以下是三种可行的解决方式：

方式1：让Jekyll忽略标签页目录的变化 #

如果你的标签页不需要Jekyll进行模板渲染（仅静态生成），可以在_config.yml中添加排除规则：

exclude:
  - tags/

这样Jekyll不会监测tags目录下的文件变化，也就不会触发重复构建。

方式2：在钩子中过滤触发源 #

仅对_posts目录下的真实文章触发脚本，同时限制执行频率避免短时间重复触发：

Jekyll::Hooks.register :posts, :post_write do |post|
  # 只处理_posts目录下的原始文章，跳过其他可能被识别为post的文件
  next unless File.expand_path(post.path).include?(File.expand_path('_posts'))

  # 用临时文件记录上次执行时间，避免短时间重复触发
  last_run_marker = '_plugins/.last_tag_gen'
  current_timestamp = Time.now.to_i
  last_run_timestamp = File.exist?(last_run_marker) ? File.read(last_run_marker).to_i : 0

  # 间隔5秒以上才执行脚本（可根据需求调整）
  if current_timestamp - last_run_timestamp > 5
    system('python3 _plugins/compile_tags.py')
    File.write(last_run_marker, current_timestamp.to_s)
  end
end

方式3：标记自动生成的标签页 #

修改Python脚本，在生成的标签页头部添加YAML前置变量generated: true，然后在钩子中跳过这类文件：

Jekyll::Hooks.register :posts, :post_write do |post|
  # 跳过带有generated标记的自动生成文件
  next if post.data['generated'] == true

  system('python3 _plugins/compile_tags.py')
end

Python脚本生成的标签页开头示例：

---
generated: true
title: "标签：Python"
---

三、验证效果 #

运行bundle exec jekyll serve --verbose，修改一篇文章的tags：

• 查看控制台是否仅触发一次钩子
• 检查tags目录下是否生成了正确的标签页
• 确认没有重复触发的日志输出，循环问题解决

内容的提问来源于stack exchange，提问作者joharr