created:2021-05-14
author:Foobär
top:README:Blog Entries:Tagpages
sort:007
title:Sorting

<p>
Entries are sorted differently on the two differend kinds of tagpages (Topic tagpages being one, all other tagpages the other). Since topic tagpages are meant to
represent an index of thew entries on a topic, entries are sorted by topic and sub-topic first, then alphabetically. Entries with the same sub-(sub-...-)topic are
listed together alphabetically.
</p><p>
All other tagpages (category, language, author and combined tagpages) are sorted by created date. If an entry does not have a created: tag, it is sorted at the
bottom at a list, at the end of a tag page (or at the end of the last page of a paged tagpage). If an entry had an edited: tag, this edited date overwrites its
created date, meaning entries that have been edited will be placed higher than they would otherwise. The edited: tag has to be placed in the header of an entry
source file manually when it is edited. This means for example that typos can simply be corrected in old entries without affecting where they are placed on tagpages.
But if substantial changes are made or a paragraph with an update is added to an entry, you have the choice of adding an edited tag with the current date to bump
the entry to the top of tagpages.
</p><p>
(tba: How are what values actually sorted?)
</p><p>
A third tag taht influences how entries are sorted is the sort: tag. It is meant for special cases where you would like created and/or edited dates present and
displayed but the entry sorted to a different place independently of those two tags. The sort: tag overwrites both the created: and edited: tags when it comes to
sorting on tagpages. This can be used to place an entry between others by using a fake date for the sort: tag or at the end of tagpages by setting sort: to 0, all
independently from what created or edited dste is displayed for the entry. It can also be used to place an entry at the top of tagpages, making it "stickied" so to
speak.
</p><p>
The value of the sort: tag is treated the same as the values for edited: and created:. It's just a way to overwrite both for a single entry. There are two special
values though that influece how an entry is displayed: Every value for the sort: tag that starts with either <code>stick</code> or <code>about</code> will remove the title-wrapper of
the entry on tagpages.
</p><p>
You may, for example, want something to appear above all entries on a specific tagpage, say the tagpage for the category "Miscellaneous" to explain what type of
content you put in this category. In that case you can create an entry that has the tags <code>cat:Miscellaneous</code> and <code>sort:stickied</code> (or <code>sort:about</code>) and the
explanation below. This will make the explanation appear on the top of the cat:Miscellaneous tagpage without a title, link or other meta information.
</p><p>
Only one occurance of each of the three tag types that influence sorting is expected per entry.
</p>
