
本文介绍在 Jekyll 中实现导航菜单高亮的进阶技巧:不仅匹配精确 URL(如 /blogs),还能智能识别并高亮与菜单项语义相关但路径结构不同的页面(如 /blog/post-title 对应 Blogs 菜单项)。
本文介绍在 jekyll 中实现导航菜单高亮的进阶技巧:不仅匹配精确 url(如 `/blogs`),还能智能识别并高亮与菜单项语义相关但路径结构不同的页面(如 `/blog/post-title` 对应 `blogs` 菜单项)。
在 Jekyll 静态站点中,常规的导航高亮逻辑通常依赖 page.url == item.url 的严格匹配,但这在内容路径设计不一致时会失效。例如,你将博客列表页设为 /blogs,而单篇博客页使用 /blog/slug —— 此时仅靠 == 判断无法让“Blogs”菜单项在单篇博客页保持激活状态。
解决的关键在于语义化路径匹配:不是比对完整 URL,而是判断当前页面路径是否以菜单项的逻辑 slug 为前缀或包含其语义变体。Jekyll Liquid 模板语言提供了 contains 过滤器,可高效完成此任务。
以下是一个健壮、可扩展的实现方案:
<nav class="nav-links">
{% for item in site.data.settings.menu %}
{% assign active = nil %}
{% assign url = item.url %}
{%- comment -%}
核心逻辑:支持两种激活场景
1. 精确匹配:/blogs → /blogs
2. 语义匹配:/blogs → /blog/post-title(通过字符串包含判断)
注意:需确保 'blog' 是 'blogs' 的语义单数根,且路径中无歧义冲突
{%- endcomment -%}
{% if page.url contains url or page.url contains '/' | append: url | replace: 's', '' | append: '/' %}
{% assign active = 'active' %}
{% endif %}
<li style="list-style-type: none;">
<a href="%7B%7B%20site.github.url%20%7D%7D/%7B%7B%20url%20%7D%7D" class="nav-item {% if active %}{{ active }}{% endif %}">
{{ item.name }}
</a>
</li>
{% endfor %}
</nav>
✅ 说明与优化点:
⚠️ 注意事项:
- 此方案依赖命名约定(如
blogs↔blog),若项目中存在多组类似映射(如projects↔project、journals↔journal),建议改用自定义数据映射表或插件增强可维护性; -
page.url在 Jekyll 中始终以/开头(如/blogs),因此contains判断安全可靠; - 若启用
relative_permalinks或部署子路径,请确认site.github.url已正确配置,否则链接可能失效。
通过这一方法,你的导航栏不仅能精准响应当前页面,更能理解内容层级关系,显著提升用户体验与代码语义清晰度。










