Title: Applying Tags when Posting an Article with the Rapid Selector

Applying Tags when Posting an Article with the Rapid Selector



Applying Tags



When you type certain Rapid Selector tag expressions into the body of a new article, the tag matching what you typed will be associated with the paragraph (or item) you typed it into.



Command

Effect

[[:tagname]]

Applies the tag tagname from the current space to the current item. Double square brackets denote a Rapid Selector command. Note: this works with tags in any language.

:tagname

Same as above. For tags using only ASCII characters, the double brackets may be omitted, as long as there is whitespace before the colon and after the tag name.

:ta

Same as above, as long as the abbreviated tag name matches only one tag. Otherwise, it will be treated as raw text.

::HR:tagname

Applies the tag tagname from the HR space to the current item.

Applies the tag tagname from the current space to the current item, creating it if it doesn't exist.



When the name of the tag being applied includes one or more whitespace characters, there are two ways to specify it.



One way is to include quotation marks around the words, e.g., for the tag feature idea type :"feature idea" or for the tag meeting notes in the space HR, type :HR:"meeting notes".



In order to be recognized, the tag name must start with a colon or hash sign. If you omit the square brackets, the colon or hash must also be preceded by whitespace.



If a tag is not recognized, it will be tagged with the :unrecognized tag. In Traction, you can generate a topic view of :unrecognized and then can use the reclassify function to fix the errors.



Quoting Tags and Rapid Selector Commands



If you want to write TeamPage articles that include examples of Tag and Rapid Selector Command syntax (like this article), you need to protect your examples from being evaluated instead of being shown just the way you wrote them! Using the Rich Text Editor, first select the example, then right click and choose Literal Text format from the pop-up menu. If you're using plaintext to create an article, you can enclose the example in a HTML span like this: <span class="traction-literal">:tag name</span> which is what the Literal Text format action uses.





Related Articles
Article: Doc12 (permalink)
Categories: :Doc:unrecognized
Date: March 22, 2008; 3:45:54 PM Eastern Daylight Time

Author Name: Documentation Importer
Author ID: importer