/EarlGrey

放置markdown筆記用的HUGO主題

Primary LanguageCSS

Earl Grey

Earl Grey是HUGO靜態網頁生成器的佈景主題,響應式、極簡風格、使用左側欄菜單。一開始單純是做來放置自己的markdown筆記,想想還是就拿來獻醜吧,有需要的歡迎取用,放這邊就是開源的意思,想怎樣修改都行。

[中文展示頁面]

緩慢建置ing,有些功能尚未加上去。

特色

  • 響應式,側欄在螢幕寬度低於992px會自動隱藏
  • 亮暗色系切換
  • 支援Algolia站內搜索
  • 自動生成文章目錄,閱覽文章時可隨時從側欄查看目錄
  • 支援分類(category)、標籤(tag)
  • 三種歸檔頁(archive):按照年份分組、按照分類分組、按照標籤分組
  • 可顯示最首最末頁的分頁器
  • 支援圖片燈箱:Simple Lightbox
  • 支援數學符號:MathJax
  • 支援圖表語言:Mermaid

安裝Earl Grey主題

透過終端下載Earl Grey

git clone https://github.com/offrecordrae/EarlGrey.git themes/EarlGrey

修改根目錄/config.toml

baseURL = "/"
languageCode = "en-us"
title = "標題"
theme = "EarlGrey"
paginate = 5 # 每頁顯示的文章數

[markup]
[markup.goldmark]
[markup.goldmark.renderer]
unsafe = true # 渲染文章內含的html語言
[markup.tableOfContents]
endLevel = 3 # 目錄生成最後級數
ordered = false
startLevel = 1 # 目錄生成最首級數

md文章內容放置路徑:根目錄/content/posts

增加歸檔頁

操作步驟請參考主題說明頁

安裝站內搜索

操作步驟請參考主題說明頁

建置環境

工具 提供者 版本 掛載來源
靜態網頁生成器 HUGO 0.80.0
CSS框架 W3.CSS 4.13 W3.CSS
程式腳本 JQuery 3.5.1 cdnjs
圖標套件 FontAwesome 5.15.1 cdnjs

測試環境

  • 瀏覽器
    • Chrome 87.0.4280.141
    • Edge 87.0.664.75
    • Firefox 84.0.2
  • 系統
    • Windows 10
    • Android 9 | 7.1.1

特別感謝

在主題中使用的許多程式語言都取自其他網站。

援引部份 來源 作者
GO語言相關框架 Hugo theme: Mainroad Vimux
MathJax與Mermaid的markup 零壹軒筆記 匿蟒
圖片燈箱 Simple Lightbox Damir Breakalo
分頁器 Pagination模版 Joe Mooring、Bjørn Erik Pedersen、Cameron Moore、Mark Mandel、Anthony Fok
亮暗色系切換 dev.to/ananyaneogi Ananya Neogi
外部連結開新分頁 Victor Hung's Diary Victor Hung

關於我

綽號喇叭子,本業是搞畫圖的,腦子和程式/網頁語言基本沒什麼緣份,只是當興趣偶而摸兩下。

個人網站 - OFF RECORD