了解如何组织和管理 NewBee 主题的内容。

组织内容

你的文章应该放在content/posts目录中，例如：content/posts/first-post.md，唯一不同的是关于页面，它放在content/about目录中，文件名为_index.md。

warning 新建完_index.md后记得把前置参数draft设为false。

本地资源存放在static目录中，例如：static/images/photo.jpeg。对于本地资源的引用，文件路径是相对于static目录的，例如：/images/photo.jpeg。

warning 引用时，文件路径中第一个/是必需的。

前置参数（Front Matter）

你可以在文章前面添加.toml、.yaml或者.json格式的前置参数。

• title: 文章标题。
• subtitle: 文章副标题.
• date: 这篇文章创建的日期。
• lastmod: 最近修改内容的日期。
• draft（草稿）: 在生成静态页面时，除非使用了hugo -D或者hugo --buildDrafts命令, 否则这篇文章将不会被渲染。
• description: 文章内容描述。
• image: 文章页首图片。
• tags: 文章标签。
• categories: 文章所属类别。
• series: 文章所属系列。

示例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

---
title: "内容管理"
subtitle: "更好的管理你的内容"
date: 2022-05-01T16:19:04+08:00
lastmod: "2022-10-01"
draft: true
description: "我是文章的描述"
image: "/images/book.jpg"
tags: ["NewBee", "主题", "Hugo"]
categories: ["主题文档"]
series: ["主题文档"]
---

内容摘要

在主页或者文章页面里小卡片会使用到内容的摘要来显示文章大致信息。Hugo 默认会将内容的前 70 个单词作为摘要，此默认摘要的字数可以在config.toml文件中设置summaryLength的值来更改。

如果你不满足于默认生成的摘要，还有 2 种方法来指定内容摘要：

::: tabs

@tab 方法1

使用<!--more-->分割符：

在你需要的地方插入<!--more-->分割符后，可以将它与前置参数之间的内容作为内容摘要。

@tab 方法2

使用前置参数summary：

例如

1

summary: "我是摘要"

warning 这种方法的摘要不会在正文中出现。如果有<!--more-->分割符，参数summary是无效的，即使<!--more-->前没有任何内容。当两者都没有时则为默认摘要。

:::

目录

如果你的文章内容里有标题，则需要从一级标题开始，如果只有二级标题的话，侧边栏的目录将不能正确生成。目前最多支持两级标题，即一级和二级。

Markdown 基本语法

关于 Markdown 基本语法，请参考官方教程。

markdown 扩展语法

NewBee 扩展的 Markdown 语法，详见：Markdown 扩展语法