如何让Github Pages主题中的zip与tar.gz文件链接图标正常显示？

我之前也碰到过一模一样的情况！别担心，这大概率是主题配置或者仓库设置的小问题，下面几个步骤应该能帮你搞定：

1. 检查全局配置文件_config.yml #

大多数GitHub官方主题（比如Minima）需要你明确开启下载链接的显示。打开你的_config.yml文件，确认这几个配置：

• 首先确保主题设置正确：

  theme: minima  # 替换成你实际使用的官方主题名称
  

• 然后添加或启用下载相关的配置项：

  show_downloads: true
  

  不同主题的配置项名称可能略有差异，比如有些主题叫download_links: true，如果不确定，可以去对应主题的官方文档里查一下。

2. 确认页面Front Matter的设置 #

如果你的项目主页（比如index.md）的Front Matter里覆盖了全局配置，也会导致图标不显示。打开主页的markdown文件，检查顶部的Front Matter：

---
layout: home  # 确保用的是主题的主页布局，只有这个布局通常会显示下载图标
title: 你的OSS项目名称
show_downloads: true  # 要么显式设为true，要么删掉这一行继承全局配置
---

3. 验证GitHub Pages的构建状态 #

有时候修改配置后，GitHub Pages的构建可能有延迟，或者构建过程中出现了错误。你可以：

• 去仓库的Settings > Pages页面，确认构建状态是"Success"
• 如果构建失败，查看日志里的错误信息，通常是配置文件语法错误导致的
• 要是没错误，手动触发一次重新构建：可以提交一个空的commit，或者在Pages设置页面点击"Refresh"按钮

4. 手动添加下载链接（备用方案） #

如果上面的方法都没效果，你可以直接在页面里手动插入带图标的下载链接。比如用GitHub自带的源码打包链接：

- <i class="fa fa-download"></i> [下载ZIP包](https://github.com/你的用户名/你的仓库名/archive/refs/heads/main.zip)
- <i class="fa fa-download"></i> [下载TAR.GZ包](https://github.com/你的用户名/你的仓库名/archive/refs/heads/main.tar.gz)

（注：如果主题没有引入Font Awesome图标库，<i>标签的图标可能显示不出来，这时候可以换成文字描述，比如📥 下载ZIP包）

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