Hugo主题开发

hugo-xmin/
├── LICENSE.md
├── README.md
├── archetypes
│   └── default.md  ## 生成文章时的默认模板
├── layouts ## 布局
│   ├── 404.html ## 404页面
│   ├── _default ## 默认布局
│   │   ├── list.html ## 呈现页面列表的模板，例如博客文章列表或类别或标记中的页面列表
│   │   ├── single.html ## 单文章模板，即content/posts/*.md 使用的模板
│   │   └── terms.html ## 是分类术语主页的模板
│   └── partials ## 部分复用模板
│       ├── foot_custom.html
│       ├── footer.html
│       ├── head_custom.html
│       └── header.html
├── static
│   └── css ## css文件
│       ├── fonts.css
│       └── style.css
│   └── js ## js文件

<!--访问预定义变量-->
{{ .Title }}
{{ $address }}

<!--函数调用-->
{{ FUNCTION ARG1 ARG2 .. }}

<!--访问Markdown前言部分 Front matter variables-->
{{ .Params.bar }}

<!--使用括号分组-->
{{ if or (isset .Params "alt") (isset .Params "caption") }} Caption {{ end }}

<!--单个语句可以拆分多行-->
{{ if or
(isset .Params "alt")
(isset .Params "caption")
}}

<!--字符串可以包含换行-->
{{ $msg := `Line one.
Line two.` }}

<!--访问hugo预定义的变量-->
<title>{{ .Title }}</title>

<!--访问自定义变量要使用 $ , 可以使用 = 赋值-->
{{ $address := "123 Main St." }}
{{ $address }}

{{ add 1 2 }}
<!-- prints 3 -->


{{ lt 1 2 }}
<!-- prints true (i.e., since 1 is less than 2) -->

{{ partial "<PATH>/<PARTIAL>.<EXTENSION>" . }} 
<!--layouts/partials/header.html-->
{{ partial "header.html" . }}

{{ range $array }}
    {{ . }} <!-- The . represents an element in $array -->
{{ end }}


{{ range $elem_val := $array }}
{{ $elem_val }}
{{ end }}

<!--For an array or slice-->
{{ range $elem_index, $elem_val := $array }}
{{ $elem_index }} -- {{ $elem_val }}
{{ end }}

<!--判空执行else-->
{{ range $array }}
{{ . }}
{{ else }}
<!-- This is only evaluated if $array is empty -->
{{ end }}

<!--with ： if something exists, do this 
    如果不存在或者计算得到0（0，false，空）则跳过-->
{{ with .Params.title }}
<h4>{{ . }}</h4>
{{ end }}

<!--with-else-->
{{ with .Param "description" }}
{{ . }}
{{ else }}
{{ .Summary }}
{{ end }}

<!--if-->
{{ if isset .Params "title" }}
<h4>{{ index .Params "title" }}</h4>
{{ end }}

<!--if-else-->
{{ if (isset .Params "description") }}
{{ index .Params "description" }}
{{ else }}
{{ .Summary }}
{{ end }}

<!--if-elseif-else-->
{{ if (isset .Params "description") }}
{{ index .Params "description" }}
{{ else if (isset .Params "summary") }}
{{ index .Params "summary" }}
{{ else }}
{{ .Summary }}
{{ end }}


<!--and/or-->
{{ if (and (or (isset .Params "title") (isset .Params "caption")) (isset .Params "attr")) }}