Skip to content

内容类型指南

本指南为在 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"
---

内容结构

## 编辑推荐

主要卖点与推荐理由...

![书籍封面](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(正方形)

图片使用示例

![描述性 alt 文本](image-filename.webp)
{width=800 height=600}

SEO 最佳实践

元信息

  • 标题吸引人(50-60 字)
  • Meta 描述简明(150-160 字)
  • 关键词自然融入内容
  • 适用时添加结构化数据

内部链接

  • 链接相关内容
  • 使用描述性锚文本
  • 通过链接形成主题集群
  • 更新旧内容,补充新文章链接

性能优化

  • 图片优化,提升加载速度
  • 图片启用懒加载
  • 减少外部依赖
  • 定期测试页面加载速度

多语言内容

语言结构

  • 英文内容:content/en/
  • 中文内容:content/zh/
  • 保持各语言结构一致

翻译规范

  • 标题和描述需本地化,提升 SEO
  • 文化内容适当调整
  • 术语保持一致
  • 日期格式按本地习惯

内容维护

日常任务

  • 定期审查并更新过时信息
  • 检查并修复失效链接
  • 更新截图和示例
  • 按需刷新 SEO 元数据

数据分析与监控

  • 通过分析工具监控内容表现
  • 跟踪用户参与度与反馈
  • 挖掘热门内容,扩展相关主题
  • 清理或重定向过时内容

本指南为各类内容创作提供了高质量、统一规范的基础。如需技术细节或高级定制,请参考 开发者指南配置参考