给Hugo PaperMod主题添加一个漂亮又简洁的友情链接页面
PaperMod 默认是极简风格,没有自带“友情链接(Friends / Links)”页,但是我们博主也不是互联网的孤岛,总有一些自己喜欢的左邻右舍,最简单的方法是用生成一个页面来作为友情链接页面,但是太丑了。老刘结合chatgpt,自己添加一个漂亮的友情链接页面,下面是 详细教程(以 Hugo + PaperMod 为例):
一、创建友情链接页面
在你的 Hugo 项目根目录执行:
hugo new friends/_index.md
这会在 content/friends/_index.md 生成文件。
打开该文件,修改为:
---
title: "友情链接"
layout: "friends"
summary: "那些值得一去的好地方"
---
( 注意: layout 是我们下一步要创建的模板文件名。)
二、创建页面模板
PaperMod 的页面模板位于:
themes/PaperMod/layouts/
但我们不直接改主题文件(避免主题升级覆盖),而是复制到你的项目中:
mkdir -p layouts/_default
然后创建一个新模板文件:
nano layouts/_default/friends.html
写入以下示例模板(简洁、与 PaperMod 风格一致):
{{ define "main" }}
<main class="main-content" id="main-content">
<article class="post-single">
<header class="post-header">
<h1 class="post-title">{{ .Title }}</h1>
{{ with .Params.summary }}
<p class="post-description">{{ . }}</p>
{{ end }}
</header>
<style>
.friend-links {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
gap: 1.2rem;
margin-top: 1.5rem;
}
.friend-card {
display: flex;
align-items: center;
padding: 1rem;
border-radius: 0.75rem;
background: var(--entry);
box-shadow: 0 1px 3px rgba(0,0,0,0.1);
transition: all 0.25s ease;
}
.friend-card:hover {
transform: translateY(-4px);
box-shadow: 0 4px 10px rgba(0,0,0,0.15);
}
.friend-card img {
width: 3rem;
height: 3rem;
border-radius: 9999px;
margin-right: 1rem;
}
.friend-card .text-gray-600 {
color: var(--secondary);
}
</style>
<div class="post-content">
{{ .Content }}
<div class="friend-links grid grid-cols-1 sm:grid-cols-2 md:grid-cols-3 gap-4 mt-6">
{{ range .Site.Data.friends }}
<a href="{{ .url }}" target="_blank" rel="noopener" class="friend-card flex items-center p-4 rounded-xl shadow-sm hover:shadow-md transition">
<img src="{{ .avatar }}" alt="{{ .name }}" class="w-12 h-12 rounded-full mr-4">
<div>
<div class="font-semibold">{{ .name }}</div>
<div class="text-sm text-gray-600">{{ .desc }}</div>
</div>
</a>
{{ end }}
</div>
</div>
</article>
</main>
{{ end }}
三、创建数据文件(友情链接信息)
在项目根目录新建:
📝 发布时间:2025-10-13 | 🕷️ 采集时间:2026-05-10 00:00