| title | date | draft | nav_weight | series | categories | tags | images | authors | aliases | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
創建內容 |
2023-03-07 00:50:54 +0800 |
false |
1 |
|
|
|
|
|
內容是站點最基本，也是最核心的部分，本文將介紹內容的一些基本概念，以及如何創建內容。
{{% code-snippet structure %}}
以上內容結構具有：
- 四篇常規頁面：
blog/hello/,blog/foo/、blog/posts/post-1/和blog/posts/post-2/。 - 兩個 branch bundle (帶有
_index.md的目錄)：blog和posts。 - 三篇 branch 內容：
hello.md、posts/post-1.md和posts/post-2.md。 - 一個 leaf bundle （帶有
index.md的目錄）：foo。Leaf bundle 將作爲一篇常規頁面，其餘的內容將作爲其頁面資源，如foo/bar.md是一個頁面資源，而非單頁內容。
詳情請查閱 Content Organization 和 Page Bundles 。
通過 hugo new 命令創建內容。
hugo new blog/hello/index.md該命令將於 content 目錄下創建一個 blog/hello/index.md 的內容頁面，其初始內容類似如下：
---
title: "Hello"
date: 2023-03-08T11:02:23+08:00
draft: true
---{{< bs/alert >}}
{{< markdownify >}}
一般地，新創建的內容處於草稿階段（draft: true），在發佈之前，可以通過指定 hugo server 的 --buildDrafts 或 -D 參數進行預覽。當內容準備就緒，則需要將 draft 改爲 false 或者刪除 draft 以發佈該內容。
{{< /markdownify >}}
{{< /bs/alert >}}
內容原型是用於創建內容的模板，可以定義一些初始化的參數和內容，比如以下 notes 原型指定 type 爲 docs 以使用 docs 佈局。
{{% bs/collapse "archetypes/notes.md" primary true %}} {{% code-snippet archetype %}} {{% /bs/collapse %}}
當創建時，將會使用對應的模板生成初始內容。
{{% code-snippet archetype-result %}}
詳情請查閱原型。
每個內容頁面由前言和主體構成。
FRONT MATTER
CONTENT BODY也就是 Front Matter，用於定義內容的參數，如標題、日期、標籤、分類等。
Hugo 支持三種前言格式：YAML、TOML 和 JSON。
YAML 前言由 --- 包裹起來。
---
title: "Hello"
---TOML 前言由 +++ 包裹起來。
+++
title = "Hello"
+++JSON 前言由 { 和 } 包裹起來，後跟一個新行。
{
"title": "Hello"
}也就是字面上的內容本身，支持 Markdown 和短代碼編寫內容。