Differences

This shows you the differences between two versions of the page.

--- help:search_engine_key [2012/01/17 18:24] – [Where's my AppId?] eros
+++ help:search_engine_key [2012/05/30 15:25] (current) – removed eros
@@ Line 1: / Line 1: @@
-====== Bing AppId ======
-==== Why do I need an AppId? ====
-At the end of June 2011 Yahoo terminated the free search service BootCaT had been using for years, so we were forced to find an alternative solution.
-On August 5, 2011 version 0.6 of the BootCat front-end (which includes version 0.16 of the toolkit) was released. Starting from this version, the [[http://www.bing.com/|Bing]] search engine is used to retrieve URLs. Bing's service is not as generous as the one the now defunct Yahoo Search API used to provide, but it's the next best thing: you can use the service for free but an [[help:search_engine_key#what_s_an_appid_and_how_do_i_get_one|AppId]] is required for the system to work. To obtain an AppId you just need to register (for free) on the Bing website.
-We realise this is not ideal, but there's really no alternative (that we know of, if you know of an alternative, please [[http://bootcat.sslmit.unibo.it/?section=contacts|contact us]]): Google and Yahoo now require paid accounts to provide the kind of service BootCaT needs, Bing is free (at least for now).
-==== BootCaT and Bing are two very different things ====
-The authors of BootCaT (mostly people working at the universities of Bologna and Trento) are in no way affiliated with Bing (a commercial search engine controlled by Microsoft).
-The page you are reading has been created to provide a simple explanation of what is needed for BootCaT to work. We are not responsible for anything related to Bing.
-==== What's an AppId and how do I get one? ====
-An AppId is a sort of password: it's a very long string of letters and numbers. Unlike a password, you don't get to choose what your AppId is, it's assigned to you and you can't change it.
-To get your free Bing AppId:
-  * make sure you have a **"Windows Live ID"** (i.e. a **Hotmail** e-mail address), if don't have one already, you can sign up (for free) [[https://signup.live.com|here]]
-  * visit http://www.bing.com/developers and click on "Sign in - Bing Search API":
-{{:bing:developer.jpg|}}
-  * login using you Windows Live ID:
-{{:bing:login.jpg|}}
-  * in the next screen click "Add":
-{{:bing:add.jpg|}}
-  * fill out the registration form and click on "Save" (as you can see, only general information is required):
-{{:bing:form.jpg|}}
-==== Where's my AppId? ====
-Once you've filled out the form and clicked on "Save", you should see something like this (your AppId will be in the area marked by the red line in the picture below):
-{{:bing:appid.jpg|}}
-Sometimes the key doesn't appear immediately, just refresh the page by pushing the refresh button on your browser.
-Remember that you don't need to create a new AppId every time you install BootCaT, you can use the same key on multiple computers.
-**NB**: it's advisable to use **copy/paste** to insert the key in the relevant box inside BootCaT, you can use the key combination CTRL-C (copy) and CTRL-V (paste) on Windows and Linux or CMD-C (copy) and CMD-V (paste) on Mac.