同时，为我们标签加入一个页面的组件，在_includes下创建archives.html

内容如下：

标签
{% capture temptags %}
  {% for tag in site.tags %}
    {{ tag[1].size | plus: 1000 }}#{{ tag[0] }}#{{ tag[1].size }}
  {% endfor %}
{% endcapture %}
{% assign sortedtemptags = temptags | split:' ' | sort | reverse %}
{% for temptag in sortedtemptags %}
  {% assign tagitems = temptag | split: '#' %}
  {% capture tagname %}{{ tagitems[1] }}{% endcapture %}
  "/tag/{{ tagname }}">"highligher-rouge">{{ tagname    }}
{% endfor %}

生成标签索引页

因为Jeykll整体内容组织是基于目录的，所需要按目录生成对应的tags,具体方式为，建立一个文件make-tag.py

import glob
import os
 
post_dir = '_posts/'
tag_dir = 'tag/'
 
filenames = glob.glob(post_dir + '*md')
 
total_tags = []
for filename in filenames:
    f = open(filename, 'r', encoding='utf8')
    crawl = False
    for line in f:
        if crawl:
            current_tags = line.strip().split()
            if len(current_tags)>0  and   current_tags[0] == 'tags:':
                total_tags.extend(current_tags[1:])
                crawl = False
                break
        if line.strip() == '---':
            if not crawl:
                crawl = True
            else:
                crawl = False
                break
    f.close()
total_tags = set(total_tags)
 
old_tags = glob.glob(tag_dir + '*.md')
for tag in old_tags:
    os.remove(tag)
    
if not os.path.exists(tag_dir):
    os.makedirs(tag_dir)
 
for tag in total_tags:
    tag_filename = tag_dir + tag + '.md'
    f = open(tag_filename, 'a')
    write_str = '---\nlayout: tagpage\ntitle: \"Tag: ' + tag + '\"\ntag: ' + tag + '\nrobots: noindex\n---\n'
    f.write(write_str)
    f.close()
print("Tags generated, count", total_tags.__len__())

可以简单看出，这个脚本的作用，就是遍历博客文档，生成./tag/TAG.md的文档。

这样，可以在每次博客写完后，运行一下相应的脚本，即可。

python make-tag.py

让标签不在导航中显示

我们现在对标签的配置已经完成了，但是有一个问题，就是所有的标签都会展示在页面的导航中，非常别扭，因此，需要改一下导航的生成。

先将默认的模板copy到项目下：

sudo mv   /Library/Ruby/Gems/2.6.0/gems/minima-2.5.1/_includes/header.html ./_includes

打开header.html，找到下面内容（应该在19-26行)：

"trigger">
  {%- for path in page_paths -%}
    {%- assign my_page = site.pages | where: "path", path | first -%}
    {%- if my_page.title -%}
    "page-link" href="{{ my_page.url | relative_url }}">{{ my_page.title | escape }}
    {%- endif -%}
  {%- endfor -%}

改为：

"trigger">
          {%- for path in page_paths -%}
            {%- assign my_page = site.pages | where: "path", path | first -%}
            {%- if my_page.title  -%}
            {%- unless my_page.title contains "Tag" -%}
            "page-link" href="{{ my_page.url | relative_url }}">{{ my_page.title | escape }}
            {%- endunless -%}
            {%- endif -%}
          {%- endfor -%}
        

这回再刷新，已经看不到多余的内容了。

集成到 GitHub Action中

我们现在已经完成了标签的配置以及生成，但还是很别扭，因为：

1. 1. 每次都要运行一下对应的脚本 python make-tag.py；

2. 2. 在 tag目录下生成很多冗余文件。

对于有强迫症的你，肯定是接受不了的，那么，我们可以把标签生成的工作交给GitHub 的Action来完成。

具体方式：

1. 先直接把tag目录干掉&commit

2. 进入项目的Action 页面，选择New Workflow

3. 进入页面后，搜索pages

4. 选择GitHub Pages Jeykll 下的Configure

5. 这时会跳转到如下页面：

6. 更改这个代码，在第29行后加入：   

   - name: Setup Python
     uses: actions/setup-python@v3
   - name: Generate Tags
     run:  python make-tag.py

然后保存并提交

7. 进入项目的 GitHub配置页面，在Pages标签下，把Build And Deployment下的Source选项从Branch改成GitHub Actions。

在这时，如果再有提交，就会运行我们新配置的action进行部署了。

到此为止，算是大功告成。

参考

1. 1. GitHub 官方文档 https://docs.github.com/cn/pages

2. 2. Jekyll官方文档 https://jekyllrb.com/

3. 3. Long Qian : Jekyll Tags on Github Pages https://longqian.me/2017/02/09/github-jekyll-tag/

4. 4. Jekyll的liquid脚本文档 https://shopify.github.io/liquid/

5. 5. 转义，解决花括号在 Jekyll 被识别成 Liquid 代码的问题 https://blog.walterlv.com/post/jekyll/raw-in-jekyll.html

6. 6. GitHub Actions https://docs.github.com/cn/actions

关于老拐瘦

中年争取不油不丧积极向上的码农一名

咖啡，摄影，骑行，音乐

样样通，样样松

喜欢可以关注一下公众号 IT老拐瘦

目前个人博客长驻： yfge.github.io