術語表
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。
渲染鉤子
遠程資源
位於遠程伺服器的文件,可通過 HTTP 或 HTTPS 使用 resources.GetRemote
函數訪問。
資源
任何在構建過程中被消耗的,用以增強或生成內容、結構、行為或呈現的文件。例如:圖像、視頻、內容片段、CSS、Sass、JavaScript 和數據。
資源類型
資源的主要 媒體類型。像 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,或者生成靜態頁面並將其輸出到目標目錄。
permalink
每個網頁內容項目的固定網址。通常由網站管理系統生成並可配置。例如,/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。