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)

一種類型的數據,僅有兩個可能值,即 true 或 false。

分支捆綁包

包含 _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 中的預定義鍵值對,如 date 或 title。詳見 參數。

標誌

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

浮點數

請參見 浮動點數。

浮動點數(Floating Point)

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

片段

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

Front matter

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

函式

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

全域資源

位於資源目錄中的檔案,或位於任何 掛載 到資源目錄中的目錄下。使用 resources.Get, resources.GetMatch, resources.Match 或 resources.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。另見 函數。

模塊

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

節點

包括 home、section、taxonomy 和 term 的一類 頁面類型。

無操作

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

物件

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

有序分類法

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

輸出格式

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

頁面包

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

頁面集合

Page 物件的切片。

頁面類型

頁面的分類,為 home、page、section、taxonomy 或 term 之一。詳見 此處。

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

頁面資源

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

頁面導航器

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

分頁

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

分頁處理

分頁處理過程。詳見 此處。

分頁器

一組 分頁 物件。

參數

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

部分

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

永久鏈接

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

管道

請參見 管道。

管道處理

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

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

發佈

請參見 構建。

常規頁面

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

相對永久鏈接

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

渲染鉤子

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

遠程資源

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

資源

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

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

資源類型

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

標量

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

草稿板

從概念上看,草稿板是一個帶有 方法 用來設置、獲取、更新和刪除值的 映射。通過 Scratch 或 Store 方法將數據結構附加到 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 物件,以及其在前置資訊中定義的 分類權重。可以使用 Page 和 Weight 鍵來訪問這些元素。

zero time

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