Sorted tags page

[simgislab]

I'm trying to get my tags page sorted alphabeticaly (only this page).

Tried lots of different things, but nothing works.

The solution that seems like it should work, but it doesn't:

/layouts/_default/list.html

{{ define "main" }}

<div class="list-container">

    {{ partial "breadcrumbs.html" . }}

    <h1>{{ .Title }}</h1>
    {{ .Content }}

    {{ $tagsPage := eq .Title "Tags"}}

    {{ $paginationSize := 1}}
    {{ if (gt .Site.Params.paginationSize 0) }}
        {{ $paginationSize = .Site.Params.paginationSize }}
    {{ end }}

    {{ $paginator := .Paginate (.Pages) $paginationSize }}

    {{ if $tagsPage }}
        {{ $paginator := .Paginate (sort .Pages "Title" "asc") $paginationSize }}
    {{ end }}

    {{ range $index, $page := $paginator.Pages }}

        {{ if $tagsPage }}
            {{ partial "tag-entry.html" $page}}
        {{ else }}
            {{ partial "post-entry.html" $page}}
        {{ end }}

    {{ end }}

    {{ partial "pagination-controls.html" $paginator}}

</div>
{{ end }}

Any ideas?

[MaMohm]

The reason your solution doesn't work is due to a strict rule in Hugo: You can only call .Paginate once per template execution.

In your current code, you are calling .Paginate unconditionally before your if statement. Once that first .Paginate runs, Hugo freezes the pagination data (using the default sort order). The second call inside your if $tagsPage block is either ignored or simply returns the already-cached, unsorted paginator.

To fix this, you must determine the list of pages and their sort order before you initialize the paginator.

Here is the corrected code logic:

The Solution
You need to create a variable for your pages (e.g., $p), sort that variable if necessary, and then pass that variable to .Paginate.

HTML
{{ define "main" }}

{{ partial "breadcrumbs.html" . }}

<h1>{{ .Title }}</h1>
{{ .Content }}

{{ $tagsPage := eq .Title "Tags"}}

{{/* 1. Define the pages variable locally first */}}
{{ $pages := .Pages }}

{{/* 2. If it is the Tags page, overwrite $pages with the sorted version */}}
{{ if $tagsPage }}
    {{/* .ByTitle is a native Hugo method for Page Collections, cleaner than 'sort' */}}
    {{ $pages = $pages.ByTitle }}
{{ end }}

{{ $paginationSize := 1 }}
{{ if (gt .Site.Params.paginationSize 0) }}
    {{ $paginationSize = .Site.Params.paginationSize }}
{{ end }}

{{/* 3. Call Paginate ONCE using the prepared variable */}}
{{ $paginator := .Paginate $pages $paginationSize }}

{{ range $index, $page := $paginator.Pages }}

    {{ if $tagsPage }}
        {{ partial "tag-entry.html" $page}}
    {{ else }}
        {{ partial "post-entry.html" $page}}
    {{ end }}

{{ end }}

{{ partial "pagination-controls.html" $paginator}}

{{ end }} Key Changes Made: Moved Logic Upstream: We essentially moved the "decision making" (which pages do we want?) to occur before the "processing" (pagination).

$pages := .Pages: We capture the default page collection in a variable.

$pages = $pages.ByTitle: If we are on the tags page, we modify that variable to use the .ByTitle sort method. This is efficient and succinct.

Single .Paginate Call: We pass the final $pages variable to the paginator. This ensures the paginator is built exactly once with the correct order.

[simgislab]

Works great! Very happy :)