Merge branch 'release' into develop

.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,48 @@
+---
+name: 错误报告(Bug Report)
+about: 没有达到预期的效果(Something isn't working as expected)
+labels: bug
+---
+
+请按照此 Issue 模版提供相关信息，例如源码仓库、网站链接和屏幕截图，这将有助于我们进行调查。
+(Please follow this Issue template to provide relevant information, such as source code repository, website URL and screenshots, which will help us investigate.)
+
+
+## 问题自检列表 (Issue Checklist)
+
+> 请确认如下情况已检查，并将 [ ] 换成 [x] 来选择 (Change [ ] to [x] to selected which your could make sure)
+
+- [ ] 已使用 Hugo Extended 0.86.0 或更高的版本 (I'm using Hugo Extended version 0.86.0 or later)
+- [ ] 已使用 Hugo NexT 4.0 或更高的版本 (I'm using Hugo NexT version 4.0 or later)
+- [ ] 已阅读 [Hugo 故障排除](https://gohugo.io/troubleshooting/)并尝试修复无果 (I had already read the [Troubleshooting page of Hugo](https://gohugo.io/troubleshooting/))
+- [ ] 已搜索过当前所有[已知问题](https://github.com/hugo-next/hugo-theme-next/issues)和[讨论区](https://github.com/hugo-next/hugo-theme-next/discussions/categories/q-a) ，但没有找到帮助 (I had already searched for current [Issues](https://github.com/hugo-next/hugo-theme-next/issues) and [Q & A](https://github.com/hugo-next/hugo-theme-next/discussions/categories/q-a), which does not help me.)
+
+***
+
+## 预期行为 (Expected behavior)
+
+> 请描述你想实现的预期效果 (Please describe the expected behavior what you want)
+
+
+## 实际行为 (Actual behavior)
+
+> 请同时提供网站链接、屏幕截图和源码地址 (Please provide your site links, screenshots and code repository)
+
+
+## 问题重现步骤 (Steps to reproduce the behavior)
+
+
+
+## 环境信息 (Environment Information)
+
+### 主题配置(Configuration)
+
+> 提供主题 `config.yaml` 中修改过的部分内容 (Paste ONLY CHANGED CONFIGURATION from  `config.yaml`)
+
+```yaml
+
+```
+
+## 其他有用信息 (Other Information)
+
+> 例如：操作系统、浏览器等 (e.g. Browser, System)

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: GitHub Discussions
+    url: https://github.com/hugo-next/hugo-theme-next/discussions/categories/q-a
+    about: 请在此处提问或回答问题(Please ask and answer questions here)

.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,15 @@
+---
+name: 新功能请求(Feature Request)
+about: Suggest an idea for this project
+labels: feature request
+---
+
+请按照此新功能模版提供相关信息，如详细的功能描述或同类效果屏幕截图，这将有助于我们进行调查。
+(Please follow this new feature template to provide relevant information, such as detail description for feature or some screenshots, which will help us investigate.)
+
+
+## 新功能描述 (New feature description)
+
+
+## 效果参考截图 (Screenshots if it possible)
+

README.md

@@ -1,16 +1,119 @@
-# Hugo theme of NexT
+[中文](README.zh.md) | [English](#)
 
-![hugo-next-primary](https://lisenhui.gitee.io/imgs/hugo-next/logo/hugo-next-primary.png)
+<a title="Hugo NexT Website" href="https://preview.hugo-next.eu.org">
+  <img align="center" alt="NexT logo" width="266" src="https://lisenhui.gitee.io/imgs/hugo-next/logo/hugo-next-primary.png">
+</a>
 
-Start a new journey for Hugo's theme of NexT.
+## Hugo NexT
 
-# Our Vision
+«Hugo NexT» is a high quality elegant [Hugo](https://gohugo.io) theme. Migrate it from `Hexo` engine themes which name is [`NexT`](https://github.com/next-theme/hexo-theme-next), keep all kind page layout designs and 4 different shcemes, start new journey with :heart: and hope you would like it.
 
-Make `NexT` theme is easily & powerful.
+> All page designs & configuration compatibility with Hexo NexT, it's very easy migrate your site from Hexo to Hugo and enjoy yourself.
 
-# Preview
+[![Gitter](https://img.shields.io/gitter/room/hugo-next/hugo-them-next?logo=gitter&style=flat-square)](https://gitter.im/hugo-next/community) [![Build Hugo Version](https://img.shields.io/badge/Hugo-%3E=0.86.0-red?style=flat-square&logo=hugo&color=%23FF4088)](https://github.com/gohugoio/hugo/releases/latest) [![GitHub deployments](https://img.shields.io/github/deployments/hugo-next/hugo-next.github.io/github-pages?style=flat-square&label=gh-pg&logo=GitHub)](https://github.com/hugo-next/hugo-theme-next) [![Repos Size](https://img.shields.io/github/repo-size/hugo-next/hugo-theme-next?style=flat-square&color=%23FFBF3B&logo=Files)](https://github.com/hugo-next/hugo-theme-next/find/main) [![GitHub](https://img.shields.io/github/license/hugo-next/hugo-theme-next?logo=webauthn&style=flat-square)](https://github.com/hugo-next/hugo-theme-next/blob/main/LICENSE)
+
+## 4 Scheme
+
+* :heart_decoration: Muse
+* :six_pointed_star: Mist
+* :pisces: Pisces
+* :gemini: Gemini (**default**)
+
+## Live Preview
 
 | Environment | :gemini: (**Default**) | :heart_decoration: | :six_pointed_star: | :pisces: | Status |
 | :---: | :---: | :---: | :---: | :---: | :---: |
 | Preliminary | [Gemini](https://preview.hugo-next.eu.org/) | [Muse](https://preview.hugo-next.eu.org/muse/) | [Mist](https://preview.hugo-next.eu.org/mist/) | [Pisces](https://preview.hugo-next.eu.org/pisces/) | ![Vercel](https://therealsujitk-vercel-badge.vercel.app/?app=preview-hugo-next&style=for-the-badge) |
 | Production | [Gemini](https://hugo-next.eu.org/) | [Muse](https://hugo-next.eu.org/muse/) | [Mist](https://hugo-next.eu.org/mist/) | [Pisces](https://hugo-next.eu.org/pisces/) | ![Vercel](https://therealsujitk-vercel-badge.vercel.app/?app=hugo-next&style=for-the-badge) |
+
+> Preliminary: all new feature developments will be previewed as soon as possible.
+> Production: Only the features that are tested stably and meet the requirements will be officially released.
+
+## Quick Start
+
+Before use `Hugo NexT` theme, please make sure installed `Git` & `Hugo Extened` software in your PC, then use `submodule` to lead into the theme, see below commands:
+
+```shell
+$ hugo new site hugo-next-exmaple
+$ cd hugo-next-exmaple
+$ git init
+$ hugo submodule add https://github.com/hugo-next/hugo-theme-next.git themes/hugo-theme-next
+$ cp -r themes/hugo-theme-next/exampleSite/* .
+$ rm -rf config.toml
+$ hugo server
+```
+
+Done that input adrress http://127.0.0.1:1313/ on browser will see the effect & good luck for you! :tada::tada::tada:
+
+## New Post
+
+There had ready a new post template for you,  It is recommended to use the following Hugo command to quickly create a new post:
+
+```sh
+$ hugo new posts/hello-world.md
+```
+
+Descript front matter in post as below:
+
+
+```yml
+---
+title: "{{ replace .Name "-" " " | title }}"
+description: "{{ .Name }}"
+keywords: "{{replace .Name "-" ","}}"
+
+date: {{ .Date }}
+lastmod: {{ .Date }}
+
+categories:
+ -
+tags:
+  -
+  -
+
+# Post's origin author name
+#author:
+# Post's origin link URL
+#link:
+# Image source link that will use in open graph and twitter card
+#imgs:
+# Expand content on the home page
+#expand: true
+# It's means that will redirecting to external links
+#extlink:
+# Switch to enabled or disabled comment plugins in this post
+#comment:
+# enable: false
+# Enable table of content
+#toc: false
+# Absolute link for visit
+#url: "{{ lower .Name }}.html"
+# Sticky post set-top in home page and the smaller nubmer will more forward.
+#weight: 1
+---
+```
+
+## Feedback
+
+- Join us [GitHub Discussions](https://github.com/hugo-next/hugo-theme-next/discussions) or [Gitter](https://gitter.im/hugo-next/community) to chat :beers:
+- [GitHub Issues](https://github.com/hugo-next/hugo-theme-next/issues/new?labels=Bug&template=bug-report.md) submit a new bug :bug:
+- [GitHub Feature](https://github.com/hugo-next/hugo-theme-next/issues/new?labels=Feature+Request&template=feature-request.md) tell me your ideas :sparkles:
+
+## Join us
+
+All features development progress and new request in [Hugo NexT V4 Roadmap](https://github.com/hugo-next/hugo-theme-next/issues/9), welcome to join us and compelete it together.
+
+## License
+
+[MIT License](LICENSE)
+
+## Thanks
+
+That's my hobby to develop `Hugo NexT` theme, thanks all people who gived the donate, and let we follow it growth up.
+
+List of Donors(Order by Date):
+
+| Donation time | Donors | Donation mode | Donation content | Message |
+| ------- | ------ | ------ | ---- | ---- |
+| 2021.12.21 | z*y | wechat pay | RMB 18.88 |  / |
+| 2022.05.08 | *泉 | wechat pay | RMB 6.60 | Good luck with next develop. |

README.zh.md

@@ -0,0 +1,125 @@
+[中文](#) | [English](README.md)
+
+<a title="Hugo NexT 站点" href="https://preview.hugo-next.eu.org">
+  <img align="center" alt="NexT logo" width="266" src="https://lisenhui.gitee.io/imgs/hugo-next/logo/hugo-next-primary.png">
+</a>
+
+## Hugo NexT
+
+«Hugo NexT» 是一款高质量且优雅的 [Hugo](https://gohugo.io) 主题，从原来 `Hexo` 引擎的 [`NexT`](https://github.com/next-theme/hexo-theme-next) 主题中移植过来，继续保留其经典的设计和 4 种不同页面布局模式，一切因 :heart: 重新出发愿你也能喜欢。
+
+> 本主题的所有页面设计和配置项都与原来 `Hexo` 引擎的 `NexT` 主题保持了良好的兼容性，可以非常平滑的从 `Hexo` 迁移至 `Hugo` 引擎，欢迎大家使用并反馈。
+
+[![Gitter](https://img.shields.io/gitter/room/hugo-next/hugo-them-next?logo=gitter&style=flat-square)](https://gitter.im/hugo-next/community) [![Build Hugo Version](https://img.shields.io/badge/Hugo-%3E=0.86.0-red?style=flat-square&logo=hugo&color=%23FF4088)](https://github.com/gohugoio/hugo/releases/latest) [![GitHub deployments](https://img.shields.io/github/deployments/hugo-next/hugo-next.github.io/github-pages?style=flat-square&label=gh-pg&logo=GitHub)](https://github.com/hugo-next/hugo-theme-next) [![Repos Size](https://img.shields.io/github/repo-size/hugo-next/hugo-theme-next?style=flat-square&color=%23FFBF3B&logo=Files)](https://github.com/hugo-next/hugo-theme-next/find/main) [![GitHub](https://img.shields.io/github/license/hugo-next/hugo-theme-next?logo=webauthn&style=flat-square)](https://github.com/hugo-next/hugo-theme-next/blob/main/LICENSE)
+
+## 4 种页面模式
+
+* :heart_decoration: 冥想 (Muse)
+* :six_pointed_star: 迷雾 (Mist)
+* :pisces: 双鱼座 (Pisces)
+* :gemini: 双子座 (Gemini) (**默认**)
+
+## 在线预览
+
+| 环境 | :gemini: (**Default**) | :heart_decoration: | :six_pointed_star: | :pisces: | 状态 |
+| :---: | :---: | :---: | :---: | :---: | :---: |
+| 开发版本 | [双子座](https://preview.hugo-next.eu.org/) | [冥想](https://preview.hugo-next.eu.org/muse/) | [迷雾](https://preview.hugo-next.eu.org/mist/) | [双鱼座](https://preview.hugo-next.eu.org/pisces/) | ![Vercel](https://therealsujitk-vercel-badge.vercel.app/?app=hugo-next&style=for-the-badge) |
+| 正式版本 | [双子座](https://hugo-next.eu.org/) | [冥想](https://hugo-next.eu.org/muse/) | [迷雾](https://hugo-next.eu.org/mist/) | [双鱼座](https://hugo-next.eu.org/pisces/) | ![Vercel](https://therealsujitk-vercel-badge.vercel.app/?app=hugo-next&style=for-the-badge) |
+
+> 开发版本： 所有的新功能开发都会在此第一时间发布预览
+> 正式版本： 只有测试稳定且符合要求的功能才会正式发布
+
+## 快速开始
+
+在使用 `Hugo NexT` 主题之前，请确认你的电脑上已经安装 `Git` 和 `Hugo Extened` 两款软件，然后通过 `submodule` 模式引用本主题，参考如下命令：
+
+```shell
+$ hugo new site hugo-next-exmaple
+$ cd hugo-next-exmaple
+$ git init
+$ hugo submodule add https://github.com/hugo-next/hugo-theme-next.git themes/hugo-theme-next
+$ cp -r themes/hugo-theme-next/exampleSite/* .
+$ rm -rf config.toml
+$ hugo server
+```
+打开浏览器，在地址栏输入 http://127.0.0.1:1313/ 查看主题效果，祝你好运！:tada::tada::tada:
+
+> 本主题的代码同时也同步到 `Gitee` 仓库，在国内环境可切换用 [https://gitee.com/hugo-next/hugo-theme-next.git](https://gitee.com/hugo-next/hugo-theme-next.git) 镜像速度更快，也更稳定。
+
+## 发表新文章
+
+主题已经配置了默认的文章模板，建议使用如下 Hugo 命令快速创建新的文章：
+
+```sh
+$ hugo new posts/hello-world.md
+```
+
+关于文章头部的那些标记作用的说明参考如下：
+
+
+```yml
+---
+# 文章标题
+title: "{{ replace .Name "-" " " | title }}"
+# 文章内容摘要
+description: "{{ .Name }}"
+# 文章内容关键字
+keywords: "{{replace .Name "-" ","}}"
+# 发表日期
+date: {{ .Date }}
+# 最后修改日期
+lastmod: {{ .Date }}
+# 分类
+categories:
+ -
+# 标签
+tags:
+  -
+  -
+
+# 原文作者
+#author:
+# 原文链接
+#link:
+# 图片链接，用在open graph和twitter卡片上
+#imgs:
+# 在首页展开内容
+#expand: true
+# 外部链接地址，访问时直接跳转
+#extlink:
+# 在当前页面开启或关闭评论功能
+#comment:
+# enable: false
+# 开启文章目录功能
+#toc: false
+# 绝对访问路径
+#url: "{{ lower .Name }}.html"
+# 开启文章置顶，数字越小越靠前
+#weight: 1
+---
+```
+
+## 使用反馈
+
+- 加入 [GitHub Discussions](https://github.com/hugo-next/hugo-theme-next/discussions) 或 [Gitter](https://gitter.im/hugo-next/community) 在线讨论 :beers:
+- [GitHub Issues](https://github.com/hugo-next/hugo-theme-next/issues/new?labels=Bug&template=bug-report.md) 提交错误报告 :bug:
+- [GitHub Feature](https://github.com/hugo-next/hugo-theme-next/issues/new?labels=Feature+Request&template=feature-request.md) 表新功能的想法 :sparkles:
+
+## 欢迎加入
+
+关于本主题的开发进度和后续的发展路线图，可访问 [Hugo NexT V4 Roadmap](https://github.com/hugo-next/hugo-theme-next/issues/9) 查看详情，也欢迎大家参与一起来完善。
+
+## 许可证
+
+[MIT License](LICENSE)
+
+## 致谢
+
+开发 `Hugo NexT` 主题原本是个人的业余爱好，但没想到网友们这么的热情，感谢有你们的支持，让我们一起来见证它的成长。
+
+以下是捐助名单列表（按时间顺序）：
+
+| 捐助时间 | 捐助者 | 捐助方式 | 捐助内容 | 留言 |
+| :-------: | ------ | ------ | ---- | ---- |
+| 2021.12.21 | z*y | 微信支付 | ¥18.88 | / |
+| 2022.05.08 | *泉 | 微信支付 | ¥6.60 | 祝开发next顺利 |

assets/css/_common/scaffolding/highlight/copy-code.scss

@@ -1,6 +1,3 @@
-.highlight:hover .copy-btn, pre:hover .copy-btn {
-  opacity: 1;
-}
 
 .highlight {
 
@@ -15,38 +12,45 @@
   }
 }
 
-.copy-btn {
+@if $codeblock_copy_btn_enable {
-  color: $black-dim;
-  cursor: pointer;
-  line-height: 1.6;
-  opacity: 0;
-  padding: 2px 6px;
-  position: absolute;
-  right: 8px;
-  top: 4px;
-  transition: opacity $transition-ease;
-  background: var(--highlight-background);
 
-  @if $codeblock_copy_btn_style == 'flat' {
+  .highlight:hover .copy-btn, pre:hover .copy-btn {
-    background: white;
+    opacity: 1;
-    border: 0;
+  }
-    font-size: $font-size-smaller;
 
-  } @else if $codeblock_copy_btn_style == 'mac' {
+  .copy-btn {
-    color: var(--highlight-foreground);
+    color: $black-dim;
-    font-size: 14px;
+    cursor: pointer;
-    border-radius: 3px;
+    line-height: 1.6;
-  } @else {
+    opacity: 0;
-    background-color: $gainsboro;
+    padding: 2px 6px;
-    background-image: linear-gradient(#fcfcfc, $gainsboro);
+    position: absolute;
-    border: 1px solid #d5d5d5;
+    right: 8px;
-    border-radius: 3px;
+    top: 4px;
-    font-size: $font-size-smaller;
+    transition: opacity $transition-ease;
+    background: var(--highlight-background);
 
+    @if $codeblock_style == 'flat' {
+      background: white;
+      border: 0;
+      font-size: $font-size-smaller;
+      
+    } @else if $codeblock_style == 'mac' {
+      color: var(--highlight-foreground);
+      font-size: 14px;
+      border-radius: 3px;
+    } @else {
+      background-color: $gainsboro;
+      background-image: linear-gradient(#fcfcfc, $gainsboro);
+      border: 1px solid #d5d5d5;
+      border-radius: 3px;
+      font-size: $font-size-smaller;
+      
+    }
   }
 }
 
-@if $codeblock_copy_btn_style == 'mac' {
+@if $codeblock_style == 'mac' {
   .highlight {
     border-radius: 5px;
     box-shadow: 0 10px 30px 0 rgba(0, 0, 0, .4);

assets/css/_common/scaffolding/highlight/index.scss

@@ -10,7 +10,7 @@ pre {
   margin: 0;
 }
 
-p > code {
+p > code, li > code {
   @extend %code-inline;
   border-radius: 3px;
   padding: 3px 6px;

assets/css/_schemes/Pisces/_sidebar.scss

@@ -83,7 +83,7 @@
   // Only when back2top.sidebar is true, apply the following styles
   .back-to-top {
     background: var(--body-bg-color);
-    margin: 8px - $sidebar-offset -10px -18px;
+    margin: 8px -#{$sidebar-offset} -10px -18px;
 
     &.back-to-top-on {
       margin-top: 16px;

assets/css/main.scss

@@ -52,7 +52,8 @@ $highlight_dark_foreground  : #fff;
 $highlight_light_background : #565656;
 $highlight_light_foreground : #fff;
 
-$codeblock_copy_btn_style   : {{ $P.codeblock.copyBtn.style }};
+$codeblock_copy_btn_enable   : {{ $P.codeblock.copyBtn }};
+$codeblock_style             : {{ $P.codeblock.style }};
 
 // Sidebar
 $sidebar_offset             : {{ $P.sidebar.offset }};
@@ -113,7 +114,9 @@ $reading_progress_reversed  : {{ $P.readingProgress.reversed }};
 
 // Thirdparty
 $math_mathjax_enable        : {{ $P.math.mathjax.enable }};
-$related_posts_enable       : {{ $P.relatedPosts.enable }};
+// TODO
+//$related_posts_enable       : {{ $P.relatedPosts.enable }};
+$related_posts_enable       : false;
 $pdf_enable                 : {{ $P.pdf.enable }};
 $pdf_height                 : {{ $P.pdf.height }};
 
@@ -122,14 +125,16 @@ $algolia_search_enable      : {{ $P.algoliaSearch.enable }};
 $local_search_enable        : {{ $P.localSearch.enable }};
 
 // Online IM
-$gitalk_enable              : {{ $P.gitalk.enable }};
+//$gitalk_enable              : {{ $P.gitalk.enable }};
+$gitalk_enable              : false;
 $gitter_enable              : {{ $P.gitter.enable }};
 
 // Comment
-$disqusjs_enable            : {{ $P.disqusjs.enable }};
+//$disqusjs_enable            : {{ $P.disqusjs.enable }};
-$livere_enable              : {{ $P.livere.enable }};
+$disqusjs_enable            : false;
-$utterances_enable          : {{ $P.utterances.enable }};
+$livere_enable              : {{ isset $P.livere "uid" }};
-$waline_enable              : {{ $P.waline.enable }};
+$utterances_enable          : {{ isset $P.utterances "utterances" }};
+$waline_enable              : {{ isset $P.waline "serverurl" }};
 {{- with .Site.Params.comments }}
 {{- $tce := and (isset . "nav") (and .storage (gt (len .nav) 1)) }}
 $two_comments_enable        : {{ $tce }};

assets/js/config.js

@@ -10,10 +10,9 @@ if (!window.NexT) window.NexT = {};
     "darkmode"   : {{ .Site.Params.darkmode }},
     "version"    : "{{ .Site.Data.config.version }}",
     "sidebar"    : {{ .Site.Params.sidebar | jsonify }},
-    "copycode"   : {{ .Site.Params.codeblock.copyBtn | jsonify }},
+    "copybtn"    : {{ .Site.Params.codeblock.copyBtn }},
     "bookmark"   : {{ .Site.Params.bookmark | jsonify }},
     "comments"   : {{ .Site.Params.comments | jsonify }},
-    "mediumzoom" : {{ .Site.Params.mediumzoom }},
     "lazyload"   : {{ .Site.Params.lazyload }},
     "pangu"      : {{ .Site.Params.pangu }},
     "stickytabs" : {{ .Site.Params.tabs.sticky }},

assets/js/next-boot.js

@@ -45,7 +45,7 @@ NexT.boot.refresh = function() {
   CONFIG.pangu && window.pangu.spacingPage();
 
   CONFIG.isPage && NexT.utils.replacePostCRLink();
-  CONFIG.isPage && NexT.utils.registerCopyCode();
+  CONFIG.isPage && CONFIG.copybtn && NexT.utils.registerCopyCode();
   NexT.utils.registerTabsTag();
   /*NexT.utils.registerActiveMenuItem();
   NexT.utils.registerLangSelect();*/

assets/js/utils.js

@@ -41,7 +41,7 @@ NexT.utils = {
    */
   registerCopyCode: function() {
     let figure = document.querySelectorAll('.highlight pre');
-    if (figure.length === 0 || !CONFIG.copycode) return;
+    if (figure.length === 0 || !CONFIG.copybtn) return;
     figure.forEach(element => {
       let cn = element.querySelector('code').className;
       // TODO seems hard code need find other ways fixed it.

exampleSite/content/about.en.md

@@ -1,19 +0,0 @@
----
-title: "About Hugo NexT Origination"
-description: ""
-
-date: 2022-06-09T20:12:52+08:00
-lastmod: 2022-06-09T20:12:52+08:00
-
-share: false
-followme: false
-nav: false
-copyright: false
-url: about.html
----
-
-`Hugo NexT` organization is formed by many friends from all over the world who love the theme and style of `NexT`, so that this theme can continue to be carried forward in the `Hugo` engine. Welcome to join us!
-
-# Our vision
-
-Keep the classic black-and-white collocation of `NexT` & keep easily and powerful features.

exampleSite/content/posts/hello-world.en.md

@@ -1,58 +0,0 @@
----
-title: "Hello World"
-description: "Descript some skill for Hugo build site."
-
-lastmod: 2022-06-03T16:43:23+08:00
-date: 2022-06-02T11:52:03+08:00
-
-categories:
- - Blog
-tags:
- - Hugo
- - Startup
-
-url: post/hello-world.html
-weight: 2
----
-
-> "Use keyword which is `weight` make post sticky to top."
-
-[Hugo](https://gohugo.io/) is one of the most popular open-source static site generators. With its amazing speed and flexibility, Hugo makes building websites fun again.
-
-<!--more-->
-
-## Quick Start
-
-### New Post
-
-```shell
-$ hugo new hello-world.md
-```
-
-More info: [Front formats](https://gohugo.io/content-management/formats/)
-
-### Server
-
-```shell
-$ hugo server
-```
-
-More info: [Hugo Server](https://gohugo.io/commands/hugo_server/)
-
-### Build
-
-```shell
-$ hugo
-```
-
-More Info: [Hugo Build](https://gohugo.io/commands/hugo/)
-
-### Deploy
-
-```shell
-$ hugo deploy
-```
-
-More Info：[Hugo Deployment](https://gohugo.io/commands/hugo_deploy/)
-
-Enjoy your Hugo journey & good luck for you!

exampleSite/start.sh

@@ -1,5 +1,6 @@
 #!/bin/bash
-#
+# 本地快速启动脚本
+# Quick start in local.
 
 next() {
     cat << EOT
@@ -11,8 +12,8 @@ next() {
   ██║ ╚████║███████╗██╔╝ ██╗   ██║
   ╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝   ╚═╝
 ========================================
-NexT version $1
+Hugo NexT version $1
-Documentation: https://hugo-next.js.org
+Documentation: https://hugo-next.eu.org
 ========================================
 EOT
 }

layouts/_default/_markup/render-link.html

@@ -1,5 +1,5 @@
-{{- $extURL := .Page.Site.Params.exturl.enable }}
+{{- $extURL := and .Page.Site.Params.exturl.enable (strings.HasPrefix .Destination "http") }}
-<a href="{{ .Destination | safeURL }}" title="{{ .Text }}" {{ if strings.HasPrefix .Destination "http" }}rel="noopener external nofollow noreferrer" target="_blank"{{ end }} {{ if $extURL }}class=" exturl"{{ end }}>
+<a href="{{ .Destination | safeURL }}" title="{{ .Text }}" {{ if $extURL }}rel="noopener external nofollow noreferrer" target="_blank" class=" exturl"{{ end }}>
     {{ .Text | safeHTML }}
     {{- if and $extURL .Page.Site.Params.exturl.icon }}
     <i class="fa fa-external-link-alt"></i>

layouts/_default/baseof.html

@@ -1,22 +1,8 @@
-{{- .Scratch.Set "postsCount" (len (where .Page.Site.RegularPages "Section" "in" .Site.Params.mainSections)) -}}
+{{- partial "init.html" . -}}
-{{- .Scratch.Set "catsCount" (len .Site.Taxonomies.categories) -}}
-{{- .Scratch.Set "tagsCount" (len .Site.Taxonomies.tags)  -}}
-{{- $vendors := .Site.Data.resources.vendors -}}
-{{- $pluginVen := .Site.Params.vendors.plugins -}}
-{{- $pluginCDN := index $vendors $pluginVen -}}
-{{- .Scratch.Set "pluginCDN" $pluginCDN -}}
 <!DOCTYPE html>
 <html lang="{{ .Site.LanguageCode }}">
 
 <head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width">
-  {{ hugo.Generator }}
-  <link rel="shortcut icon" type="image/x-icon" href="{{ .Site.Params.favicon.icon }}">
-  <link rel="icon" type="image/x-icon" href="{{ .Site.Params.favicon.icon }}">
-  <link rel="icon" type="image/png" sizes="16x16" href="{{ .Site.Params.favicon.small }}">
-  <link rel="icon" type="image/png" sizes="32x32" href="{{ .Site.Params.favicon.medium }}">
-  <link rel="apple-touch-icon" sizes="180x180" href="{{ .Site.Params.favicon.appleTouchIcon }}">
   {{- partial "head.html" . }}
   <title>{{ block "title" . }}{{ .Site.Title }}{{ end }}</title>
   <noscript>
@@ -48,11 +34,11 @@
   </main>
   <footer class="footer">
     <div class="footer-inner">
-      {{- partial "footer" . }}
+      {{- partial "footer.html" . }}
     </div>
   </footer>
 
-  {{- partial "scripts" . }}
+  {{- partialCached "scripts.html" . }}
 </body>
 
 </html>

layouts/partials/_thirdparty/analytics/51la.html

@@ -1,4 +1,2 @@
-{{- with .Site.Params.laId }} 
+<script charset="UTF-8" id="LA_COLLECT" src="https://sdk.51.la/js-sdk-pro.min.js"></script>
-<script charset="UTF-8" id="LA_COLLECT" src="//sdk.51.la/js-sdk-pro.min.js"></script>
 <script>LA.init({id: "{{ . }}",ck: "{{ . }}",autoTrack:true})</script>
-{{- end }}

layouts/partials/_thirdparty/comment/artalk.html

@@ -1,4 +1,3 @@
-{{- if .Site.Params.artalk.enable }}
 {{- with .Site.Params.artalk }}
 <link href="//unpkg.com/artalk@2.3.4/dist/Artalk.css" rel="stylesheet">
 <script src="//unpkg.com/artalk@2.3.4/dist/Artalk.js"></script>
@@ -18,5 +17,4 @@
   })
 </script>  
 {{- end }}
-{{- end }}
 

layouts/partials/_thirdparty/comment/giscus.html

@@ -0,0 +1,19 @@
+{{- with .Site.Params.giscus }}
+{{ printf "%t" (isset . "repo") }}
+<div class="giscus" style="position: relative;"></div>
+<script src="https://giscus.app/client.js"
+        data-repo="{{ .repo }}"
+        data-repo-id="{{ .repoId }}"
+        data-category="{{ .category }}"
+        data-category-id="{{ .categoryId }}"
+        data-mapping="{{ .mapping }}"
+        data-reactions-enabled="0"
+        data-emit-metadata="1"
+        data-input-position="{{ .inputPosition }}"
+        data-theme="{{ .theme }}"
+        data-lang="{{ $.Site.LanguageCode }}"
+        data-loading="lazy"
+        crossorigin="anonymous"
+        async>
+</script>        
+{{- end }}

layouts/partials/_thirdparty/comment/utterances.html

@@ -1,5 +1,4 @@
 {{- with .Site.Params.utterances }}
-{{- if .enable }}
 <script src="https://utteranc.es/client.js" 
 repo="{{ .repo }}" 
 issue-term="{{ .issueTerm }}" 
@@ -8,4 +7,3 @@ crossorigin="anonymous"
 theme="{{ .theme }}" async>
 </script>
 {{- end }}
-{{- end }}

layouts/partials/_thirdparty/comment/waline.html

@@ -1,4 +1,3 @@
-{{- if .Site.Params.waline.enable }}
 {{- with .Site.Params.waline }}
 <div id="waline"></div>
 
@@ -22,4 +21,3 @@
   });
 </script>
 {{- end }}
-{{- end }} 

layouts/partials/footer.html

@@ -48,8 +48,8 @@
 {{- end }}
 -->
 */}}
-{{- if .Site.Params.busuanzi.enable }}
+{{- with .Site.Params.busuanzi }}
-{{ with .Site.Params.busuanzi }}
+{{- if .enable }}
 <div class="busuanzi-count">
   {{- if .visitors }}
   <span class="post-meta-item" id="busuanzi_container_site_uv" title="{{ T "VisitorsLabel" }}">
@@ -76,12 +76,12 @@
 {{- end }}
 {{- if $ft.powered }}
 <div class="powered-by">
-  {{ $pb := printf "<a href='https://gohugo.io' target='_blank'>Hugo</a> &amp; <a href='https://github.com/hugo-next' target='_blank'>NexT.%s</a>" .Site.Params.scheme }}
+  {{ $pb := printf "<a href='https://gohugo.io' target='_blank'>Hugo</a> &amp; <a href='https://github.com/hugo-next/hugo-theme-next' target='_blank'>Hugo NexT.%s</a>" .Site.Params.scheme }}
   {{- printf (T "FooterPowerby") $pb | safeHTML }}
 </div>
 {{- end }}
-{{- if $ft.beian.enable }}
 {{- with $ft.beian }}
+{{- if .enable }}
 <div class="beian">
   <a href="https://beian.miit.gov.cn" target="_blank">{{ .icp }}</a>
   <img src="/imgs/gongan.png" alt="{{ .provinceAbbr }}公网安备">
@@ -90,6 +90,7 @@
 {{- end }}
 {{- end }}
 {{- with $ft.vendors }}
+{{ if .enable }}
 <div class="vendors-list">
   {{- range .list }}
     <a target="_blank" href="{{ .link }}" title="{{ .name }}">
@@ -103,3 +104,4 @@
    <span>{{ .title }}</span>
 </div>
 {{- end }} 
+{{- end }}

layouts/partials/head.html

@@ -3,6 +3,6 @@
 {{- partial "head/twitter.html" . }}
 {{- partial "head/googleplus.html" . }}
 {{- partial "head/facebook.html" . }}
-{{ partial "head/verify.html" . }}
+{{- partial "head/verify.html" . }}
-{{- partial "head/style.html" . }}
+{{- partialCached "head/style.html" . }}
-{{- partial "head/analytics.html" . }}
+{{- partialCached "head/analytics.html" . }}

layouts/partials/head/analytics.html

@@ -1 +1,5 @@
-{{- partial "_thirdparty/analytics/51la.html" . }}
+{{- with .Site.Params.analytics }}
+{{- if isset . "laid" }}
+  {{ partial "_thirdparty/analytics/51la.html" .laId }}  
+{{- end }}
+{{- end }}

layouts/partials/head/meta.html

@@ -1,3 +1,16 @@
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width">
+{{- if .Site.Params.darkmode }}
+<meta name="theme-color" content="{{ .Site.Params.themeColor.dark }}" media="(prefers-color-scheme: dark)" />
+{{- else }}
+<meta name="theme-color" content="{{ .Site.Params.themeColor.light }}" media="(prefers-color-scheme: light)" />
+{{- end }}
+{{ hugo.Generator }}
+<link rel="shortcut icon" type="image/x-icon" href="{{ .Site.Params.favicon.icon }}">
+<link rel="icon" type="image/x-icon" href="{{ .Site.Params.favicon.icon }}">
+<link rel="icon" type="image/png" sizes="16x16" href="{{ .Site.Params.favicon.small }}">
+<link rel="icon" type="image/png" sizes="32x32" href="{{ .Site.Params.favicon.medium }}">
+<link rel="apple-touch-icon" sizes="180x180" href="{{ .Site.Params.favicon.appleTouchIcon }}">
 <meta itemprop="name" content="{{ .Title }}" />
 <meta itemprop="description" content="{{ .Description | default .Site.Params.description }}" />
 {{- if .IsPage }}
@@ -15,8 +28,3 @@
 {{- .Scratch.Set "metaImg" $img }}
 <meta itemprop="image" content="{{ $img | absURL }}" />
 <meta itemprop="keywords" content="{{ if and .IsPage (isset .Params "tags")}}{{ delimit .Params.tags "," }}{{ else }}{{ .Site.Params.keywords }}{{ end }}" />
-{{- if .Site.Params.darkmode }}
-<meta name="theme-color" content="{{ .Site.Params.themeColor.dark }}" media="(prefers-color-scheme: dark)" />
-{{- else }}
-<meta name="theme-color" content="{{ .Site.Params.themeColor.light }}" media="(prefers-color-scheme: light)" />
-{{- end }}

layouts/partials/head/style.html

@@ -21,6 +21,9 @@
 {{- $scss := resources.Get "css/main.scss" }}
 {{- $scss = $scss | resources.ExecuteAsTemplate "main.scss" .  }}
 {{- $css := $scss | toCSS (dict "targetPath" "/css/main.css" "outputStyle" "expanded") }}
+{{- if hugo.IsProduction }}
+{{- $css = $css | minify | fingerprint }}
+{{- end }}
   <link rel="stylesheet" href="{{ $css.RelPermalink }}">
 {{- if .IsPage }}
   <style type="text/css">

layouts/partials/init.html

@@ -0,0 +1,14 @@
+{{/* Use to defind global variables */}}
+
+{{- if not hugo.IsExtended }}
+{{- warnf "Hugo NexT 主题使用了 SCSS 框架，请到官方地址下载 Hugo Extended 版本：https://github.com/gohugoio/hugo/releases" -}}  
+{{- errorf "Because that use SCSS framework in Hugo NexT, Please download Hugo extended version on offical site: https://github.com/gohugoio/hugo/releases" -}}  
+{{- end }}
+
+{{- .Scratch.Set "postsCount" (len (where .Page.Site.RegularPages "Section" "in" .Site.Params.mainSections)) -}}
+{{- .Scratch.Set "catsCount" (len .Site.Taxonomies.categories) -}}
+{{- .Scratch.Set "tagsCount" (len .Site.Taxonomies.tags)  -}}
+{{- $vendors := .Site.Data.resources.vendors -}}
+{{- $pluginVen := .Site.Params.vendors.plugins -}}
+{{- $pluginCDN := index $vendors $pluginVen -}}
+{{- .Scratch.Set "pluginCDN" $pluginCDN -}}

layouts/partials/post/footer_meta/reward.html

@@ -6,7 +6,7 @@
     {{- T "RewardDonate" -}}
   </button>
   <div class="post-reward">
-    {{- range $name,$img := $.Site.Params.reward }}
+    {{- range $name,$img := .reward }}
     {{- $fw := substr $name 0 1  }}
     {{- $pay := replace $name $fw ($fw | upper) 1 }}
     {{- $payName := T (printf "Reward%s" $pay) }}

layouts/partials/scripts.html

@@ -40,4 +40,7 @@
 {{- $nextjs = $nextjs | append $pjaxjs }}
 {{- end }}
 {{- $nextjs = $nextjs | resources.Concat "js/hugo-next.js"}}
+{{ if hugo.IsProduction }}
+{{- $nextjs = $nextjs | minify | fingerprint }}
+{{ end }}
 <script type="text/javascript" src="{{ $nextjs.RelPermalink }}" defer></script> 

theme.toml

@@ -6,7 +6,7 @@ homepage = "https://github.com/hugo-next/hugo-theme-next"
 tags = ["blog", "simple", "dark", "personal", "fast", "theme"]
 features = ["some", "awesome", "features"]
 min_version = "0.86.0"
-demosite = "https://lisenhui.cn"
+demosite = "https://preview.hugo-next.eu.org"
 
 [author]
   name = "lisenhui"