Newer edit →
1,765 bytes added
14:11, 15 August 2019
Tags are text slugs stored in the <code>Tags</code> Article of the [[Metadata]] 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 <code>;</code> 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 <code>;</code> 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 <code>_</code> (underscore) character is considered a private tag. Private tagging is a convention and nor par of the [[ZIM_file_format|specification]].
Private tags are usually hidden by readers and used as flexible metadata.
Common private tags used by [https://github.com/kiwix/kiwix-lib/ kiwix] Publishers:
* <code>_ftindex</code>: indicates that the ZIM file includes a full-text index.
* <code>_pictures:<no|yes></code>: indicates whether the ZIM file includes pictures.
* <code>_videos:<no|yes></code>: indicates whether the ZIM file includes videos.
* <code>_details:<no|yes></code>: indicates whether the ZIM file includes detailed content.
* <code>_category:<xxx></code>: indicates that the ZIM file could be categorized as <code>xxx</code>.
ZIM readers don't have to follow this convention. Kiwix readers don't even use the <code>_category</code> Tag in readers but uses it to inform its separate filtering mechanism.
Retrieved from "
ZIM Main page