hugo notepadium mod

Hugo-notepadium-mod

Anglais | Chine | Démo en direct | le blog de Littlezhang

Un thème Hugo simple et rapide, 100% sans JavaScript .

• Introduire
• Caractéristiques
  • Différent du thème original du bloc-notes :
  • Autres fonctionnalités
• Commencez
  • Option 1
  • Option 2
• Configurer le thème
• Mettre à jour le thème
• Personnaliser le thème
• Merci
• Licence

Introduire

Un thème Hugo dérivé de la première version de Hugo-notepadium.

[WIP] Le projet et le fichier readme sont toujours en cours ! Vous pouvez me contacter si vous avez des questions.

Demander la version Hugo : 0.68.0+

Caractéristiques

Différent du thème original du bloc-notes :

• disposition en grille (Puis-je utiliser la grille ?)
• nuage de tags
• toc
• préconnecter et pré-extraire les ressources
• CSS critique en ligne
• module Hugo
• page d'archives
• bouton bascule thème clair et sombre
• recherche sur le site (propulsé par stork) Comment l'utiliser ?
• des shortcodes Hugo plus utiles
  • blocs de conseils (messages d'alerte)
  • plist pour un tableau simple en markdown

Autres fonctionnalités

• Logo
• Éléments de navigation
• Mise en évidence de la syntaxe
• Soutien aux mathématiques
• Pagination avec un grand nombre de pages prenant en charge
• Lumière et obscurité
• Prise en charge CSS personnalisée
• Prise en charge de JS personnalisé
• Éléments de droite d'en-tête personnalisés prenant en charge

Commencez

Il existe deux façons d’utiliser ce thème pour le site Hugo.

Option 1

Utilisez les modules Hugo. Hugo Modules est alimenté par Go Modules. Si vous avez installé Go, cette option est recommandée . Plus de détails peuvent être trouvés dans Hugo Docs

1. Initialisez le système de modules Hugo à la racine de votre site :

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

2. Importez le thème dans votre config.toml :

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

Option 2

Utilisez le sous-module git.

1. Ajouter un référentiel de thèmes en tant que sous-module git

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

2. Définissez le thème dans votre config.toml

 theme = " hugo-notepadium-mod " 

Configurer le thème

Presque tout peut être configuré dans le fichier config.toml de votre site. Si vous souhaitez modifier le thème, vous pouvez aller dans Personnaliser le thème

Il y a un exemple 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/ " 

Mettre à jour le thème

Si vous avez installé le module thème par 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

Si vous avez installé le thème via le sous-module git, allez d'abord dans le répertoire du thème, puis git pull

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

Personnaliser le thème

Merci

• Hugo
• Hugo-Notepadium
• MathJax
• Katex
• cigogne
• Quelques designs minimaux inspirés de Kev Quirk

Licence

Open source sous licence MIT.