TagTeam FAQ

From Harvard Open Access Project
Jump to navigation Jump to search

How do I get a TagTeam account?

  1. Go to the Harvard instance of TagTeam and click the Sign in link in the upper right corner. Or go directly to the Sign up page.
  2. Fill out the form.
    • Note that the Harvard instance of TagTeam is limited to academic or research projects. Use the form to give a brief description of your project. If you want to tag for an existing TagTeam project, just say that.
    • Click the green Sign up button (not the blue Log in button).
Once you have an account in TagTeam, you may create new hubs (projects).

How do I create a TagTeam hub?

  • Once you create an account and log in, you'll see a big blue button on the front page that says, Start a hub. Just press it and you're nearly done. Give your hub a title, a nickname, and a description, and you're done. You may create more than one hub if you like.
Once you've created a hub, you may tag for it and authorize others to tag for it as well. To tag for an existing hub, created by someone else, you'll need the permission of the hub owner, which you can request through the "Contact" tab on that hub.

How do I get permission to tag for a hub owned by someone else?

  1. Log in to TagTeam, and go to the click on the hub for which you'd like permission to tag, for example, the Open Access Tracking Project.
  2. Click on that hub's Contact tab in the left sidebar. Fill in the form, for example, by asking for permission to tag. Click Submit.
  3. The hub owner will receive the message and make a decision.

What can I do without a TagTeam account, or when I'm not logged in?

Without signing up or signing in, you can:

  • See a list of all the hubs running on a given instance of TagTeam.
  • Run searches in any hub.
  • Subscribe to any of the feeds published by the hub.
  • Request permission to tag for an existing hub. But you must have a TagTeam account before your request can be approved.
  • Select any tab on any hub and view its information in read-only mode. Among other things, this means you can view the lists of tags and taggers at a given hub. But you must create an account and log in if you want to create a new hub or make any changes to an existing hub.

How do I subscribe to a tag feed?

  • First, find any occurrence of the tag in which you're interested. Click on it and you'll get a pop-up menu. Click on the top option ("View items tagged with [TAG]"). That will take you to the tag home page, also called the tag library.
  • On the tag library page, you'll see the three feed icons in the upper right corner (RSS, Atom, JSON). Click the format of your choice, and put the feed URL in your favorite feed aggregator.
  • If you want to subscribe to more than one tag feed, you can subscribe to each one separately. Or you can combine them into one remix feed and subscribe to the remix feed. Naturally you can share the URL to the remix feed just as easily as you can share the URL of any simple or individual feed.
  • Finally, of course, you can view the tag library without subscribing to its feed. For example, just bookmark its URL and revisit whenever you want to an update. The page is organized like a blog with the most recent items on top.

How do I subscribe to a search feed?

  • First run a search.
  • On the search-results page, you'll see the three feed icons in the upper right corner (RSS, Atom, JSON). Click the format of your choice, and put the feed URL in your favorite feed aggregator.
  • The search-results page also offers a permalink for the search (just below the search box). If you bookmark the search, every time you return, you'll get the latest results. You can also share the permalink in emails, social-media posts, or publications.
  • The search-results page also offers you an option ("Add to a remix feed") to make the search feed a component in a remix feed.
  • Subscribing to a search, bookmarking one, or incorporating it into a remix feed is useful even for simple searches. But it's even more useful for complicated searches that would be difficult to recreate or retype, for example, searches using boolean operators, proximity operators, quoted phrases, and so on. In the latter case, refine your initial search until it does just what you want. Then take the following steps.
  • Finally, of course, you can view the search results without subscribing to them, bookmarking them, or incorporating them into remix feeds.

I'm a hub owner. How do I add taggers to my project?

  • Invite them to (1) create a TagTeam account, and (2) ask permission to tag for your hub (both described above). When their request comes through (by email), approve them (in the Team or Community tab of your hub), and give them the permissions you want them to have.
  • If your project already has a working tag vocabulary, point them to it or help them learn it.

I'm a hub owner. How do I prevent spam in my project feeds?

  • The only people who can tag for your project are those you authorize. If some of them tag items that are off-topic for the project, you can ask them to stop or you can revoke their authorization to tag.

How do I create a private hub or use private tags?

  • You can't. TagTeam outputs are open access.
  • We might add private hubs and private tagging in a future version. (If you can't wait, you can fork TagTeam and add these features at any time.)

How do I search a given hub?

  • Go to the home page for that hub in TagTeam, and use the search box at the bottom of the left sidebar.
  • For details on the search features and syntax, see the section of the TagTeam manual on searching. Preview: You can search tags, keywords, or both. You can run phrase searches, wildcard searches, or boolean searches. You can bookmark any search, create a new feed from the results of any search, or add the results of any search to a remix feed combining many different OATP feeds.
  • If you use Chrome, you can search a given directly from the omnibox (the search and URL bar). Go to Chrome Settings, then to Manage search engines. Scroll to the bottom of the page. In the Add a new search engine text field, enter the name of the hub (for example, "OATP" or "Open Access Tracking Project"). In the keyword field, enter a short nickname (for example, "oatp"). In the URL field, enter http://tagteam.harvard.edu/hubs/oatp/item_search?utf8=%E2%9C%93&q=%s&commit=Go, replacing /oatp/ with the name or number of the hub you want to search. Then click Done. Once you've set this up and want to search (for example) OATP from Chrome, just enter "oatp [search string]" in the omnibox and Chrome will run the OATP search for you. Because Chrome is harnessing TagTeam's internal search engine for that hub, your search string should use the same syntax you'd use it TagTeam itself. For example, to search for a tag like sample-tag, search for #sample-tag. You can also use quoted phrases, boolean operators, and so on.

How do I search across two or more hubs?

  • TagTeam does not yet support this feature. However, TagTeam hubs are crawled by Google.

Does TagTeam support user-defined tags?

  • Yes. In fact, in the current version, hub owners cannot prevent their authorized taggers from using user-defined tags, except by removing their authorization to tag.
  • We developed TagTeam to support a vision of "folksonomy in, ontology out" and get the best of both worlds. As users introduce useful new tags, we can approve and recommend them, and add them to OATP's standard vocabulary. In addition, TagTeam lets us convert deprecated tags to approved tags, automatically, and OATP takes advantage of that power. For more detail on how TagTeam supports the automatic conversion of certain tags to other tags, see the section of the TagTeam manual on tag filters.

How can I tell whether a certain item has already been tagged in a certain hub?

  • First, you can search for it in that hub (see the previous question).
  • Second, if you're authorized to tag for that hub, then try to tag the item you're wondering about. If the tag form pops up blank, the item has not yet been tagged. If it pops up pre-populated with tags, then it has already been tagged. In the second case, you could withdraw, knowing that the item has already been tagged, or you could review the tags and add any new ones you think should be added.

How can I tell whether a certain tag is already in use in a certain hub?

  • Go to the hub's home page within TagTeam, and click on the Tags tag in the left sidebar. Sort the tags alphabetically, and look for the one you have in mind.
  • You could also append the tag you're wondering about to this URL template, http://tagteam.harvard.edu/hubs/HUB/TAG/, replacing HUB with the TagTeam name or number of that hub, and replacing TAG with the tag you're wondering about.
  • Some hubs post a (public, evolving) list of project-approved tags. For example, see the

To see whether a given tag is an approved or official project tag, look at the for the Open Access Tracking Project.

How can I deep-link to the tag library of all items with a given tag in a given hub?

How can I deep-link to the tag library of all items tagged on a given date in a given hub?

Retrieved from "http://cyber.harvard.edu/hoap/?title=TagTeam_FAQ&oldid=6000"