Romych: /* Дополнительно — информация из frontmatter термина */

2020-05-25T10:38:58Z

Дополнительно — информация из frontmatter термина

Нова сторінка

←[[Hugo]]

== Страница словаря со списком терминов (terms) ==

Например, есть словарь <code>categories</code>, заданный в <code>config.toml</code> так:

<source lang="json">
[taxonomies]
category = "categories"
</source>

Важно различать единственную и множественную форму названия словаря. В примерах дальше они выделены полужирным.

Словари нужно специально прописывать в <code>config.toml</code>, а термины, относящиеся к словарям, не нужно. Для создания термина достаточно упомянуть его в коде конечной страницы во <code>frontmatter</code>.

Например, чтобы отнести страницу к термину <code>'''Building'''</code> в словаре <code>'''categories'''</code>, просто пропишите в странице:

<source lang="json">
---
categories:
- Building
---
</source>

При этом сразу будет создана страница термина [http://localhost:1313/categories/building/ http://localhost:1313/'''categories'''/'''building'''/]

Чтобы увидеть список всех терминов, относящихся к словарю <code>'''category'''</code>, нужно открыть страницу словаря [http://localhost:1313/categories/ http://localhost:1313/'''categories'''/]

Для этой страницы будет использован самый подходящий шаблон из существующих файлов (сверху — наиболее подходящие):

<source lang="bash">
layouts/categories/category.terms.html
layouts/categories/terms.html
layouts/categories/list.html

layouts/taxonomy/category.terms.html
layouts/taxonomy/terms.html
layouts/taxonomy/list.html

layouts/category/category.terms.html
layouts/category/terms.html
layouts/category/list.html

layouts/_default/category.terms.html # список терминов словаря 'category'
layouts/_default/terms.html # список терминов на страницах словарей
layouts/_default/list.html # самый базовый шаблон, общий для всех списков контента
</source>

Более полный список порядка шаблонов: [https://gohugo.io/templates/lookup-order/#examples-layout-lookup-for-taxonomy-terms-pages Examples: Layout Lookup for Taxonomy Terms Pages]

В шаблоне нужно разместить следующий код.

=== Самый простой вариант кода ===

<source lang="go">
{{ range .Pages }}
<p><a href="{{ .Permalink }}">{{ .Title }}</a></p>
{{ end }}
</source>

Если для термина создана страница типа <code>content/'''categories'''/'''building'''/_index.ru.md</code>, то в качестве названия термина будет взят <code>title</code> из <code>frontmatter</code> страницы.

URL ссылки также может быть изменен в поле <code>url</code> во <code>frontmatter</code> страницы.

=== Код с параметрами терминов из frontmatter ===

<source lang="go">
{{ range .Pages }}
<p>
<a href="{{ .Permalink }}">{{ .Title }}</a>
{{ with .Params.description }}
<br><small>{{ . }}</small>
{{ end }}
</p>
{{ end }}
</source>

=== Код с сортировкой терминов ===

'''Сортировка по алфавиту''' по названиям терминов:

<source lang="go">
{{ range .Data.Terms.Alphabetical }}
<p><a href="{{ .Page.Permalink }}">{{ .Page.Title }}</a> ({{ .Term }})</p>
{{ end }}
</source>

Сортировка будет не по <code>.Page.Title</code>, а по <code>.Term</code>.

Обратная сортировка: <code>.Data.Terms.Alphabetical.Reverse</code>

'''Сортировка по алфавиту''' по названиям терминов в страницах терминов:

<source lang="go">
{{ range .Pages.ByTitle }}
<p><a href="{{ .Permalink }}">{{ .Title }}</a></p>
{{ end }}
</source>

Обратная сортировка: <code>.Pages.ByTitle.Reverse</code>

'''Сортировка по количеству''' страниц в каждом термине:

<source lang="go">
{{ range .Data.Terms.ByCount }}
<p><a href="{{ .Page.Permalink }}">{{ .Page.Title }}</a> ({{ .Count }})</p>
{{ end }}
</source>

Обратная сортировка: <code>.Data.Terms.ByCount.Reverse</code>

'''Сортировка по дате''':

<source lang="go">
{{ range .Data.Pages.ByDate }}
<p><a href="{{ .Permalink }}">{{ .Title }}</a> ({{ .Date | dateFormat "2006-01-02" }})</p>
{{ end }}
</source>

Обратная сортировка: <code>.Data.Pages.ByDate.Reverse</code>

=== Дополнительно — информация из первого материала в термине ===

<source lang="html">
<div class="columns is-mobile is-multiline">
{{ range .Data.Terms.ByCount }}
<div class="column is-half-mobile is-one-third-tablet is-one-quarter-desktop is-one-fifth-widescreen">
<div class="card">
<div class="card-image">
<a href="{{ .Page.Permalink }}">
<figure class="image is-3by2">
{{ $firstChild := index .Pages 0 }}
{{ with $firstChild.Params.images }}
<img src="{{ index . 0 }}" alt="">
{{ end }}
</figure>
</a>
</div>
<div class="card-content has-text-centered">
<div>
<a class="title is-5 is-size-6-mobile" href="{{ .Page.Permalink }}">{{ .Page.Title }}</a>
{{ $pageCount := len .Pages }}
<p>{{ $pageCount }} post{{ if ne $pageCount 1 }}s{{ end }} </p>
</div>
</div>
</div>
</div>
{{ end }}
</div>
</source>

[https://www.pakstech.com/blog/hugo-list-page/ Подробнее]

=== Дополнительно — информация из frontmatter термина ===

<source lang="html">
{{ range .Data.Terms.ByCount }}
<li>
<a href="{{ .Page.Permalink }}">{{ .Page.Title }}</a>
{{ with $.Site.GetPage "taxonomy" .Term }}
{{ if .Params.icon }}
<img src="{{ .Params.icon }}" alt="{{ .Page.Title }}">
{{ end }}
{{ end }}
</li>
{{ end }}
</source>

== Страница термина со списком относящихся к нему страниц (taxonomy) ==

Чтобы увидеть список всех страниц сайта, относящихся к термину '''Building''' словаря '''category''', нужно открыть страницу [http://localhost:1313/categories/building/ http://localhost:1313/'''categories'''/'''building'''/]

Для этой страницы будет использован самый подходящий шаблон из существующих файлов (сверху — наиболее подходящие):

<source lang="bash">
layouts/categories/category.html
layouts/categories/taxonomy.html
layouts/categories/list.html

layouts/taxonomy/category.html
layouts/taxonomy/taxonomy.html
layouts/taxonomy/list.html

layouts/category/category.html
layouts/category/taxonomy.html
layouts/category/list.html

layouts/_default/category.html # список материалов словаря 'category'
layouts/_default/taxonomy.html # список материалов на страницах таксономии
layouts/_default/list.html # самый базовый шаблон, общий для всех списков контента
</source>

Еще более полный список порядка шаблонов: [https://gohugo.io/templates/lookup-order/#examples-layout-lookup-for-taxonomy-list-pages Examples: Layout Lookup for Taxonomy List Pages]

В шаблоне нужно разместить следующий код.

=== Самый простой вариант кода ===

<source lang="go">
{{ range .Data.Pages }}
<p><a href="{{ .Permalink}}">{{ .Title }}</a></p>
{{ end }}
</source>

== Список терминов определенного словаря ==

Выведем все термины словаря <code>categories</code>:

<source lang="go">
{{ range $cat, $tax := .Site.Taxonomies.categories }}
<li><a href="/categories/{{ $cat | urlize }}/">{{ replace $cat "-" " " | title }}</a> </li>
{{ end }}
</source>

== Список материалов определенного термина ==

Выведем все материалы термина <code>art</code> в словаре <code>clients</code>:

<source lang="go">
{{ range .Site.Taxonomies.clients.art }}
<li><a href="{{ .Page.Permalink }}">{{ .Page.Title }}</a></li>
{{ end }}
</source>

То же самое, но только 5 штук и с сортировкой по полю <code>order</code>:

<source lang="go">
{{ $term := "art" }}
{{ $taxonomy := index .Site.Taxonomies.clients $term }}
{{ range first 5 (sort $taxonomy.Pages "Params.order" "desc") }}
<li><a href="{{ .Permalink }}">{{ .Title }}</a></li>
{{ end }}
</source>

== Список терминов любого словаря с выводом материалов каждого термина ==

<source lang="go">
{{ $data := .Data }}
{{ range $key,$value := .Data.Terms.ByCount }}
<h2><a href="{{ $data.Plural }}/{{ $value.Name | urlize }}/">{{ replace $value.Name "-" " " | title }}</a> ({{ $value.Count }})</h2>
<ol>
{{ range $value.Pages.ByDate }}
<li><a href="{{ .Permalink }}">{{ .Title }}</a></li>
{{ end }}
</ol>
{{ end }}
</source>

== Количество материалов, относящихся к термину ==

Выведем число страниц сайта, относящихся к термину <code>art</code> словаря <code>categories</code>:

<source lang="go">
{{ .Site.Taxonomies.categories.art.Count }}
</source>

[[Категория:Hugo]]

== См. также ==

* [https://gohugo.io/templates/taxonomy-templates/ Taxonomy Templates | Hugo]
* [https://www.petersheim.de/posts/2019/05/manage-hugo-taxonomies-like-a-boss/ Manage HUGO Taxonomies Like a Boss]
* [https://www.pakstech.com/blog/hugo-list-page/ Implemement Hugo List and Taxonomy Pages | PäksTech]

Списки таксономии Hugo - Історія редагувань

Romych: /* Дополнительно — информация из frontmatter термина */