内容类型指南
本指南为在 Hugo 网站中创建不同类型内容提供了全面说明,包括模板、最佳实践和工作流程建议。
概览
网站支持多种内容类型,每种类型都有特定的 Front Matter 要求和组织模式:
- 博客文章:技术文章、个人感悟与见解
- 书籍:出版信息与书评
- 播客:音频内容及文字稿与元数据
- 翻译:翻译文章及内容
- 公告:通知与更新
- 旅行:旅行日志与体验
博客文章
博客文章是分享技术见解、教程和个人感悟的主要内容类型。
目录结构
content/[lang]/blog/[post-slug]/
├── index.md # 主要内容文件
├── images/ # 文章专属图片(可选)
└── attachments/ # 附加文件(可选)
Front Matter 模板
---
title: "你的文章标题"
linktitle: "导航用的简短标题(可选)"
date: 2025-01-15T10:00:00+08:00
draft: false
slug: "your-post-slug"
categories:
- 技术
- 云原生
tags:
- Kubernetes
- Istio
- Service Mesh
description: "简明扼要的描述,用于搜索结果和社交媒体预览。"
image: "images/backgrounds/favicon.webp"
comment: true
---
最佳实践
标题规范:
- 使用描述性、SEO 友好的标题
- 标题控制在 60 字以内,提升搜索可见性
- 统一使用标题格式
内容结构:
- 以简要介绍开头,说明读者将学到什么
- 使用清晰的标题(H2、H3)组织内容
- 包含代码示例并正确高亮
- 添加图片并设置描述性 alt 文本和合适尺寸
SEO 优化:
- 编写吸引人的 meta 描述(150-160 字)
- 使用相关标签和分类
- 包含指向相关内容的内部链接
- 图片优先使用 WebP 格式
博客文章结构示例:
---
title: "Istio 服务网格入门"
date: 2025-01-15T10:00:00+08:00
categories: [云原生]
tags: [Istio, Service Mesh, Kubernetes]
description: "学习如何在 Kubernetes 集群中安装和配置 Istio 服务网格,包含实用示例和最佳实践。"
---
## 简介
本文将介绍...
## 前置条件
- Kubernetes 集群(v1.20+)
- 已配置 kubectl
- 具备微服务基础知识
## 安装步骤
### 步骤 1:下载 Istio
```bash
curl -L https://istio.io/downloadIstio | sh -
```
### 步骤 2:安装 Istio
```bash
istioctl install --set values.defaultRevision=default
```
## 配置
详细配置步骤...
## 总结
回顾内容及后续建议...
书籍
书籍内容用于出版信息、书评及相关内容。
目录结构
content/[lang]/book/[book-slug]/
├── index.md # 书籍信息
├── cover.webp # 封面图片
└── chapters/ # 各章节(如有)
Front Matter 模板
---
title: "书名"
description: "简要介绍书籍及内容。"
category: "翻译 | 原创 | 评论"
date: 2023-07-01
type: publication
categories:
- 翻译
- 云原生
link: "https://example.com/book-link"
keywords:
- 关键词1
- 关键词2
- 关键词3
image: "cover.webp"
---
内容结构
## 编辑推荐
主要卖点与推荐理由...

{width=800 height=772}
## 概述
详细介绍书籍内容、目标读者及核心主题...
## 作者简介
作者背景与专业介绍...
## 译者简介(如适用)
译者信息...
## 目录(可选)
- 第一章:介绍
- 第二章:核心概念
- 第三章:高级主题
播客
播客内容包括音频节目、文字稿及用于 RSS 的元数据。
目录结构
content/[lang]/podcast/[episode-slug]/
├── index.md # 节目内容及文字稿
├── mindmap.md # 可选思维导图
└── images/ # 节目专属图片
Front Matter 模板
---
title: "节目标题"
date: 2025-05-18T08:12:03+08:00
draft: false
description: "吸引人的节目描述,将显示在播客目录和 RSS 中。"
tags:
- 主题1
- 主题2
categories:
- Jimmy 的播客
keywords:
- audio
- required
- 关键词1
- 关键词2
audio_url: "https://assets.jimmysong.io/podcasts/audios/ep-001.mp3"
audio_type: "audio/mpeg"
duration: "8:06"
audio_length: "4533959"
episode_image_url: "https://assets.jimmysong.io/podcasts/images/ep-001.jpg"
---
必填字段
- audio_url:音频文件直链(推荐 MP3)
- audio_type:MIME 类型(MP3 为 "audio/mpeg")
- duration:时长(MM:SS 或 HH:MM:SS)
- audio_length:文件字节数
- episode_image_url:节目封面(推荐 1400x1400px)
内容结构
关于本次播客所讨论内容有更详细的文章,见[相关文章标题](/blog/article-slug/)。以下为文字稿。
---
大家好,欢迎收听几米宋的播客...
[完整文字稿]
## 节目笔记(可选)
- [链接 1](https://example.com)
- [链接 2](https://example.com)
## 参考资料(可选)
- 参考 1
- 参考 2
音频文件要求
- 格式:推荐 MP3 或 M4A
- 质量:最低 128kbps,推荐 192kbps
- 声道:音乐用立体声,语音可用单声道
- 时长:无硬性限制,但需考虑听众体验
翻译
翻译内容用于转载或翻译其他来源的文章。
Front Matter 模板
---
title: "翻译文章标题"
linktitle: "简短标题(可选)"
date: 2025-01-15T10:00:00+08:00
draft: false
categories:
- 翻译
tags:
- 原主题
- 技术领域
description: "翻译内容及其相关性描述。"
source: "https://original-article-url.com"
image: "images/backgrounds/favicon.webp"
comment: true
---
最佳实践
- 必须包含
source
字段,注明原文链接 - 如有较大改动,添加译者说明
- 保持原文结构,适当本地化
- 标签需与内容主题相关
公告
公告用于发布通知、更新及重要信息。
Front Matter 模板
---
title: "公告标题"
date: 2025-01-15T10:00:00+08:00
draft: false
categories:
- 公告
tags:
- 更新
- 重要
description: "简要描述公告内容。"
---
旅行
旅行内容记录出行、体验及相关见解。
Front Matter 模板
---
title: "旅行目的地或体验"
date: 2025-01-15T10:00:00+08:00
draft: false
categories:
- 旅行
tags:
- 地点
- 体验类型
description: "旅行体验及亮点描述。"
image: "featured-image.webp"
---
内容创作流程
1. 规划阶段
- 明确内容类型与目标读者
- 充分调研主题
- 制定大纲,列出关键点
- 收集所需资源(图片、参考资料等)
2. 创作阶段
- 使用合适的 archetype:
hugo new content/[lang]/[type]/[slug]/index.md
- 填写准确的 Front Matter
- 按结构规范撰写内容
- 添加图片并优化(优先 WebP 格式)
3. 审核阶段
- 校对语法和拼写
- 检查所有链接和参考资料
- 核查图片 alt 文本和尺寸
- 使用
hugo server
本地测试内容
4. 发布阶段
- Front Matter 设置
draft: false
- 提交并推送更改
- 在线网站验证发布内容
图片规范
图片优化
- 优先使用 WebP 格式,压缩效果更佳
- 提供宽高属性:
{width=800 height=600}
- 添加描述性 alt 文本,提升无障碍体验
- 图片存放于内容包或统一资源目录
图片尺寸
- 主图:1200x630px(社交媒体最佳)
- 内容图片:最大宽度 800-1000px
- 缩略图:300x200px
- 播客封面:1400x1400px(正方形)
图片使用示例

{width=800 height=600}
SEO 最佳实践
元信息
- 标题吸引人(50-60 字)
- Meta 描述简明(150-160 字)
- 关键词自然融入内容
- 适用时添加结构化数据
内部链接
- 链接相关内容
- 使用描述性锚文本
- 通过链接形成主题集群
- 更新旧内容,补充新文章链接
性能优化
- 图片优化,提升加载速度
- 图片启用懒加载
- 减少外部依赖
- 定期测试页面加载速度
多语言内容
语言结构
- 英文内容:
content/en/
- 中文内容:
content/zh/
- 保持各语言结构一致
翻译规范
- 标题和描述需本地化,提升 SEO
- 文化内容适当调整
- 术语保持一致
- 日期格式按本地习惯
内容维护
日常任务
- 定期审查并更新过时信息
- 检查并修复失效链接
- 更新截图和示例
- 按需刷新 SEO 元数据
数据分析与监控
- 通过分析工具监控内容表现
- 跟踪用户参与度与反馈
- 挖掘热门内容,扩展相关主题
- 清理或重定向过时内容