Ordering taxonomy widgets in the sidebar

[sagarbehere]

The existing sidebar shows the taxonomy widgets ordered as Categories, Series, and Tags in that sequence. I'd like to change the order to Tags, Categories, and Series i.e. first the Tags should appear, followed by Categories, and the Series should be at the very bottom.

How to get that? I looked at the layouts/partials/sidebar/taxonomies.html file and it seems that the ordering is somehow coming from the first line {{- range $key, $value := .Site.Taxonomies -}}. It seems that this returns the Categories key first, which then becomes the first displayed widget, followed by Series and then Tags. But I couldn't figure out how to tweak this to my desired sequence.

[razonyang]

I didn't find an ideal solution. I pushed a new commit e59069c for it.
Now you can set the order of taxonomies by CSS(assets/css/custom.css).

.tags-taxonomies {
    order: 1;
}

.categories-taxonomies {
    order: 2;
}

.series-taxonomies {
    order: 3;
}

[sagarbehere]

Yes, that works. Another option is to not do this programmatically, i.e. not {{- range $key, $value := .Site.Taxonomies -}}, and instead just create partials/sidebar/tags.html, partials/sidebar/categories.html, partials/sidebar/series.html and then in partials/sidebar/taxonomies.html put

{{- partial "sidebar/tags.html" . -}}
{{- partial "sidebar/categories.html" . -}}
{{- partial "sidebar/series.html" . -}}

But this is not elegant and requires manually creating more sidebar/taxonomy-term.html files if the user wants to add more terms to the taxonomy. Your method avoids this extra manual work.

[razonyang]

@sagarbehere I've created the taxonomicOrder parameter for this an hour ago. e3220a8

taxonomicOrder = ["categories", "tags", "series"] # The order of taxonomies on the sidebar.

I think it's a more ideal implementation(configurable).

[sagarbehere]

@razonyang This is a really good solution. No need to mess around with css files or create manual template files!

Does this also have the pleasant side-effect that if I do not want to show the Series widget in the sidebar at all, then "series" can be removed from taxonomicOrder and then it will no longer be shown? i.e.

taxonomicOrder = ["categories", "tags"] # Will this mean that the Series widget will not be shown?

By the way, sidebarTaxonomyOrder may be a more intuitive/descriptive parameter name than taxonomicOrder :-)

[razonyang]

No, other taxonomies that not included in taxonomicOrder will be appended to the last.

Currently, the series taxonomy is required by Hugo internal template called Open Graph, so that we can't remove it from config.toml.

But we can solve it by other parameter, or combine two parameters into one called sidebarTaxonomies.

[razonyang]

@sagarbehere sidebarTaxonomies was added by 42c840d