GETTING STARTED

術語表

A  B  C  D  E  F  G  H  I  K  L  M  N  O  P  R  S  T  U  V  W  Z 

action

請參閱 範本動作

archetype

為新內容提供的範本。詳情請參見詳細說明

argument

傳遞給 函式方法短代碼標量陣列切片映射物件

陣列

一組有編號的元素序列。與 Go 的 切片 數據類型不同,陣列具有固定長度。陣列內的 元素 可以是 標量、切片、映射、頁面或其他陣列。詳細內容請參見 Go 官方文件

布林值

請參見 布林值

布林值(Boolean)

一種類型的數據,僅有兩個可能值,即 truefalse

分支捆綁包

包含 _index.md 文件和零個或多個 資源 的目錄。類似於實體分支,分支捆綁包可能會有子孫,包括葉子捆綁包和其他分支捆綁包。頂層目錄是否包含 _index.md 文件也被視為分支捆綁包。這包括首頁。詳細說明請參見 這裡

構建

生成靜態網站,包括 HTML 文件和資源,如圖像、CSS 和 JavaScript。構建過程包含渲染和資源轉換。

捆綁包

請參見 頁面捆綁包

快取

一種軟體組件,用於存儲資料,以便日後對相同資料的請求更快速。

鏈式連接

在模板中,將一個或多個 標識符 用點連接。一個標識符可以表示方法、物件或欄位。例如,.Site.Params.author.name.Date.UTC.Hour

CJK

指的是中文、日文和韓文的統稱。詳見 詳情

命令行介面(CLI)

指的是命令行介面。

集合

一個 陣列切片映射

內容適配器

一個模板,根據遠程資料來源動態創建頁面。例如,可以使用內容適配器從 JSON、TOML、YAML 或 XML 等資料源創建頁面。詳細內容請參見 這裡

內容格式

用來創建內容的標記語言。通常是 Markdown,但也可以是 HTML、AsciiDoc、Org、Pandoc 或 reStructuredText 等。詳情請參見 這裡

內容類型

由頁面根目錄的名稱或 front matter 中設置的 type 所推斷出的內容分類。根目錄中的頁面,包括首頁,屬於 “頁面” 類型。可通過模板中的 .Page.Type 訪問。詳細內容請參見 這裡

內容視圖

通過 .Page.Render 方法調用的模板。詳情請參見 這裡

上下文

模板動作 中,由一個點(".")表示。上下文是當前資料結構中的位置。例如,在迭代頁面 集合 時,每次迭代中的上下文即為該頁面的資料結構。每個模板收到的上下文取決於模板類型及/或其被調用的方式。詳見 這裡

預設排序順序

頁面集合的預設排序順序。Hugo 根據 權重、接著是日期(降冪順序)、然後是鏈接標題,最後按文件路徑排序。

元素

切片或陣列中的一個成員。

環境

通常為 development(開發)、staging(測試)或 production(生產)之一,每個環境可能根據配置和模板邏輯展現不同的行為。例如,在生產環境中,可能會壓縮和加密 CSS,但在開發環境中這樣做通常是無意義的。

在使用 hugo server 命令運行內建開發伺服器時,環境設定為 development。使用 hugo 命令構建網站時,環境設定為 production。要覆寫環境值,可使用 --environment 命令列標誌或 HUGO_ENVIRONMENT 環境變數。

要在模板中確定當前環境,可使用 hugo.Environment 函式。

欄位

Front matter 中的預定義鍵值對,如 datetitle。詳見 參數

標誌

傳遞給命令行程式的選項,通常以一或兩個破折號開頭。詳見 這裡

浮點數

請參見 浮動點數

浮動點數(Floating Point)

一種類型的數據,其中有小數部分。例如 3.14159

片段

URL 的最後一部分,以井號(#)開始,引用 HTML 元素的 id 屬性。

Front matter

每個內容頁面開頭的元數據,與內容本身由特定格式的分隔符分開。詳見 這裡

函式

模板動作 中,函式接受一個或多個 參數 並返回一個值。與 方法 不同,函式並不與 物件 關聯。詳見 這裡

全域資源

位於資源目錄中的檔案,或位於任何 掛載 到資源目錄中的目錄下。使用 resources.Get, resources.GetMatch, resources.Matchresources.ByType 函式來抓取一個或多個全域資源。

無頭捆綁包

未發布的葉子或分支捆綁包,您可以將其內容和資源包含在其他頁面中。詳見 構建選項

標識符

表示變數、方法、物件或欄位的字串。必須符合 Go 的 語言規範,以字母或下劃線開頭,後接零個或多個字母、數字或下劃線。

整數

請參見 整數

整數(Integer)

一種不含小數部分的數字類型。例如 42

國際化

支持 本地化 的軟體設計與開發工作。詳見 W3C 定義。簡稱 i18n。

區間

一個數字區間,表示兩個端點之間的範圍:可以是閉區間、開區間或半開區間。

  • 閉區間,使用方括號表示,包含端點。例如,[0, 1] 就是 0 <= x <= 1 的區間。

  • 開區間,使用圓括號表示,不包含端點。例如,(0, 1)就是 0 < x < 1 的區間。

  • 半開區間,只包含其中一個端點。例如,(0, 1] 是 左開 區間,0 < x <= 1,而 [0, 1) 是 右開 區間,0 <= x < 1

類型

請參見 頁面類型

佈局

請參見 模板

葉包

包含一個 index.md 文件和零個或多個 資源 的目錄。類似於物理葉子,葉包位於分支的末端,沒有後代。詳情請見 此處

列表頁面

任何接收頁面 集合頁面類型,包含首頁、章節頁面分類頁面術語頁面

列表模板

任何渲染 列表頁面 的模板,包括 首頁章節分類術語 模板。

本地化

將網站適應於語言和地區需求的過程。這包括翻譯、語言專用的媒體、日期和貨幣格式等。詳情請參見 此處W3C 定義。簡稱 l10n。

邏輯路徑
New in v0.123.0

從文件路徑派生的頁面或頁面資源識別符,排除其擴展名和語言識別符。此值既不是文件路徑,也不是 URL。從相對於內容目錄的文件路徑開始,Hugo 通過去除文件擴展名和語言識別符,將其轉換為小寫,然後用連字符替換空格來確定邏輯路徑。詳見 範例

映射

一組無序的元素,每個元素由唯一的鍵索引。詳細資訊請參見 Go 文檔

Markdown 屬性

由一或多個鍵值對組成的屬性列表,使用空格或逗號分隔,並用大括號括起來。將 Markdown 屬性應用於圖像和區塊級元素,包括引用塊、圍欄代碼區塊、標題、水平線、列表、段落和表格。詳見 此處

序列化

將資料結構轉換為序列化的物件。例如,將 映射 轉換為 JSON 字串。詳見 反序列化

方法

模板動作 中使用,並與 物件 相關聯,一個方法接受零個或多個 參數,並返回一個值或執行一個動作。例如,.IsHome.Page 物件上的一個方法,如果當前頁面是首頁則返回 true。另見 函數

模塊

主題 一樣,模塊是封裝的組合,包含 範本、資源、內容、資料、翻譯表格、靜態文件或配置設定。一個模塊可以作為新網站的基礎,也可以增強現有網站的功能。詳見 此處

節點

包括 homesectiontaxonomyterm 的一類 頁面類型

無操作

“無操作”(noop)是指不執行任何動作的語句。

物件

具有或不具有相關聯的 方法 的資料結構。

有序分類法

通過對 分類 物件調用 AlphabeticalByCount 方法創建的,有序分類法是 切片,每個元素都是包含 術語 和其 加權頁面 切片的物件。

輸出格式

Hugo 在構建站點時,會為每個頁面生成一個或多個檔案。例如,在渲染首頁、區段分類法分類項 頁面時,Hugo 會生成一個 HTML 檔案和一個 RSS 檔案。HTML 和 RSS 都是內建的輸出格式
您可以建立多種輸出格式,並依據頁面類型,或啟用一個或多個頁面的輸出格式來控制檔案的生成。查看相關 詳細資料

頁面包

一個封裝了內容和相關 資源 的目錄。有兩種類型的頁面包:葉包分支包。詳見 此處

頁面集合

Page 物件的切片。

頁面類型

頁面的分類,為 homepagesectiontaxonomyterm 之一。詳見 此處

注意,還有 RSSsitemaprobotsTXT404 頁面類型,但這些頁面僅在渲染各自頁面類型的過程中可用,因此 在任何 Pages 集合中可用。

頁面資源

位於 頁面包 內的文件。通過調用 Page 物件上的任何 Resources 方法來捕獲一個或多個頁面資源。

頁面導航器

分頁 期間創建,包含部分列表頁面和導航鏈接至其他分頁的連結。

分頁

將列表頁面拆分為兩個或更多部分。

分頁處理

分頁處理過程。詳見 此處

分頁器

一組 分頁 物件。

參數

通常為用戶自定義的鍵值對,可在網站或頁面層級中定義,也可指配置設置或 參數。另見 欄位

部分

一個可以從其他模板調用的 模板,包括 短碼渲染鉤子 和其他部分。部分要麼渲染某些內容,要麼返回某些內容。部分還可以調用自身,例如,用於 遍歷 資料結構。

永久鏈接

已發佈資源或渲染頁面的絕對 URL,包括方案和主機。

管道

請參見 管道

管道處理

模板動作 中,一個管道是可能鏈接的數值序列、函數 調用或 方法 調用。管道中的函數和方法可以接受多個 參數

管道可以通過用管道字符 | 分隔命令序列來 “鏈接”。在鏈接的管道中,每個命令的結果將作為最後一個參數傳遞給下一個命令。管道的最終命令輸出的結果即為管道的值。詳見 Go 文檔

發佈

請參見 構建

常規頁面

具有 “頁面” 頁面類型 的內容。另見 章節頁面

相對永久鏈接

已發佈資源或渲染頁面的主機相對 URL。

渲染鉤子

覆蓋標準 Markdown 渲染的 模板。詳見 此處

遠程資源

位於遠程伺服器的文件,可通過 HTTP 或 HTTPS 使用 resources.GetRemote 函數訪問。

資源

任何在構建過程中被消耗的,用以增強或生成內容、結構、行為或呈現的文件。例如:圖像、視頻、內容片段、CSS、Sass、JavaScript 和數據。

Hugo 支援三種類型的資源:全局頁面遠程

資源類型

資源的主要 媒體類型。像 Markdown、HTML、AsciiDoc、Pandoc、reStructuredText 和 Emacs Org Mode 這樣的內容文件屬於 page 資源類型。其他資源類型包括 imagevideo 等。通過 ResourceType 方法在 Resource 物件上獲取資源類型。

標量

單一值,可能是 字串整數浮點數布林值

草稿板

從概念上看,草稿板是一個帶有 方法 用來設置、獲取、更新和刪除值的 映射。通過 ScratchStore 方法將數據結構附加到 Page 物件,或使用 newScratch 函數創建本地範疇的草稿板。

章節

頂層內容目錄,或具有 _index.md 文件的任何內容目錄。具有 _index.md 文件的內容目錄也稱為 分支包。章節模板會在 上下文 中接收一個或多個頁面 集合。詳見 此處

章節頁面

具有「section」頁面類型的內容。通常是列出 常規頁面 和/或 部分頁面 的頁面。

site

整個網頁或網站,包括所有內容、配置和模版。

sitemap

sitemap 生成的 XML 格式檔案,列出網站的頁面以協助搜尋引擎發現它們。

slice

在 Go 語言中的數據結構,用於存儲一組元素。與 array 類似,但具有更大的靈活性,元素數量可以變動。

static

存放靜態文件的資料夾,例如圖片、CSS、JavaScript 檔案等。這些檔案將直接從網站根目錄提供,而不會被 Hugo 進行處理。

string

字串數據類型。可以是字母數字字符、符號及任何 Unicode 字符的序列。

taxonomy

一種 頁面類型,通常用於組織頁面。例如,標籤和類別的結構化列表是典型的分類體系。在 Hugo 中,分類體系提供一個層次結構來根據內容的屬性(如標籤或分類)來排序頁面。

taxonomy page

具有「taxonomy」頁面類型的內容,通常用來列出具特定分類或標籤的頁面。

term page

具有「term」頁面類型的內容,通常用來顯示某一分類的特定術語。它也可以顯示與該術語相關的所有頁面列表。

theme

一組打包的文件和模板,包括網站的所有結構設置。這些模板決定了頁面渲染的方式。您可以創建自己的主題,也可以安裝現有的主題以用於 Hugo 網站。

unmarshal

將序列化的對象轉換回其原始數據結構。通常與 marshal 這個過程相對,unmarshal 將 JSON 字串等數據格式轉換為對應的數據結構。例如,將 JSON 字串解碼為 Go 語言中的對象。

update

刷新當前頁面,將頁面內容更新為新的版本。

URL

一致的網絡資源定位符,指向互聯網上任意資源的具體位置。URL 是檔案的完整路徑,包括其協議(如 HTTP)、網域、端口、路徑和查詢參數。

user interface (UI)

網站的界面,用戶與網站互動的部分。它包括所有前端元件,如按鈕、輸入框、列表、網頁模板等。

value

在程式中指定的一個實體,根據其數據型別可以是字符串、數字、布爾值或更多數據類型。值被變數和常量存儲並可被操作。

versioned content

能夠根據不同的版本管理和呈現的內容。例如,通過 Git 或其他版本控制系統進行管理的文檔和資料。

weight

在內容管理中,“權重” 是一種排序機制。數值較高的頁面將被優先排序。這個概念通常與頁面的顯示順序相關。

YAML front matter

在 Markdown 文件中,YAML 是在文件開頭用來定義元數據的格式。例如,頁面標題、作者、日期和其他有關該頁面的配置信息。

zero-indexed

計算位置的方式,指的是第一個元素的位置是 0,而非 1。這種方式通常用於許多程式語言中,包括 Go 和 JavaScript。

zip

一種資料壓縮格式,用於減少文件大小。zip 文件可以包含多個文件和資料夾,並能保持原始結構和檔案屬性。

generate

觸發或執行內容創建過程。通常指的是從原始資料或配置文件生成最終輸出的過程,例如將 Markdown 轉換為 HTML,或者生成靜態頁面並將其輸出到目標目錄。

每個網頁內容項目的固定網址。通常由網站管理系統生成並可配置。例如,/about//blog/post-title/ 就是永久鏈接的例子。

root

在系統或應用程序中的最頂層目錄或結構。對於網站來說,根目錄即網站的基本文件結構所在,通常是 index.html 或其他主要入口文件所在的位置。

reflow

指頁面元素或排版隨著內容變動或大小調整而重新排列的過程。例如,當用戶縮放頁面時,網站的排版可能會重新計算,以適應新的視圖區域大小。

region

指內容在頁面中的特定區域。在 web 開發中,常見的區域有頁眉(header)、主內容區域、頁腳(footer)等。

remove

移除或刪除內容、元素、數據等。可以是從列表中刪除元素、從頁面中刪除特定區域或從整個系統中移除某些文件。

replace

用新內容或數據替換舊的內容或數據。在許多情況下,這可以是內容更新的過程,通常是用新的值或元素來覆蓋現有的。

request

對服務器或系統提出的要求,通常表示客戶端向服務端發送信息以請求處理或查詢數據。對於 web 應用,請求通常指的是 HTTP 請求。

responsive

能夠根據不同的設備大小和屏幕分辨率調整顯示的頁面設計。響應式設計能保證網站無論在桌面、平板還是手機設備上都能提供良好的用戶體驗。

resource

任何可以在網絡上使用的內容或資源,通常指的是靜態文件(如圖片、視頻、CSS、JavaScript)或其他能支持網站功能的內容。

redirect

將用戶從當前頁面重新導向到其他頁面的過程。這是常見的網頁行為,通常由服務器或客戶端進行。

return

返回結果或數據,特別是從函數或方法中返回某些值。返回值在編程中是一個標準的概念,表示方法執行結果的傳遞。

route

網頁應用中定義的 URL 端點或路徑。每個路由都指向特定的頁面或動作,並且通常與 HTTP 請求的不同類型和 URL 地址相關聯。

row

在表格或列表中,行是指橫向排列的一個或多個元素。例如,數據庫中的每一行可以包含多個字段,每一行呈現一個數據項目。

scalar

指數據中只有單一值的元素。與結構化數據或數據集不同,標量數據通常指代字符串、整數或布爾值等非集合的單一數據。

set

一種資料結構,用來表示無序的元素集合。每個元素都是唯一的,不能有重複。在程式語言中,集合結構通常支持查詢、插入和刪除元素的操作。

shortcut

指向特定命令或位置的簡單方式,通常通過鍵盤快捷鍵或 UI 元素提供。例如,使用 Ctrl + C 進行複製是一個常見的快捷方式。

sidecar

在容器化應用程序中,sidecar 是一種輔助容器,它與主要容器一起運行,提供支持性功能(如日誌記錄、監控、代理等)。

single page application (SPA)

一種網站架構,其中所有的內容和視圖都加載在一個頁面中,並且頁面不需要重新加載整個網頁。這樣可以提供更流暢的使用體驗,通常使用 JavaScript 框架(如 React 或 Angular)來實現。

slug

在 URL 中用來識別單一頁面的短語或詞組。slug 通常是頁面標題的簡化或小寫版本,並且由連字符分隔。

split

將一個大元素或結構拆分成多個較小的部分。這可以是對字符串進行拆分,將一大段數據劃分成若干部分進行處理等。

staging

測試或準備環境,在正式發布之前檢查和驗證更改。通常在開發過程中的中間階段,用來檢查應用或網站是否準備好正式部署。

synchronize

使兩個或多個系統或數據集保持一致。這通常指的是多設備或多用戶協同工作的過程,確保每個實例都能夠及時更新並反映最新的狀態。

system

整個運行的技術架構,包括硬體、軟體、數據處理、用戶交互等,所有這些組成部分共同作用,以提供服務或完成功能。

template

一組預設結構,用於生成頁面或顯示內容。模板包括可重複使用的設計元素和佈局,它們支持動態內容的插入,適用於各種頁面生成。

thread

程式或進程中的執行路徑。每個線程都執行程式代碼的部分。多線程編程可實現並行或並發處理,提高應用程序的性能和效率。

token

一種特殊的標識符或代碼,常用於身份驗證、授權、或操作中,確保使用者可以執行受限或保護的操作。

type

數據的類型,決定該數據應該如何處理。常見的類型包括整型(int)、浮點型(float)、字符串(string)、布爾型(boolean)等。

unmarshal

將序列化的對象轉換為數據結構。例如,將 JSON 文件轉換為可以在模板中訪問的 映射。參見 marshal

variable

用戶定義的 標識符,前面加上 $ 符號,表示任何數據類型的值,並在 模板操作 中初始化或賦值。例如,$foo$bar 就是變量。

walk

遞歸地遍歷嵌套的數據結構。例如,渲染一個多層級的菜單。

weight

用於將元素根據權重排序並定位於集合中。使用非零整數來賦予權重,較輕的項目浮動至頂部,而較重的項目下沉到底部。沒有權重或權重大為零的元素將被放置在集合的末尾。權重通常用來為頁面、菜單項目、語言和輸出格式分配。

weighted page

包含於 Taxonomy 物件中的加權頁面,為一個 映射,其有兩個元素:一個 Page 物件,以及其在前置資訊中定義的 分類權重。可以使用 PageWeight 鍵來訪問這些元素。

zero time

“零時間”是公元 1 年 1 月 1 日 00:00:00 UTC。根據 RFC3339 格式化,零時間為 0001-01-01T00:00:00-00:00。