hugo notepadium mod

Hugo-notepadium-mod

英語 | 中国語 |ライブデモ|リトルチャンのブログ

JavaScript を 100% 使用していない、高速でシンプルな Hugo テーマ。

• 導入
• 特徴
  • オリジナルの notepadium テーマとは異なります:
  • その他の機能
• 始めましょう
  • オプション 1
  • オプション 2
• テーマの構成
• テーマを更新する
• テーマのカスタマイズ
• ありがとう
• ライセンス

導入

Hugo-notepadium の初期バージョンからフォークされた Hugo テーマ。

[WIP] プロジェクトと Readme はまだ進行中です。ご質問がございましたら、ご連絡ください。

Hugo バージョンをリクエスト: 0.68.0+

特徴

オリジナルの notepadium テーマとは異なります:

• グリッドレイアウト（グリッドを使用できますか？）
• タグクラウド
• toc
• リソースの事前接続とプリフェッチ
• インラインクリティカルCSS
• ヒューゴモジュール
• アーカイブページ
• ライト＆ダークテーマ切り替えボタン
• サイト内検索 (powered by stork) 使い方は？
• さらに便利な Hugo ショートコード
  • ヒントブロック(警告メッセージ)
  • マークダウンの単純なテーブルの plist

その他の機能

• ロゴ
• ナビゲーション項目
• 構文の強調表示
• 数学のサポート
• 多数のページをサポートするページネーション
• ライト＆ダーク
• カスタムCSSのサポート
• カスタムJSのサポート
• カスタムヘッダー右項目のサポート

始めましょう

Hugo サイトでこのテーマを使用するには 2 つの方法があります。

オプション 1

Hugo モジュールを使用します。 Hugo モジュールは Go モジュールを利用しています。 Go をインストールしている場合は、このオプションをお勧めします。詳細については、Hugo Docs を参照してください。

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 submodule でテーマをインストールした場合は、まずテーマ ディレクトリに移動し、次にgit pull

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

テーマのカスタマイズ

ありがとう

• ヒューゴ
• ヒューゴノートパディウム
• マスジャックス
• カテックス
• コウノトリ
• Kev Quirkからインスピレーションを得たミニマルなデザイン

ライセンス

MIT ライセンスに基づいてライセンス供与されたオープンソース。