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 许可证获得许可的开源软件。