Guide to the Tagging System
Tags are a quick way of organising your world's articles and, unlike categories, you can have multiple tags in a single article. However, tags don't appear in the homepage like categories do, meaning they can't replace categories.
Usecases for tagsTags are a way to organize articles and other resources within your world beyond categories. When starting out just using categories for your organization is more than enough. You should be using tags when you are trying to find a group of related articles which are not in the same category in your world. This can also be the case for your readers or players. However, it makes sense to take some time to plan out your tags if you use them. It is easy to get lost or add tags with typos. The best way currently to maintain your tags is to use an interactive table, some kind of sheet, or your World Anvil Notebook.
ConventionsConventions are useful to make sure you can remember your tags and that they work properly in all situations. Keep in mind that these are not requirements.
- A common convention is to use a hashtag (#) prefix for all tags. But it is not necessary to do so. Just make sure to either always add a hash or never.
- Do NOT use spaces within your tags.
- Use a common writing convention:
- Avoid any special characters and diacritics.
- Tags are case insensitive.
Using TagsTags can be used in several different ways. How you plan on using them will affect how you create them and apply them to your articles.
List of Tagged ArticlesHowever, the [tagged] BBCode offers an easy and flexible way to create a list of articles in your world. The syntax of the tag is:
[tagged:TAG|TYPE|HEADER]This is how each parameter works:
- TAG: this is the tag you want to list.
- TYPE: use this to choose wether you want the list to be plain links or formatted article blocks. Type list for the former and block for the later.
- HEADER: type the header of the list here. If you don't want to display any header, type none.
NOTE: Tags are matched if they contain the matched tag as a prefix. For example, the BBCode [tagged:#train|block|Trains!] includes all articles with any of the following tags: #train, #train-station and #trains.
User searchThe search bar on the cover of each article can search tags in addition to titles. One search can always only match a single tag and the full search phrase must be present inside that tag. Don't search using the # prefix character.
NOTE: A search for vamp will find any article and resource with the tags #vampire, #vampires, #place-vamp, #vampiricom, #vamp. This is different on how tags are machted by the [tagged] BBCode!
Author SearchAny resources with a tag can be searched in the global search bar (Guild members only), in the Articles & Categories search bar and on the World Dashboard. This search works the same as the user search with additional functionality designed for the world author.
Diplomacy WebOrganizations can be displayed in a common diplomacy web using tags.
Special CSS ClassAll tags are added as CSS classes to each article they are used on. The tag is prefixed with tag-. You can use this to apply a set of special layouts to specific articles. This does not work if the tag contains any spaces.
The tagged & taggedblocks BBCode can at most return 150 articles.