mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-09-19 10:49:43 +00:00
0d18f3cc5d
See the discussion here: https://groups.google.com/d/topic/tiddlywikidev/AXDJEjcAphs/discussion
47 lines
2.5 KiB
Plaintext
47 lines
2.5 KiB
Plaintext
created: 20140312124037773
|
|
modified: 20140312124106267
|
|
tags: concepts
|
|
title: TiddlerTags
|
|
type: text/vnd.tiddlywiki
|
|
|
|
! Introduction
|
|
|
|
Tiddlers can be assigned categories by assigning one or more tags. For example, tiddlers representing individuals might be tagged ''friend'', ''family'', ''colleague'' etc to indicate the relationship to the author.
|
|
|
|
Multiple tags can be applied to the same tiddler. Used effectively they provide a powerful way to explore content related to a tiddler.
|
|
|
|
TiddlyWiki offers several useful features based on the convention that a tag itself can be interpreted as the title of a tiddler.
|
|
|
|
! Using Tags
|
|
|
|
Tags are displayed at the top of the tiddler as coloured pills. Clicking on a tag pill drops down a menu showing links to all the tiddlers that carry that tag, along with a link to the tiddler representing the tag itself.
|
|
|
|
When editing a tiddler, the tags pills have a small ''x'' icon that allows them to be removed individually. There is also a text box to type the name of a new tag to be added, and a dropdown autocomplete list that shows matching tags that are in use.
|
|
|
|
! Tag Manager
|
|
|
|
The tag manager is available via a button at the top of the sidebar tab "Tabs", or you can link directly to [[$:/TagManager]].
|
|
|
|
! Assigning Colours and Icons to Tag
|
|
|
|
The colour used to draw a tag pill is taken from the ''color'' field of the tiddler titled with the tag. The colour can be specified as any CSS value (more modern browsers show a colour picker for the ''color'' field).
|
|
|
|
An icon can be associated with a tag by placing the title of the tiddler containing the image into the ''icon'' field of th etiddler titled with the tag.
|
|
|
|
See the tag {{done||$:/core/ui/TagTemplate}} for an example.
|
|
|
|
! Tag Ordering
|
|
|
|
The ordering used to return a list of the tiddlers with a particular tag is determined by the following rules:
|
|
|
|
* First, any tiddlers that are listed in the ListField of the tag tiddler are placed into a new list in the same order
|
|
* Second, any unplaced tiddlers that have the field ''list-before'' are placed before the tiddler specified in the field
|
|
** (if the ''list-before'' field is empty then the unplaced tiddler is placed at the start of the list)
|
|
* Third, if any unplaced tiddlers have the field ''list-after'' then they placed immediately after the tiddler specified in the field
|
|
* Finally, any remaining unplaced tiddlers are placed at the end of the list
|
|
|
|
! System Tags
|
|
|
|
See SystemTags for information about the special system tags that TiddlyWiki uses for configuration.
|
|
|