FeelIt主题内容管理完全指南

前言

FeelIt是一款功能强大的Hugo主题，为技术博客和内容创作提供了丰富的功能和优雅的展示方式。本文将深入解析FeelIt主题的内容管理机制，帮助您高效组织和管理网站内容。

内容组织结构

最佳实践建议

• 文章内容：建议存放在content/posts目录下，例如content/posts/我的第一篇文章.md
• 其他页面：如关于页面等，建议直接存放在content目录下，例如content/about.md

本地资源管理

FeelIt主题提供了三种引用本地资源（如图片、音乐等）的方式：

1. 页面资源包：使用Hugo的页面资源功能，可以通过Resources.GetMatch或相对于页面目录的文件路径直接引用
2. assets目录：资源存放在默认的/assets目录中，引用时使用相对于assets目录的路径
3. static目录：资源存放在默认的/static目录中，引用时使用相对于static目录的路径

这三种方式的优先级依次递减，主题中的多种功能都支持这种本地资源引用方式。

前置参数详解

基础参数

• title：内容标题
• subtitle：内容副标题（0.2.0版本新增）
• date：内容创建时间
• lastmod：内容最后修改时间
• draft：是否为草稿，true时需使用-D参数才能构建
• author：作者信息
• description：内容描述
• license：内容特殊许可

分类与标签

• tags：内容标签
• categories：内容分类
• featuredImage：特色图片
• featuredImagePreview：首页预览的特色图片

显示控制

• hiddenFromHomePage：是否在首页隐藏
• hiddenFromSearch：是否在搜索结果中隐藏（0.2.0版本新增）
• lightgallery：是否启用图片画廊
• linkToMarkdown：是否显示原始Markdown文件链接

功能扩展

• math：数学公式支持
• mapbox：地图功能配置
• comment：评论系统配置
• library：自定义CSS/JS库引入

内容摘要生成策略

FeelIt主题提供了多种摘要生成方式，优先级如下：

1. 手动摘要分隔符<!--more-->前无内容时，使用description作为摘要
2. 手动摘要分隔符<!--more-->前的内容
3. 前置参数中的summary字段
4. 自动截取前70个单词作为摘要

注意：不建议在摘要中包含富文本块元素（如代码块、图片、表格等），这可能导致排版问题。

Markdown扩展语法

数学公式支持

FeelIt主题基于KaTeX提供数学公式支持：

• 块级公式：使用$$公式$$或\\[公式\\]
• 行内公式：使用$公式$或\\(公式\\)

还支持以下扩展功能：

• Copy-tex：复制公式时自动复制LaTeX源码
• mhchem：化学方程式支持

特殊语法

• Ruby注释：[主文本]{?^}(注释文本)
• 分数表示：[分子]{?/}[分母]（0.2.0版本新增）
• Font Awesome图标：{?:}(fa-solid fa-icon-name)
• 转义字符：使用{{??}}转义特殊字符

实用技巧

1. 特色图片优化：可以通过页面资源方式设置特色图片，无需重复定义：

resources:
- name: featured-image
  src: 特色图片.webp

2. 多语言支持：CJK语言用户需在站点配置中设置hasCJKLanguage: true以获得更好的自动摘要效果

3. 代码高亮：主题内置了代码高亮功能，支持多种编程语言

通过合理利用这些功能和技巧，您可以充分发挥FeelIt主题的潜力，创建出专业、美观的技术内容。