
了解如何组织和管理 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: 文章所属系列。
- hideFromHomePage: 将文章从主页隐藏。
示例:
|
|
内容摘要
在主页或者文章页面里小卡片会使用到内容的摘要来显示文章大致信息。Hugo 默认会将内容的前 70 个单词作为摘要,此默认摘要的字数可以在hugo.toml
文件中设置summaryLength
的值来更改。
如果你不满足于默认生成的摘要,还有 2 种方法来指定内容摘要:
::: tabs
@tab 方法1
使用<!--more-->
分割符:
在你需要的地方插入<!--more-->
分割符后,可以将它与前置参数之间的内容作为内容摘要。
@tab 方法2
使用前置参数summary
:
|
|
warning 这种方法的摘要不会在正文中出现。如果有
<!--more-->
分割符,参数summary
是无效的,即使<!--more-->
前没有任何内容。当两者都没有时则为默认摘要。
:::
目录
如果你的文章内容里有标题,则需要从一级标题开始,如果只有二级标题的话,侧边栏的目录将不能正确生成。目前最多支持两级标题,即一级和二级。
Markdown 基本语法
关于 Markdown 基本语法,请参考官方教程。
markdown 扩展语法
NewBee 扩展的 Markdown 语法,详见:Markdown 扩展语法
