hugo notepadium mod

Hugo-notepadium-mod

英語 | 中文 |現場演示|小張的博客

快速簡單的 Hugo 主題， 100% 無 JavaScript 。

• 介紹
• 特徵
  • 與原來的notepadium主題不同：
  • 其他特點
• 開始使用
  • 選項1
  • 選項2
• 配置主題
• 更新主題
• 自訂主題
• 謝謝
• 執照

介紹

Hugo 主題源自 Hugo-notepadium 的早期版本。

[WIP] 該專案和自述文件仍在進行中！如果您有任何疑問，可以聯絡我。

請求 Hugo 版本：0.68.0+

特徵

與原來的notepadium主題不同：

• 網格佈局（我可以使用網格嗎？）
• 標籤雲
• 目錄
• 資源的預連接與預取
• 內嵌關鍵CSS
• 雨果模組
• 存檔頁面
• 明暗主題切換按鈕
• 網站搜尋（由鸛驅動） 如何使用它？
• 更有用的 Hugo 短代碼
  • 提示區塊（警報訊息）
  • Markdown 中的簡單表格的 plist

其他特點

• 標識
• 導航項目
• 語法高亮
• 數學支持
• 支援大頁數分頁
• 光與暗
• 自訂 CSS 支持
• 自訂JS支持
• 自訂標題右側項目支持

開始使用

有兩種方法可以在 Hugo 網站上使用此主題。

選項1

使用 Hugo 模組。 Hugo Modules 由 Go Modules 提供支援。如果你已經安裝了Go，推薦這個選項。更多詳細資訊可以在 Hugo 文件中找到

1. 在站台根目錄中初始化hugo模組系統：

hugo mod init github.com/ < your_user > / < your_project >

2. 在 config.toml 中導入主題：

[ module ]
  [[ module . imports ]]
    path = " github.com/qdzhang/hugo-notepadium-mod "

選項2

使用 git 子模組。

1. 新增主題存儲庫作為 git 子模組

git submodule add https://github.com/qdzhang/hugo-notepadium-mod.git themes/hugo-notepadium-mod

2. 在 config.toml 中設定主題

 theme = " hugo-notepadium-mod " 

配置主題

幾乎所有內容都可以在網站的config.toml檔案中進行設定。如果您想修改主題，可以進入自訂主題

有一個範例config.toml ：

 baseURL = " https://www.example.com/ "
title = " Hugo-notepadium-mod "
copyright = " ©2021 hugo-notepadium-mod "

languageCode = " zh-cn "
hasCJKLanguage = true
defaultContentLanguage = " zh-cn "

enableRobotsTXT = true
paginate = 7  # The number of articles in per page
enableEmoji = true

# Enable Disqus
# disqusShortname = "XXX"

# Google Analytics
# googleAnalytics = "UA-123-45"


[ module ]
  [[ module . imports ]]
    path = " github.com/qdzhang/hugo-notepadium-mod "  # Use module to use this theme

[ minify ]
# Deploy with --minify command to minify assets
# Need Hugo version v0.68.0+
  disableCSS = false
  disableHTML = false
  disableJS = false
  disableJSON = false
  disableSVG = false
  disableXML = false
  minifyOutput = true
  [ minify . tdewolff ]
    [ minify . tdewolff . css ]
      keepCSS2 = true
      precision = 1
    [ minify . tdewolff . html ]
      keepComments = false
      keepConditionalComments = true
      keepDefaultAttrVals = true
      keepDocumentTags = true
      keepEndTags = true
      keepQuotes = false
      keepWhitespace = false
    [ minify . tdewolff . js ]
      keepVarNames = false
      precision = 1
    [ minify . tdewolff . json ]
      precision = 0
    [ minify . tdewolff . svg ]
      precision = 1
    [ minify . tdewolff . xml ]
      keepWhitespace = false

# Configure chroma highlight
# Reference https://gohugo.io/content-management/syntax-highlighting/
# https://gohugo.io/getting-started/configuration-markup#highlight
[ markup . highlight ]
codeFences = true
guessSyntax = true
noClasses = true
style = " dracula "

[ markup . goldmark . renderer ]
unsafe = true  # enable raw HTML in Markdown

[ markup . tableOfContents ]
    endLevel = 3
    ordered = false
    startLevel = 2

[ permalinks ]
  post = " /:year/:month/:title/ "

[ author ]
    name = "理头张"  # Change to your name


[ params ]
author = "理头张"
description = " littlezhang's blog "
style = " auto "  # default: auto. light: light theme, dark: dark theme, auto: based on system.
logo = " https://cdn.jsdelivr.net/gh/qdzhang/littlezhang.com/static/logo.png "
slogan = " "
# license = "<a rel=license href=http://creativecommons.org/licenses/by-nc-sa/4.0/><img alt=Creative Commons License style=border-width:0 src=https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png /></a><br />This work is licensed under a <a rel=license href=http://creativecommons.org/licenses/by-nc-sa/4.0/>Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License</a>."

# If you use custom css files, declare them here
[ params . assets ]
css = [ " css/fonts.css " , " css/custom.css " ]

[ params . comments ]
enable = false  # En/Disable comments globally, default: false. You can always enable comments on per page.

[ params . math ]
enable = false # load math globally, default: false. You can always enable math on per page.
use = " katex "  # builtin: "katex", "mathjax".  default: "katex"

[ params . nav ]
showCategories = false       # /categories/
showTags = false             # /tags/

# You can add taxonomies in there, then link new pages in [[params.nav.custom]]
# Reference https://gohugo.io/content-management/taxonomies/
[ taxonomies ]
  category = " categories "
  tag = " tags "

[[ params . nav . custom ]]
title = " Index "
url = " / "

[[ params . nav . custom ]]
title = " Tags "
url = " /tags/ "

[[ params . nav . custom ]]
title = " Archives "
url = " /archives/ "

[[ params . nav . custom ]]
title = " About "
url = " /about/ " 

更新主題

如果您透過 Hugo 模組安裝了主題

hugo mod get -u  # This will update all modules
hugo mod get -u github.com/qdzhang/hugo-notepadium-mod  # This will update current theme

如果你透過git子模組安裝了主題，先進入主題目錄，然後git pull

 cd themes/hugo-notepadium-mod && git pull

自訂主題

謝謝

• 雨果
• 雨果記事本
• 數學賈克斯
• 卡特克斯
• 鸛
• 一些受Kev Quirk啟發的簡約設計

執照

根據 MIT 許可證獲得許可的開源軟體。