Webmaker/searching: Difference between revisions
(Created page with "== How to Search for Tags on Webmaker.org/search == Tags are bits of text that describe a make. Tags can contain any text, excluding commas. To search for a single tag, simp...") |
(How to Search on Webmaker.org/search) |
||
| Line 1: | Line 1: | ||
= How to Search = | |||
Tags are | Every make that Webmaker.org knows about can be searched for thanks to metadata stored in the [https://github.com/mozilla/MakeAPI Make API] about each and every make. The Make API is a tool that indexes all the makes created by Webmakers around the world, and exposes their data for searching. | ||
[https://webmaker.org/search Webmaker.org's search page] uses the [https://github.com/mozilla/makeapi-client MakeAPI's search API] to find makes based on your interests. | |||
We're constantly building upon and improving our tools, And this page will attempt to keep you informed of the latest search capabilities available. If something appears to be broken, or out of date, please [https://bugzilla.mozilla.org/enter_bug.cgi?product=Webmaker&component=General file a bug on Bugzilla]. | |||
=== Search Type === | |||
By default, your search query will filter for matches on a make's title, description, tags and Webmaker username. | |||
You can select which attribute of a make you would like to have your search query applied to by selecting it with the drop down menu to the left of the search input box. | |||
[[File:webmaker-choose-type.png|How To Choose Your Search Type|500px]] | |||
=== User === | |||
Searching by user allows you to find makes created by a specific person or entity. | |||
[[File:webmaker-user-search.png|Example of User Search|500px]] | |||
=== Title, Description === | |||
When searching for title and description, the contents of the search input are used as-is. This means that if you enter "abc 123" (without quotes) and select a title or description filtered search, your results will only contain makes that match the query exactly as it is. | |||
[[File:webmaker-title-search.png|Example of a Title search|500px]] | |||
We're working to enhance the search tools to allow for full-text searching on title and description, updates will be posted here as soon as they're available to use! | |||
=== Tags === | |||
Tags are snippets of text that describe a make. A make can have zero or many tags. Tags can contain any letters or numbers. Tags can also contain symbols, with some exceptions. | |||
Commas have special meaning in our search tools, and can not be used in tags (see explanation about tag search syntax below). | |||
A colon (':') in a tag indicates what we call an Application Tag. These tags cannot be applied by webmaker users, but are searchable. An example of a commonly used Application tag is (without quotes): "webmaker:featured" | |||
[[File:webmaker-app-tag.png|Searching for an Application Tag|500px]] | |||
To search for a single tag, simply type it into the search input area: | To search for a single tag, simply type it into the search input area: | ||
Revision as of 19:27, 23 July 2013
How to Search
Every make that Webmaker.org knows about can be searched for thanks to metadata stored in the Make API about each and every make. The Make API is a tool that indexes all the makes created by Webmakers around the world, and exposes their data for searching.
Webmaker.org's search page uses the MakeAPI's search API to find makes based on your interests.
We're constantly building upon and improving our tools, And this page will attempt to keep you informed of the latest search capabilities available. If something appears to be broken, or out of date, please file a bug on Bugzilla.
Search Type
By default, your search query will filter for matches on a make's title, description, tags and Webmaker username.
You can select which attribute of a make you would like to have your search query applied to by selecting it with the drop down menu to the left of the search input box.
User
Searching by user allows you to find makes created by a specific person or entity.
Title, Description
When searching for title and description, the contents of the search input are used as-is. This means that if you enter "abc 123" (without quotes) and select a title or description filtered search, your results will only contain makes that match the query exactly as it is.
We're working to enhance the search tools to allow for full-text searching on title and description, updates will be posted here as soon as they're available to use!
Tags
Tags are snippets of text that describe a make. A make can have zero or many tags. Tags can contain any letters or numbers. Tags can also contain symbols, with some exceptions.
Commas have special meaning in our search tools, and can not be used in tags (see explanation about tag search syntax below).
A colon (':') in a tag indicates what we call an Application Tag. These tags cannot be applied by webmaker users, but are searchable. An example of a commonly used Application tag is (without quotes): "webmaker:featured"
To search for a single tag, simply type it into the search input area:
To search for multiple tags, enter them into the search box and separate them with commas:
