TagTeam basics - Revision history

WikiSysop: /* Using and reusing searches */

2018-10-30T20:10:57Z

Using and reusing searches

← Older revision		Revision as of 20:10, 30 October 2018
Line 423:		Line 423:
	** Run the search. When the results come up, click on the link labelled ''Permalink'' below the search box. This version of the URL is slightly cleaner than the URL displayed in the browser, although that URL would also work.		** Run the search. When the results come up, click on the link labelled ''Permalink'' below the search box. This version of the URL is slightly cleaner than the URL displayed in the browser, although that URL would also work.
	*** Sometimes these URLs will use the escape characters "%28" and "%29" for "(" and ")" respectively. We'll fix this soon. Meantime, you can replace the escape characters with the parentheses to make the URL easier to type and decipher.		*** Sometimes these URLs will use the escape characters "%28" and "%29" for "(" and ")" respectively. We'll fix this soon. Meantime, you can replace the escape characters with the parentheses to make the URL easier to type and decipher.
	*** ~~When~~ you run a tag search, these URLs ~~may~~ contain the "#" character~~, then~~ they should contain the "%23" escape characters instead. We'll fix this soon. Meantime, you can replace the hash character with the escape character to make these URLs work. For more detail, see the subsection on Tag searching above.		*** Sometimes (for example when you run a "#tag" search), these URLs will contain the "#" character when they should contain the "%23" escape characters instead. We'll fix this soon. Meantime, you can replace the hash character with the escape character to make these URLs work. For more detail, see the subsection on [[TagTeam_basics#Tag_searching \| Tag searching]] above.
	** The syntax is so predictable that you could construct the URL without running the search.		** The syntax is so predictable that you could construct the URL without running the search.
	*** ''Example'': In the hub called ''OATP'', the URL for a search for ''one'' is <tt>https://tagteam.harvard.edu/hubs/oatp/item_search?q=one</tt>.		*** ''Example'': In the hub called ''OATP'', the URL for a search for ''one'' is <tt>https://tagteam.harvard.edu/hubs/oatp/item_search?q=one</tt>.

WikiSysop: /* Using and reusing searches */

2018-10-30T20:08:41Z

Using and reusing searches

← Older revision		Revision as of 20:08, 30 October 2018
Line 421:		Line 421:

	* Every search in TagTeam has a unique URL for bookmarking, linking, and sharing.		* Every search in TagTeam has a unique URL for bookmarking, linking, and sharing.
	** Run the search. When the results come up, click on the link labelled "Permalink~~" next to~~ the search box. This version of the URL is slightly cleaner than the URL displayed in the browser, although that URL would also work.		** Run the search. When the results come up, click on the link labelled ''Permalink'' below the search box. This version of the URL is slightly cleaner than the URL displayed in the browser, although that URL would also work.
	*** Sometimes these URLs will use the escape characters %28 and %29 for "(" and ")" respectively. We'll fix this soon. Meantime, you can replace the escape characters with the parentheses to make the URL easier to type and decipher.		*** Sometimes these URLs will use the escape characters "%28" and "%29" for "(" and ")" respectively. We'll fix this soon. Meantime, you can replace the escape characters with the parentheses to make the URL easier to type and decipher.
			*** When you run a tag search, these URLs may contain the "#" character, then they should contain the "%23" escape characters instead. We'll fix this soon. Meantime, you can replace the hash character with the escape character to make these URLs work. For more detail, see the subsection on Tag searching above.
	** The syntax is so predictable that you could construct the URL without running the search.		** The syntax is so predictable that you could construct the URL without running the search.
	*** ''Example'': In the hub called ''OATP'', the URL for a search for ''one'' is <tt>https://tagteam.harvard.edu/hubs/oatp/item_search?q=one</tt>.		*** ''Example'': In the hub called ''OATP'', the URL for a search for ''one'' is <tt>https://tagteam.harvard.edu/hubs/oatp/item_search?q=one</tt>.

WikiSysop: /* Tag searching */

2018-10-30T20:05:10Z

Tag searching

← Older revision		Revision as of 20:05, 30 October 2018
Line 368:		Line 368:

	* When you run a search in TagTeam, there's a ''Permalink'' command under the search box to give you a tidy, unique URL for that search. But since the "#" character means something else in a URL, it must be replaced with the "%23" escape character. We'll soon fix the ''Permalink'' command to make this replacement automatically. Meantime you'll have to make it manually.		* When you run a search in TagTeam, there's a ''Permalink'' command under the search box to give you a tidy, unique URL for that search. But since the "#" character means something else in a URL, it must be replaced with the "%23" escape character. We'll soon fix the ''Permalink'' command to make this replacement automatically. Meantime you'll have to make it manually.
	** Hence, the permalink for a search for "#oa.denmark" is not <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=#oa.denmark</tt> (note the erroneous "#" character), but <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=~~#oa~~.denmark</tt>.		** Hence, the permalink for a search for "#oa.denmark" is not <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=#oa.denmark</tt> (note the erroneous "#" character), but <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=%23oa.denmark</tt>.

	=== Phrase searching ===		=== Phrase searching ===

WikiSysop: /* Tag searching */

2018-10-30T20:04:19Z

Tag searching

← Older revision		Revision as of 20:04, 30 October 2018
Line 367:		Line 367:
	* In projects using phrases as tags, or tags containing spaces, use the rules for phrase searching below.		* In projects using phrases as tags, or tags containing spaces, use the rules for phrase searching below.

	* When you run a search in TagTeam, there's a ''Permalink'' command under the search box to give you a tidy, unique URL for that search. But since the "#" character means something else in a URL, it must be replaced with the %23 escape character. We'll soon fix the Permalink command to make this replacement automatically. Meantime you'll have to make it manually.		* When you run a search in TagTeam, there's a ''Permalink'' command under the search box to give you a tidy, unique URL for that search. But since the "#" character means something else in a URL, it must be replaced with the "%23" escape character. We'll soon fix the ''Permalink'' command to make this replacement automatically. Meantime you'll have to make it manually.
	** Hence, the permalink for a search for "#oa.denmark" is not <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=#oa.denmark</tt> (note the erroneous "#" character), but <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=#oa.denmark</tt>.		** Hence, the permalink for a search for "#oa.denmark" is not <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=#oa.denmark</tt> (note the erroneous "#" character), but <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=#oa.denmark</tt>.

WikiSysop: /* Tag searching */

2018-10-30T20:03:45Z

Tag searching

← Older revision		Revision as of 20:03, 30 October 2018
Line 367:		Line 367:
	* In projects using phrases as tags, or tags containing spaces, use the rules for phrase searching below.		* In projects using phrases as tags, or tags containing spaces, use the rules for phrase searching below.

	* When you run a search in TagTeam, there's a ''Permalink'' command under the search box to give you a tidy, unique URL for that search. But since the "#" something else in a URL, it must be replaced with the %23 escape character. We'll soon fix the Permalink command to make this replacement automatically. Meantime you'll have to make it manually.		* When you run a search in TagTeam, there's a ''Permalink'' command under the search box to give you a tidy, unique URL for that search. But since the "#" character means something else in a URL, it must be replaced with the %23 escape character. We'll soon fix the Permalink command to make this replacement automatically. Meantime you'll have to make it manually.
	** Hence, the permalink for a search for "#oa.denmark" is not <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=#oa.denmark</tt> (note the erroneous "#" character), but <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=#oa.denmark</tt>.		** Hence, the permalink for a search for "#oa.denmark" is not <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=#oa.denmark</tt> (note the erroneous "#" character), but <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=#oa.denmark</tt>.

WikiSysop: /* Tag searching */

2018-10-30T20:03:12Z

Tag searching

← Older revision		Revision as of 20:03, 30 October 2018
Line 366:		Line 366:

	* In projects using phrases as tags, or tags containing spaces, use the rules for phrase searching below.		* In projects using phrases as tags, or tags containing spaces, use the rules for phrase searching below.

			* When you run a search in TagTeam, there's a ''Permalink'' command under the search box to give you a tidy, unique URL for that search. But since the "#" something else in a URL, it must be replaced with the %23 escape character. We'll soon fix the Permalink command to make this replacement automatically. Meantime you'll have to make it manually.
			** Hence, the permalink for a search for "#oa.denmark" is not <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=#oa.denmark</tt> (note the erroneous "#" character), but <tt>http://tagteam.harvard.edu/hubs/oatp/item_search?q=#oa.denmark</tt>.

	=== Phrase searching ===		=== Phrase searching ===

WikiSysop at 17:38, 1 September 2018

2018-09-01T17:38:42Z

← Older revision		Revision as of 17:38, 1 September 2018
Line 34:		Line 34:
	** When a hub subscribes to feeds from elsewhere, those feeds deliver streams of items to the hub. When a hub publishes its own feeds, those feeds deliver streams of items to feed subscribers.		** When a hub subscribes to feeds from elsewhere, those feeds deliver streams of items to the hub. When a hub publishes its own feeds, those feeds deliver streams of items to feed subscribers.

	* The '''bookmarklet''' is the button on your browser bar that lets you tag web pages. If you have permission to tag for a hub, then you can find the bookmarklet in the "~~Bookmarks~~" tab. Near the top of that page is a rectangular button with the phrase "Add to TagTeam". Just drag that button to your browser bar. If you don't have permission to tag for a given hub, you will not see the button on the hub's ~~Bookmarks~~ tab.		* The '''bookmarklet''' is the button on your browser bar that lets you tag web pages. If you have permission to tag for a hub, then you can find the bookmarklet in the "Taggers" tab. Near the top of that page is a rectangular button with the phrase "Add to TagTeam". Just drag that button to your browser bar. If you don't have permission to tag for a given hub, you will not see the button on the hub's Taggers tab.

	* A '''filter''' is a rule for modifying tags. Hub members with suitable privileges can create filters, for example, to replace deprecated tags with approved tags, to replace misspelled tags with correctly spelled tags, and so on. TagTeam can apply filters to individual items, to individual input feeds, or to the entire hub. Filters are prospective (modifying all tags made in the future) and retroactive (modifying all tags already stored in the hub). Hub owners can use filters to tidy up a chaotic collection of tags, and to manage the evolution of a folksonomy of user-defined tags into an ontology or standard vocabulary of project-approved tags. The hub-wide filter powers the "folksonomy in, ontology out" approach that is TagTeam's most distinctive feature.		* A '''filter''' is a rule for modifying tags. Hub members with suitable privileges can create filters, for example, to replace deprecated tags with approved tags, to replace misspelled tags with correctly spelled tags, and so on. TagTeam can apply filters to individual items, to individual input feeds, or to the entire hub. Filters are prospective (modifying all tags made in the future) and retroactive (modifying all tags already stored in the hub). Hub owners can use filters to tidy up a chaotic collection of tags, and to manage the evolution of a folksonomy of user-defined tags into an ontology or standard vocabulary of project-approved tags. The hub-wide filter powers the "folksonomy in, ontology out" approach that is TagTeam's most distinctive feature.
Line 91:		Line 91:

	* [[#Logging in \|Log in]] to TagTeam and go to the desired hub.		* [[#Logging in \|Log in]] to TagTeam and go to the desired hub.
	* Click the '''~~Bookmarks~~''' tab.		* Click the '''Taggers''' tab.
	<!-- Note that in the revised design, this tab will get a new name. -->		<!-- Note that in the revised design, this tab will get a new name. -->
	* Drag the '''Add to TagTeam''' link to your browser's tool bar, where it will become a clickable button.		* Drag the '''Add to TagTeam''' link to your browser's tool bar, where it will become a clickable button.

WikiSysop at 20:55, 29 August 2018

2018-08-29T20:55:46Z

← Older revision		Revision as of 20:55, 29 August 2018
Line 11:		Line 11:

	* Visit the Harvard instance of [http://tagteam.harvard.edu/ TagTeam] itself.		* Visit the Harvard instance of [http://tagteam.harvard.edu/ TagTeam] itself.

			* <span style="background:yellow">Please bear with us as we update this page to reflect summer 2018 upgrades to the software.</span>
			<!-- {\| align="center" cellpadding="8" cellspacing="0" style="border: 1px solid black;"
			\| style="background:orange; color:black" \| Please bear with us as we update this user manual to reflect summer 2018 upgrades to the software.
			\|} -->

	== Preface ==		== Preface ==

Lfitzpatrick: /* Adding and using the bookmarklet */

2018-08-22T20:02:26Z

Adding and using the bookmarklet

← Older revision		Revision as of 20:02, 22 August 2018
Line 91:		Line 91:
	** Note that most browsers let you edit the name of the bookmarklet button, for example, to make shorter and save space on your browser bar.		** Note that most browsers let you edit the name of the bookmarklet button, for example, to make shorter and save space on your browser bar.

	[[File:~~Add-tagteam~~.~~gif~~\|600px]]		[[File:Bookmarklet_Add.png\|600px]]

	Once you install the bookmarklet, you can start tagging. The process is simple: When you're viewing a web page that you want to tag for TagTeam, click on the bookmarklet button and fill in the bookmarklet form that pops up.		Once you install the bookmarklet, you can start tagging. The process is simple: When you're viewing a web page that you want to tag for TagTeam, click on the bookmarklet button and fill in the bookmarklet form that pops up.

WikiSysop: /* Searching */

2018-08-22T17:25:36Z

Searching

← Older revision		Revision as of 17:25, 22 August 2018
Line 347:		Line 347:
	TagTeam uses the Apache Lucene search engine code library, with a few modifications. For full details on its power, and the syntax it supports in search queries, see the [http://lucene.apache.org/core/2_9_4/queryparsersyntax.html Apache documentation itself]. The instructions below outline the basics, including the points on which the TagTeam implementation departs from the unmodified Lucene search engine.		TagTeam uses the Apache Lucene search engine code library, with a few modifications. For full details on its power, and the syntax it supports in search queries, see the [http://lucene.apache.org/core/2_9_4/queryparsersyntax.html Apache documentation itself]. The instructions below outline the basics, including the points on which the TagTeam implementation departs from the unmodified Lucene search engine.

	TagTeam searches cover every part of the item record, and most importantly the title of the work tagged, the description entered by the tagger, and the tags.		TagTeam searches cover every part of the item record, and most importantly the title of the work tagged, the description entered by the tagger, the tagger's username, and the tags.

	=== Keyword searching ===		=== Keyword searching ===
Line 399:		Line 399:
	* You can mix keywords and tags in the same Boolean search.		* You can mix keywords and tags in the same Boolean search.
	** ''Example'': A search for ''write AND #read'' will pick up all the items containing the word "write" and the tag "read".		** ''Example'': A search for ''write AND #read'' will pick up all the items containing the word "write" and the tag "read".

			* You can mix tagger usernames with keywords and tags in the same Boolean search.
			** ''Example'': A search for ''(#read OR write) AND (User1 OR User2)'' will pick up all the items containing the either the tag "read" or the keyword "write" that were tagged either by User1 or User2.

	* You can combine Boolean operators with phrase, wildcard, or fuzzy searching.		* You can combine Boolean operators with phrase, wildcard, or fuzzy searching.