Difference between revisions of "Help:Screen:Tags"

From ISFDB
Jump to navigation Jump to search
m (→‎Editing Tags: Typo fix)
(Rewrote to reflect the currnt state of the software; moved tag editing information to the Tag Editor page)
Line 1: Line 1:
==Introduction==
+
There are four Web pages that show tag-related information:
A tag is a user-defined keyword associated with a title. In the ISFDB a tag forms a relationship between a title, a user, and the keyword. Marking a title with a particular tag makes it easy to find other titles that also fall into that category. While tags should generally be descriptive ("space opera", "time travel", "alien invasion", etc), they can also be used to construct personal lists ("read list", "verification list", etc). There is no official namespace for tags, they can be whatever a user wishes them to be; however, reusing existing tags ("time travel", instead of "time-travel") minimizes the search path for other users.
 
  
==Tools==
+
* When a Title Bibliography page is displayed, all tags by all users associated with the currently displayed title are displayed.
There are four kinds of tools that show tag-related information:
+
* When a Title Bibliography page is displayed and the user clicks on a tag, it displays the "Titles marked with tag [...]" page. This page shows all books associated with the currently selected tag in a reverse chronological order. At the top of the page there is a list of users who have used this tag with the number of uses displayed in parentheses. If the currently logged in user is a moderator, he or she will also see a button that will allow flipping the status of the currently displayed tag between "Public" and "Private". Public tags are visible by everyone while Private tags are only visible by users who have used them.
* All tags (by all users) associated with a title are displayed in the title.cgi application.
+
* When a "Titles marked with tag [...]" page is displayed and the user clicks on a user name, it displays "[user name]'s Tags" page. This page shows all the tags entered by the selected user sorted by the number of times each tag has been used, most frequently used tags first. The currently logged in user can also see this page for his or her own account by clicking on "My Tags" in the navigation bar.
* When a tag is clicked from title.cgi, it takes the user to tag.cgi, which shows all the books tagged with that keyword. Displayed at the top of the page is the list of users who utilized that particular tag.
+
* When a "[user's Tags] page is displayed and the user clicks on the number in the "Count" column, it displays the "Titles Marked By [user] With Tag: [tag]" page. This page a list of titles that the currently displayed user has tagged with the currently selected tag.
* When a user is clicked from tag.cgi, it takes the user to usertag.cgi, which shows all the tags that particular user has entered. This page can also be displayed by clicking on "My Tags" in the navigation bar.
 
* When a tag is clicked from usertag.cgi, it takes the user to usertitles.cgi, which shows all the books that particular user has tagged with that label.
 
 
 
==Editing Tags==
 
Adding a tag to a title is straightforward. When viewing a title, click on the "Add Tags" link. Your current tags for this title will be displayed in the input fields. If this is your first edit of this title, there will be a single box labeled "Tag1". You may add additional field lines by pressing the "Add Tag" button.
 
 
 
For reference, the current tags for this title are shown at the top of the page. The second section shows all of the current tags in the system, which should help you pick consistent tags.
 

Revision as of 16:53, 18 February 2015

There are four Web pages that show tag-related information:

  • When a Title Bibliography page is displayed, all tags by all users associated with the currently displayed title are displayed.
  • When a Title Bibliography page is displayed and the user clicks on a tag, it displays the "Titles marked with tag [...]" page. This page shows all books associated with the currently selected tag in a reverse chronological order. At the top of the page there is a list of users who have used this tag with the number of uses displayed in parentheses. If the currently logged in user is a moderator, he or she will also see a button that will allow flipping the status of the currently displayed tag between "Public" and "Private". Public tags are visible by everyone while Private tags are only visible by users who have used them.
  • When a "Titles marked with tag [...]" page is displayed and the user clicks on a user name, it displays "[user name]'s Tags" page. This page shows all the tags entered by the selected user sorted by the number of times each tag has been used, most frequently used tags first. The currently logged in user can also see this page for his or her own account by clicking on "My Tags" in the navigation bar.
  • When a "[user's Tags] page is displayed and the user clicks on the number in the "Count" column, it displays the "Titles Marked By [user] With Tag: [tag]" page. This page a list of titles that the currently displayed user has tagged with the currently selected tag.