全站 Site

网址:.Site.BaseURL

标题:.Site.Title,示例:

<a href="{{ $.Site.BaseURL }}">{{ $.Site.Title }}</a>

副标题:.Site.Params.description

关键词:.Site.Params.keywords

头部菜单:

{{ range $.Site.Menus.main }}
	<li><a href="{{ .URL }}">{{ .Name }}</a></li>
{{ end }}

config.toml配置示例:

baseURL  =  "https://immmmm.com"
title  =  "木木木木木"
[params]
	description = "不问明天,悠然浪费"
	keywords = "博客、主题、折腾、生活"
[menu]
	[[menu.main]]
		name="首页"
		url="/"
		weight="1"
	[[menu.main]]
		name="关于"
		url="/about"
		weight="2"

全站标签列表及文章数量:

{{- range $name, $taxonomy := .Site.Taxonomies.tags -}}
	<a href="/tags/{{ $name | urlize }}">#{{ $name }}<small>({{ .Count }})</small></a>
{{- end -}}

全站文章数:

共 {{ len (where .Site.RegularPages "Section" "posts") }} 篇日志

文章列表 List

文章摘要:.Summary 文章列表会显示 <!--more--> 前的内容或自动截断。

{{ .Summary | plainify }}

config.toml配置阶段字符,默认 70 个:

summaryLength = 140

截断判断:.Truncated 如果有 more 标签,则 true,显示“阅读全文”字样。

指定 content/posts 为文章内容,且自动截断:

{{  $paginator := .Paginate (where .Site.RegularPages "Type" "posts") }}
{{ range $paginator.Pages }}
<article class="post">
  <h1 class="post-title"><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
  <time class="post-date">{{ .Date.Format "2006-01-02T15:04:05" }}</time>
  <div class="post-content">
 	 {{ .Summary }}
   </div>
  {{ if .Truncated }}
  <div class="read-more">
    <a href="{{ .Permalink }}">阅读全文…</a>
  </div>
  {{ end }}
</article>
{{- end }}

神奇的日期格式化:"2006-01-02 15:04:05" 表示显示年月日时分秒

文章列表分页:

<div class="pagination">
  {{ if .Paginator.HasPrev }}
    <a href="{{ .Paginator.Prev.URL }}">上一页</a>
  {{ end }}
  {{ if .Paginator.HasNext }}
    <a href="{{ .Paginator.Next.URL }}">下一页</a>
  {{ end }}
</div>

文章 Single

标题、链接、时间,同上。

全文内容:.Content

文字数:.WordCount,配合config.toml中文统计更准确:

hasCJKLanguage = true

阅读时间:.ReadingTime,示例:

约{{ .ReadingTime }}分钟读完

分类 .Params.categories 标签 .Params.tags,示例:

{{ if .Params.tags }}
	<span class="post-tags">
	{{ range .Params.tags }}
		#<a href="{{ (urlize (printf "tags/%s" . )) | absURL }}/">{{ . }}</a>&nbsp;
	{{ end }}
	</span>
{{ end }}

上、下文章链接标题,示例:

<div class="pagination">
	{{ if .NextInSection }}
		<a href="{{ .NextInSection.Permalink }}">{{ .NextInSection.Title }}</a>
	{{ end }}
	{{ if .PrevInSection }}
		<a href="{{ .PrevInSection.Permalink }}">{{ .PrevInSection.Title }}</a>
	{{ end }}
</div>

其他片段

当前年份,示例:{{ now.Year }}

页面类型:{{ .Section }}

首页判断:

{{ if .IsHome }}
	……
{{ end }}
{{ if not .IsHome }}……{{ end }}

定义变量:

{{ $address := "123 Main St." }}
{{ $address }}

定义模块,如 layouts/_default/baseof.html

{{ block "main" . }}
{{ end }}

layouts/_default/list.html

{{ define "main" }}
  ……
{{ end }}

短代码 Shortcodes

LoveIt 主题内置数十种短代码:https://hugoloveit.com/zh-cn/theme-documentation-shortcodes/

未完

待更…… 🤷‍♂️