网站内容架构与主页设计规范

🎯 学习目标
读完本文，你将了解：
本网站的内容分类体系及对应的物理目录结构。
如何通过 Frontmatter（元数据）为文章打好分类与标签。
如何利用 Hugo 的特性优化主页信息流，避免高频资讯刷屏。
网站导航菜单的标准化配置方案。

随着网站内容的不断丰富，包含高频的“行业快讯”、深度的“技术笔记”、“视频精读”以及“思考与随笔”等多元化内容。如果不加设计，高频短篇内容极易淹没低频深度内容，导致主页信息流混乱。

本文档定义了本网站（基于 Hugo + LoveIt 主题）的内容架构与主页设计规范，以“物理隔离 + 逻辑分类 + 主页分流”为核心策略，确保网站结构的清晰与读者体验的优良。

为了在本地编辑器（如 VSCode）中方便管理，所有对外发布的文章均存放在 content/posts/ 目录下，并按照核心业务板块划分物理子目录。

为什么不放在根目录？ 因为 LoveIt 主题的主页信息流默认只读取 posts 目录下的内容。将所有文章作为 posts 的子目录，既能被主页识别，又能保持本地工程的整洁。

标准目录结构：

content/
├── docs/                     # 存放基建说明、关于我等常青文档（不出现在主页信息流）
└── posts/                    # 所有的博客内容
    ├── news/                 # 【高频】每日行业快讯（含 AI、金融、Web3 等多领域资讯）
    ├── tech/                 # 【日常】技术学习与实战教程（含 AI 开发、智能合约、量化交易等）
    ├── video/                # 【日常】视频笔记与总结（含所有领域的视频精读）
    └── thoughts/             # 【低频】长篇思考、随笔与投资感悟

2. 逻辑分类与标签：构建内容骨架

物理目录用于后台管理，而前台的检索与聚合依赖于文章头部的 Frontmatter 声明。

Categories（分类）：宏观与内容载体

本站的宏观分类不再按“领域（AI/金融）”划分，而是按**“内容体裁（载体）”**划分，确保分类的互斥性与长效性。一篇文章强烈建议只归属一个分类。

["行业快讯"]：对应每日行业大事件、即时新闻等短平快内容。
["技术笔记"]：对应代码开发、架构解析、技术教程等硬核长文。
["视频精读"]：对应以搜集和总结视频内容为主的文章。
["思考与随笔"]：对应宏观分析、投资感悟、生活随笔等。

Tags（标签）：微观与业务领域（核心细分手段）

标签用于标记文章的具体业务领域和知识点，一篇文章可以有多个标签。这是读者跨板块横向探索的核心手段。

领域标签：["AI"], ["Web3"], ["传统金融"]。
技术标签：["ChatGPT"], ["LangChain"], ["Solidity"], ["Python"]。
组合示例：一篇关于“用 Python 写量化交易策略”的文章：categories: ["技术笔记"]，tags: ["传统金融", "Python", "量化交易"]。

Taxonomy 路由映射速查表

为避免分类页或标签页路径不一致，hugo.toml 建议显式配置：

[taxonomies]
  category = "categories"
  tag = "tags"

配置与 Frontmatter 的关系如下：

Frontmatter 字段	示例值	生成的聚合页	生成的详情页
`categories`	`["行业快讯"]`	`/categories/`	`/categories/行业快讯/`
`tags`	`["AI"]`	`/tags/`	`/tags/ai/`

当导航菜单中的 URL 指向分类详情页（如 /categories/行业快讯/）时，上述映射需要与菜单保持一致，才能确保页面可访问。

Taxonomy 404 三步排查清单

当分类详情页或标签详情页出现 404，可按以下顺序排查：

看构建产物是否存在页面文件
- 检查 public/categories/index.html、public/categories/行业快讯/index.html、public/tags/index.html。
看路由映射与导航是否一致
- 检查 hugo.toml 中 [taxonomies] 是否为 category = "categories"、tag = "tags"。
- 检查 [menu.main] 中的分类 URL 是否与 taxonomy 路径一致。
看部署结果是否完整发布
- 在 CI 中增加构建后 test -f 校验，避免缺页产物被上传。
- 部署后用线上 URL 验证 /categories/、/categories/行业快讯/、/tags/ 是否返回 200。

3. 主页分流与展示策略（核心机制）

为解决“新闻刷屏”和“优质文章沉底”的问题，我们采用以下三种机制来控制主页的内容呈现：

机制一：隐藏高频资讯，保护主页（`hiddenFromHomePage`）

由于“行业快讯”更新极快（日更），如果全部展示在主页，会严重稀释技术文章的浓度。

操作规范：在所有 news 目录下的快讯文章头部，必须添加 hiddenFromHomePage: true 属性。

---
title: "今日行业大事件汇总 (3月24日)"
date: 2026-03-24
categories: ["行业快讯"]
tags: ["AI", "大模型", "美股", "金融"]
hiddenFromHomePage: true  # 👈 核心指令：从主页信息流中剔除
---

效果：该文章不会出现在主页，但依然存在于“行业快讯”分类页、归档页及 RSS 订阅中，读者可通过导航栏专门去阅读。

机制二：利用权重置顶核心文章（`weight`）

对于耗费大量心血的万字长文或系统性指南，我们希望它能长期曝光在主页顶部。

操作规范：在需要置顶的文章头部，添加 weight 属性（数值越小，排名越靠前，1 为最高优先级）。

---
title: "2026年大语言模型应用开发终极指南"
weight: 1  # 👈 核心指令：全局置顶
---

机制三：顶部菜单直达板块（`hugo.toml` 配置）

修改根目录下的 hugo.toml，在 [menu] 节点下配置主导航，让读者一进网站就能按图索骥。

标准配置代码：

[menu]
  [[menu.main]]
    identifier = "news"
    name = "📰 行业快讯"
    url = "/categories/行业快讯/"
    weight = 1
  [[menu.main]]
    identifier = "tech"
    name = "💻 技术笔记"
    url = "/categories/技术笔记/"
    weight = 2
  [[menu.main]]
    identifier = "video"
    name = "🎬 视频精读"
    url = "/categories/视频精读/"
    weight = 3
  [[menu.main]]
    identifier = "thoughts"
    name = "🤔 思考与随笔"
    url = "/categories/思考与随笔/"
    weight = 4

4. 扩展规范：未来如何添加新内容类型？

随着网站发展，如果你想新增一个与现有四大板块并列的新内容类型（例如：“读书笔记”），请遵循以下标准扩容流程：

步骤一：创建物理目录

在 content/posts/ 下新建一个子文件夹，用于存放这类文章。

mkdir content/posts/book-reviews

步骤二：定义标准分类名（Category）

为这个新板块想一个固定且宏观的分类名称，例如 ["读书笔记"]。并在以后发布该类文章时，严格在 Frontmatter 中使用这个分类名。

步骤三：决定主页曝光策略

如果是低频、高价值文章（如长篇读后感）：不加特殊标记，让它自然出现在主页信息流中。
如果是高频、短篇碎碎念（如每日书摘）：必须在文章头部加上 hiddenFromHomePage: true，防止刷屏。

步骤四：处理多维度的聚合内容（如综合类资讯）

如果你的某个板块（例如“行业快讯”）未来不仅包含 AI，还包含了金融、Web3 等多个领域的快讯，不要为每一个细分领域的资讯去新建物理目录或宏观分类，这会导致网站结构极度碎片化。

正确的做法是**“保持宏观分类不变，通过多重标签（Tags）来细分”**：

物理目录：统一存放在 content/posts/news/ 下。
宏观分类（Categories）：使用包容性强的 ["行业快讯"]。

微观标签（Tags）：在 Frontmatter 中使用具体的标签来区分这篇资讯到底属于哪个领域。

# 示例：一篇包含 AI 和金融的综合早报
categories: ["行业快讯"]
tags: ["AI", "大模型", "美股", "金融"]
hiddenFromHomePage: true

这样，读者既可以通过主菜单的“📰 行业快讯”看到所有资讯的按天汇总，又可以通过点击“金融”标签，只看包含金融相关的资讯。

步骤五：添加到顶部导航（可选）

如果你认为这个新板块足够重要，希望用户一进站就能看到，请修改 hugo.toml 中的 [menu.main]，追加一个导航节点：

  [[menu.main]]
    identifier = "books"
    name = "📚 读书笔记"
    url = "/categories/读书笔记/"  # 注意：这里的 URL 必须与步骤二的分类名（URL编码后，通常是拼音或小写汉字）一致
    weight = 5  # 排在现有菜单之后

🏆 最终预期形态

遵循本规范后，网站将呈现出高度专业且有序的形态：

主导航：清晰划分四大板块，用户可直接点击跳转至分类聚合页。
主页信息流：
- 顶部固定展示 weight: 1 的核心重磅文章。
- 中部按时间倒序展示高质量的“技术笔记”、“视频精读”和“思考与随笔”。
- 零碎的“行业快讯”被自动过滤，保持了主页的干货纯度。
侧边栏/底部：通过 Tags 标签云，串联起全站的细碎知识点。

日常创作时，只需将文件放入对应的子目录，并正确书写 Frontmatter，即可自动维持这套精妙的架构。