Tags

Tags are text slugs stored in the  Article of the "M" namespace of a ZIM file.

A ZIM file can have zero, one or many Tags. Should there be more than one, those are separated by the  character.

Goal
Tags are used by publishers to classify ZIM files.

Setting Tags
Tags should help represent, classify or identify a ZIM. ZIM readers are responsible for making use of Tags or not.

Tags are commonly displayed to reader users at ZIM-selection stage and not when using a ZIM file.

Tags are free text and can thus contain any UTF-8 character except for the  separator. It is common to restrict Tags to single or two-words combination. Concision is important for users to remember and identify content.

Private Tags
Any Tag starting with the  (underscore) character is considered a private tag. Private tagging is a convention and nor par of the specification.

Private tags are usually hidden by readers and used as flexible metadata.

Common private tags used by kiwix Publishers:


 * : indicates wheter the ZIM file relies on Service Workers.
 * : indicates wheter the ZIM file includes a full-text index.
 * : indicates whether the ZIM file includes pictures.
 * : indicates whether the ZIM file includes videos.
 * : indicates whether the ZIM file includes detailed content.
 * : indicates that the ZIM file could be categorized as . ZIM readers don't have to follow this convention. Kiwix readers don't even use the   Tag in readers but uses it to inform its separate filtering mechanism.