演示網站|變更日誌
Yue 是一個最小的、多語言的、可自訂的 Hugo 主題，適合部落格。
螢幕截圖可能已過時，因此最好訪問演示網站。
桌面上的燈光模式
桌面上的深色模式
手機上的燈光模式
手機上的深色模式
最小的外觀
易於安裝（安裝了 Git 和 Hugo，幾秒鐘內創建一個網站）
詳細文檔
自動深色模式
多種語言
單頁翻譯列表
語言選擇器（前往對應頁面或首頁）
多名作者
目錄（可折疊，僅在可用時產生）
首頁、單頁、章節頁和術語頁的修改日期
自訂日期格式
主頁和分區頁上的分頁
全文RSS
標籤和類別
版權聲明（可設定作者和年份跨度）
RSS 連結
標題錨鏈接
行動優先且響應迅速
社會保障體系
搜尋引擎優化
微觀數據
元描述
打開圖
各部分的頁數（ /posts/ 、 /tags/等）
客製化
網站圖示
樣式 (SCSS)
內容（HTML）
要了解所有功能，請檢查hugo.yaml（預設配置）和exampleSite/hugo.yaml（演示網站的配置）。
安裝 Git 和最新的 Hugo 擴充功能。
# 建立網站git init my-websitecd my-website# 安裝themegit子模組 add --depth=1 https://github.com/CyrusYip/hugo-theme-yue theme/hugo-theme-yue git commit --message "add theme"# 建立示範內容cp --recursive主題/hugo-theme-yue/exampleSite/* .# 預覽hugo伺服器
現在我們有了一個可以運行的示範網站。 content目錄包含內容， hugo.yaml是設定檔。隨意和他們一起玩。
cd 我的網站 git 子模組更新 --remote
建議在更新主題之前閱讀 CHANGELOG.md。
您可以在提要聚合器（例如 Inoreader）中訂閱更新和變更日誌。
更新：https://github.com/CyrusYip/hugo-theme-yue/commits/main.atom
變更日誌：https://github.com/CyrusYip/hugo-theme-yue/commits/main/CHANGELOG.md.atom
克隆網站專案時，您需要使用其他選項。
git clone --recurse-submodules --shallow-submodules [email protected]:your-user-name/my-website.git
設定網站後，您可能希望將其託管在 Internet 上。有很多方法可以做到這一點，請參閱託管和部署 |雨果.如果您不知道該選擇什麼，可以從 Netlify 開始，請參閱 Netlify 上的 Host |雨果.
確保在hugo.yaml中將baseURL更改為您的網域（例如https://my-cool-domain.org/ ）。
-baseURL：https://yue.cyrusyip.org/+baseURL：https://my-cool-domain.org/
推薦的建置命令：
雨果--gc--minify
--gc刪除未使用的快取文件， --minify減少網站的大小（主要是 HTML）。
建立一個新帖子。
hugo new content content/en/posts/my-first-post.md
要了解有關用法的更多信息，請參閱：
基本用法|雨果
目錄結構|雨果
設定列在 exampleSite/hugo.yaml （演示站點的配置）和hugo.yaml （預設配置，由前者導入）中。
在網站專案的根目錄中， hugo.yaml是設定文件，它是 exampleSite/hugo.yaml 的副本。
若要了解配置，請參閱配置 Hugo |雨果.
支援的語言：
en : 英語
fr : 法語
zh-CN ：簡體中文
若要建立多語言網站，請參閱多語言模式 | Hugo 和 exampleSite/hugo.yaml。
翻譯檔案位於 i18n 目錄和 data/i18n.yaml 中。歡迎對其他語言做出貢獻。
貢獻一種新語言：
在 i18n 目錄中建立語言檔案（例如，法語的fr.yaml ）。
將 i18n/en.yaml 的內容複製到新檔案中。
刪除所有註釋（ # ... ）並翻譯內容。
也翻譯 data/i18n.yaml 中的內容。
如果您想繼續為翻譯做出貢獻，可以透過訂閱 i18n/en.yaml 的 feed 來獲取最新更改（https://github.com/CyrusYip/hugo-theme-yue/commits/main/i18n/en.yaml .atom）使用RSS 閱讀器。
如果您的網站不是英文的，您可能需要自訂/tags和/categories的標題。
例如，自訂zh-CN網站的/tags標題，建立content/zh-CN/tags/_index.md ，並在檔案中新增以下內容。
--- title: Chinese Tags ---
Yue 可讓您自訂圖示、樣式 (SCSS) 和內容 (HTML)。
Favicon 是瀏覽器標籤中標題旁邊的圖示。若要使用您的 favicon，請將favicon.ico放在static目錄下。您可以在線上 favicon.ico 生成器上建立favicon.ico 。
Yue使用SCSS（libsass）來新增樣式。所有檔案都assets/scss/_style-end.scss assets/ assets/scss/_style-start.scss中。
首先套用_style-start.scss ，您可以覆寫此檔案中的變數。
$基本字體大小：15px；
_style-end.scss最後套用，您可以在此文件中新增樣式。
Vanilla CSS 在 SCSS 中也有效。
參考：
CSS：層疊樣式表 | MDN
Sass：Sass 基礎知識
目錄結構|雨果
您可以建立這些文件來插入 HTML 程式碼。
layouts/partials/head/head-start.html
layouts/partials/head/head-end.html
layouts/partials/single/single-end.html
layouts/partials/body/body-end.html
head-start.html加入到<head>元素的開頭附近。
使用案例：
預先載入腳本
載入腳本
載入樣式
以下是預先載入腳本的範例：
<link rel="preload" as="script" href="https://unpkg.com/@swup/head-plugin@2"><link rel="preload" as="script" href="https: //unpkg.com/@swup/preload-plugin@3"><link rel="preload" as="script" href="https://unpkg.com/swup@4">
head-end.html加入<head>元素的末端。
使用案例：
載入腳本
載入樣式
以下是新增 Google Analytics 和本機腳本的範例：
<!-- Google Analytics --><script async src="https://www.googletagmanager.com/gtag/js?id=G-F46B15BRUF"></script><script> window.dataLayer = window.dataLayer || []； 函數 gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'G-F46B15BRUF');</script><!-- 本地腳本，路徑：assets/js/my-script.js -->{{ with resources.Get "js/my-script .js" | js.Build }} <script defer src="{{ .RelPermalink }}"></script>{{ end }} single-end.html加入到帖子中<main>元素的末尾。
使用案例：
評論服務，例如 Disqus 和 giscus
以下是添加 Giscus 的範例：
{{ $語言 := "" }}
{{-/*
小寫 LanguagePrefix 的解決方法，
請參閱 https://github.com/gohugoio/hugo/issues/9404
*/-}}
{{ if eq site.LanguagePrefix "/zh-cn" }}
{{ $語言 = "zh-CN" }}
{{ 別的 }}
{{ $語言 = "en" }}
{{ end }}<script src="https://giscus.app/client.js" data-repo="CyrusYip/yue-test" data-repo-id="P_9hJMbXtqr" data-category="General" 數據-category-id="SIB_ldsflk712ldRsjf7" data-mapping="pathname" data-strict="0" data-reactions-enabled="1" data-emit-metadata="0" data-input-position="bottom" 數據-theme="preferred_color_scheme" data-lang="{{ $language }}" crossorigin="anonymous" async></script>評論服務清單： 評論 |雨果.
body-end.html加入<body>元素的末尾。
使用案例：
動態載入腳本
若要報告錯誤，請提交問題。要提出問題，請開始討論。
Hugo有很多功能，閱讀Hugo文件來學習。
請參閱 CHANGELOG.md。
此專案使用hugo-bin - npm 來管理Hugo 版本。先決條件：Node.js 和 npm。
克隆這個儲存庫。
npm 安裝 npm run clean:伺服器:共享
package.json 中列出了其他有用的命令。若要使用建議的 Hugo 版本，請執行npx hugo 。
如果您沒有安裝 Node.js 和 npm，只需安裝 package.json 中列出的版本即可。
"hugo-bin": { "buildTags": "擴展", "version": "x.yyy.z"},CHANGELOG.md 應在每次提交中更新。
如果您使用的是 Yue 並且您網站的源代碼託管在 GitHub 上，您可以將hugo-theme-yue主題添加到您的儲存庫中。
連結到hugo-theme-yue主題。
我從很多專案中學到了很多。謝謝你們，開發者。
Hugo-xmin（最小模板）
雨果主題簡（RSS 模板）
Hugo-theme-zen（語言選擇器）
雨果主題 gruvbox（顏色）
gruvbox（彩色）
Hugo-theme-stack（原始碼、文件和設定）
hugo-PaperMod（原始碼、文件和設定）
該計畫已獲得麻省理工學院的許可。
