Socialtext Documentation
Tags: Revision 2
_Back to [Socialtext Documentation]._
^^ Navigating
In Socialtext, tags help you identify information so it can be found later on. Every page can have any number of tags.
> *View tags for a page*. When viewing a page, its tags are listed in the light green "Tags" box in the sidebar. If you can't see the sidebar, click {{>}} in the upper right corner of the page to open the sidebar.
>>> {image: Page-View-Tags.png}
> *View all tags.* Visit the [Dashboard] and click All tags to see all the tags in the workspace. You will see an alphabetical list of all of the defined tags. Clicking on any tag will show a list of all pages with that tag.
>>> {image: Navbar-All-tags.png}
^^ Editing Tags
When you are browsing a page, you can edit the tags directly in the light green *Tags* box.
> *Assign a tag.* Click the *Add tag* button to add a tag. A box will appear that lets you enter a tag.
>>> {image: Page-View-Add-Tags.png}
> Suggestions are provided below the box, based on the characters you have typed so far and the tags that already exist in the workspace. Clicking a suggested tag will add that tag. To save your newly entered tag, press Enter or click the *Save tag* button.
> *Remove a tag.* Click the {{[x]}} next to a tag to remove it from the page.
> *NOTE:* All workspace weblog names are also tag names. Assigning a weblog as a tag (e.g. assigning the tag My Weblog) publishes the page to that weblog.
^^ Advanced formatting: Including tags in pages
Within [Advanced mode], you can refer to tags within your pages, in effect, linking to a tag.
** From *this* workspace, use _{{ {category: tagname} }}_
** From *another* workspace, use {{ {category: <workspacename> tagname} }}
You can also list the most recently updated pages with a given tag directly inside your pages.
It is easiest to link to tags and include tags by using "WikiWidgets"{link: [Simple mode] Insert Wikiwidgets} in [Simple mode].
*10 Recent changes in pages with a given tag*
| {{ {category-list: Help} }} | list ten most recent changes in tag Help |
| {{ {category-list: <wikiwed> Help} }} | list ten most recent changes with tag Help in WikiWed workspace |
*10 Recent changes in pages with a given tag, full - include page contents*
| {{ {category-list-full: Help} }} | include ten most recent changes with tag Help |
| {{ {category-list-full: <wikiwed> Help} }} | include ten most recent changes with tag Help in WikiWed workspace |
*Complete tag listing*
| {{ {search category:Help} }} | list pages with tag Help |
| {{ {search <wikiwed> category:Help} }} | list pages with tag Help in WikiWed workspace |
*Complete tag listing, full - include page contents*
| {{ {search-full: category:Help} }} | include pages with tag Help |
| {{ {search-full <wikiwed> category:Help} }} | include pages with tag Help in WikiWed workspace |
_Back to [Socialtext Documentation]._
^^ Navigating
In Socialtext, tags help you identify information so it can be found later on. Every page can have any number of tags.
> *View tags for a page*. When viewing a page, its tags are listed in the light green "Tags" box in the sidebar. If you can't see the sidebar, click {{>}} in the upper right corner of the page to open the sidebar.
>>> {image: Page-View-Tags.png}
> *View all tags.* Visit the [Dashboard] and click All tags to see all the tags in the workspace. You will see an alphabetical list of all of the defined tags. Clicking on any tag will show a list of all pages with that tag.
>>> {image: Navbar-All-tags.png}
^^ Editing Tags
When you are browsing a page, you can edit the tags directly in the light green *Tags* box.
> *Assign a tag.* Click the *Add tag* button to add a tag. A box will appear that lets you enter a tag.
>>> {image: Page-View-Add-Tags.png}
> Suggestions are provided below the box, based on the characters you have typed so far and the tags that already exist in the workspace. Clicking a suggested tag will add that tag. To save your newly entered tag, press Enter or click the *Save tag* button.
> *Remove a tag.* Click the {{[x]}} next to a tag to remove it from the page.
> *NOTE:* All workspace weblog names are also tag names. Assigning a weblog as a tag (e.g. assigning the tag My Weblog) publishes the page to that weblog.
^^ Advanced formatting: Including tags in pages
Within [Advanced mode], you can refer to tags within your pages, in effect, linking to a tag.
** From *this* workspace, use _{{ {category: tagname} }}_
** From *another* workspace, use {{ {category: <workspacename> tagname} }}
You can also list the most recently updated pages with a given tag directly inside your pages.
It is easiest to link to tags and include tags by using "WikiWidgets"{link: [Simple mode] Insert Wikiwidgets} in [Simple mode].
*10 Recent changes in pages with a given tag*
| {{ {category-list: Help} }} | list ten most recent changes in tag Help |
| {{ {category-list: <wikiwed> Help} }} | list ten most recent changes with tag Help in WikiWed workspace |
*10 Recent changes in pages with a given tag, full - include page contents*
| {{ {category-list-full: Help} }} | include ten most recent changes with tag Help |
| {{ {category-list-full: <wikiwed> Help} }} | include ten most recent changes with tag Help in WikiWed workspace |
*Complete tag listing*
| {{ {search category:Help} }} | list pages with tag Help |
| {{ {search <wikiwed> category:Help} }} | list pages with tag Help in WikiWed workspace |
*Complete tag listing, full - include page contents*
| {{ {search-full: category:Help} }} | include pages with tag Help |
| {{ {search-full <wikiwed> category:Help} }} | include pages with tag Help in WikiWed workspace |
_Back to [Socialtext Documentation]._
