View source for It:Ubiquity 0.1.2 User Tutorial

Torna a [[Labs/Ubiquity]].

==Traduzione in corso ==

Al momento la localizzazione in italiano della guida non è ancora completa, puoi contribuire anche tu al processo di localizzazione traducendo qualche sezione o corregendo quanto è già stato tradotto.  Questo è soltanto un messaggio di servizio, quando la traduzione verrà complentata verrà eliminato

[[ja:Ubiquity 0.1.2 User Tutorial|????]] [[es:Ubiquity 0.1.2 User Tutorial|En español]] [[zh-CN:Ubiquity 0.1.2 User Tutorial|????]]

=Benvenuto=

Ubiquity è un'estensione sperimentale di Mozilla Firefox che implementa un nuovo modo di interagire sul Web.

Sicuramente sarai abituato a <b>digitare indirizzi </b> nella barra per indirizzare Firefox sui siti che vuoi visitare:

http://farm4.static.flickr.com/3159/2421200474_1bf74ef498_o.png

Dopo aver installato Ubiquity, potrai istruire Firefox  su cosa fare digitando <b>comandi</b> in una nuova barra di input:

http://www.toolness.com/images/20080819151657.jpg

I comandi di Ubiquity possono fare di tutto. In Ubiquity sono già presenti dei comandi che permettono di eseguire operazioni molto comuni in maniera rapida e semplice. In questa guida, potrai imparare ad usare alcuni di questi comandi.   Dopo aver letto questa guida, sarai in grado di effettuare  velocemente una ricerca con wikipedia, google, definition e yelp,  aggiungere mappe alle tue email e tradurre delle parti di pagina, evidenziare delle parole e quindi inviarle via email ai tuoi amici. 
   
The commands that come with Ubiquity are just the beginning: anyone can create new commands and share them.  Creating Ubiquity commands&mdash;and [http://www.azarask.in/blog/post/sharing-streamable-functionality/ extending the web]&mdash;should be as easy as creating a web page.
If you want to learn how to create your own commands, please see the [[Labs/Ubiquity/Ubiquity_0.1_Author_Tutorial|Developer Tutorial]].

Ubiquity is still a work in progress, and we are eager for you to join our virtual team to experiment.  If, when reading this tutorial, you think of a way that Ubiquity could be made easier to use, or an idea for its fututure development, we hope you'll take a moment to [http://getsatisfaction.com/mozilla/products/mozilla_ubiquity share your thoughts].  By getting involved with Ubiquity while the project is still in its early stages, you have an opportunity to shape the direction of its growth.

==Utenti Mac...==

Sarà necessario installare [http://growl.info/ Growl], un'estensione del sistema operativo MACOS X che permette alle applicazione di mostrare delle notifiche discrete e trasparenti. Ubiquity utilizza il sistema di notifica Grownl per visualizzare l'output dei  comandi e i messaggi di errore.
 
Su Windows (XP e successivi),non sarà necessario installare nulla di particolare, in quanto Ubiquity utilizza il sistema di notifiche nativo "toaster", un sistema di notifiche in  stile popup.

Su Linux, non è richiesto nulla di particolare, solo assicurarsi di avere installato l'ultima versione disponibile di Mozilla Firefox.

= Le basi =

==Avviare Ubiquity ==

Se non è già stato fatto, [https://people.mozilla.com/~avarma/ubiquity-0.1.xpi installare  Ubiquity] (oppure da [https://addons.mozilla.org/en-US/firefox/addon/9527 Mozilla Addons]). Una volta fatto questo, è possibile richiamare Ubiquity usando i tasti  '''option-spazio''' su Mac, o '''control-spazio''' su Windows. Su Linux, provare con  '''control-alt-spazio'''

Una volta che è stata premuta la corretta scorciatoia da tastiera, nella parte superiore sinistra di Firefox verrà mostrata una barra nera e trasparente con il cursore bianco e  lampeggiante..

http://www.toolness.com/images/20080714190900.jpg

Per far eseguire a Ubiquity un comando, digitare del testo e premere invio, Per motivi di brevità, nel seguito di questa guida si farà riferimento a questa operazione con "lanciare" un comando. Nel seguito di questa guida "lanciare XYZ"  deve essere interpretato come:  « premere "alt-spazio" (oppure ctrl-spazio) per richiamare Ubiquity, quindi digitare "XYZ" ».

== Primo comando: ricerca su Wikipedia==

Cominciamo con la ricerca su Wikipedia. Supponiamo di voler conoscere cosa sia "babel fish" . Per saperlo, sarà sufficiente lanciare "wikipedia babelfish".

Mentre si digita il comando è possibile vedere due cose sotto la casella di immissione del comando:  un '''elenco di suggerimenti''' e una '''anteprima''' del comando corrente. Nell'immagine qui sotto, i suggerimenti sono costituiti da "wikipedia" e "weather", mentre l'anteprima è rappresentata da  "Searches Wikipedia".

http://www.toolness.com/images/20080819152417.jpg

Quando si è completato la digitazione di  "wikipedia babel fish" si dovrebbe vedere una sintesi di alcune pagine di Wikipedia riguardanti BabelFish, come nell'immagine:

http://www.toolness.com/images/20080819152930.jpg

Ci vorrà un po' affinché le informazioni vengano recuperate da Wikipedia, ciò nonostante, Ubiquity continuerà a rispondere ai comandi anche nell'attesa della risposta di wikipedia.

A questo punto, è possibile:

* premere invio per  '''eseguire''' il comando. Nel caso si esegua il comando "wikipedia" si  verrà rimandati sulla pagina di wikipedia.
* HPremere Esc per <b>abortire</b> il comando. Ubiquity svanirà senza fare nulla.
* Cliccare su uno dei <b>collegamenti</b> visualizzati nell'anteprima. Nel nostro caso, verrà aperto l'articolo di Wikipedia che abbiamo scelto.

==Abbreviare i comandi e utilizzare i suggerimenti ==

"Wikipedia babel fish" è abbastanza lungo da digitare. È possibile salvare le proprie dita dall'usura sfruttando i suggerimenti proposti da Ubiquity. Come si è visto nella sezione precedente, digitando "w" Ubiquity suggerisce tutti i comandi che iniziano con questa lettera, nello specifico "wikipedia" e "weather".

Continuando a digitare e aggiungendo una "i", la lista dei suggerimenti viene aggiornata mostrando l'unico comando che comincia con "wi"&mdash;"Wikipedia".. A questo punto, è possibile premere la barra spaziatrice e continuare a scrivere la nostra frase, Ubiquity capisce che il comando che si vuole richiamare è "wikipedia".  Così, lanciare "wi babelfish" è la stessa cosa che lanciare "wikipedia babelfish".

Ma facciamo un altro esempio. Supponiamo di voler conoscere la situazione meteo su Chicago.  Provare lanciando "w chicago".

http://www.toolness.com/images/20080819155204.jpg

Come si può vedere dall'immagine, il primo comando nell'elenco dei suggerimenti è  "wikipedia chicago".  Premendo invio, questo sarà il comando che verrà eseguito.  Ma questo non è quello che noi vogliamo, così utilizziamo  <b>la freccia in basso</b> per evidenziare il secondo suggerimento "weather Chicago".

A questo punto, nell'anteprima sarà visualizzata la situazione meteo su Chicago e premendo invio si potrà visualizzare la pagina su Wunderground.com.

Naturalmente, lo stesso risultato si sarebbe ottenuto lanciando "we chicago", oppure anche "we 60601" (il codice postale di Chicago).

==Eseguire un comando su una selezione ==

Spesso, le cose che si vogliono ricercare sono proprio davanti ai nostri occhi, nella pagina che stiamo  leggendo. Allora, perchè prendersi la briga di ridigitare quello che è già a nostra disposizione ?

Selezionare le parole "Mountain View, California" usando il mouse:

  Mountain View, California

A questo punto, richiamare Ubiquity e digitare le prime lettere del nome del comando:

http://www.toolness.com/images/20080819155845.jpg

Oppure, supponendo di leggere una pagina ed incontrare una parola a noi sconosciuta:

  aglet

Basterà selezionarla e lanciare "define" per conoscerne il significato.

Lo stesso risultato si sarebbe ottenuto digitando "define aglet"&mdash; oppure anche  "def aglet", o anche  "def this".  (Ubiquity associa "this" alla selezione").

= More Command Examples =

== Emailing == 

Right now, the email command uses [http://mail.google.com Google Mail].  That means you'll only be able to follow along with the next part of the tutorial if you have a GMail account.  Eventually, of course, the command should work with all major web-based email providers, as well as applications like [http://www.mozilla.com/en-US/thunderbird/ Thunderbird].  (If you're a programmer, [http://groups.google.com/group/ubiquity-firefox we'd love some help with that].)  For now, if you have a GMail account, please make sure you're logged in.  If you don't, you might want to skip ahead to the next part of the tutorial.

Assuming you're logged into your GMail account, issue "email".  In the suggestion list, you'll see a suggestion that says "Email (message) (to contact)".

http://www.toolness.com/images/20080819160313.jpg

This is a clue that the Email command expects two pieces of information:  the message is <b>what</b> you're emailing, and the contact is <b>who</b> you want to send it to.  However, you can leave out one of these things &mdash; or both of them &mdash; and the Email command will still work.  So I can issue any of these commands:

* "email hello"
* "email to chris"
* "email hello to chris"
* "email to chris hello"

I'm using "chris" because that's the name of someone in my GMail contacts list.  If you don't have a "chris" in your contacts list, just substitute the name of any of your friends in these examples.

Let's say I've found an interesting fact on a web page and I want to send it to Chris.  I can select part of the page, including links, pictures, and anything else, and then issue "email this to chris".  Ubiquity understands "this" to refer to my selection.  (I could also have said "email it to chris" or "email selection to chris" -- all of these are equivalent.)  The selected part of the page shows up in my preview:

[[Image:Email-picture-selection.png]]

(Actual email addresses blurred out to protect the innocent.) Since I know several people named Chris, there are several lines in the suggestion list -- one each Chris in my GMail contacts list.  I can arrow-key down to the Chris I want and then hit the Enter key.

I'm taken to the GMail "compose new email" page.  The chunk of the page that I selected is reproduced in the body of my email, the "to" field is filled with the email address I selected, and the "subect" field contains the title of the web page I was on.  I can now edit this email to add anything else I want to say, before clicking "Send".

== The Map command ==

Let's say you're arranging to meet up with a friend at a restaurant, and you want to include a map in the email.  (Yes, it's Aza's favorite example.)

Type out the address you want to map, then select it and issue "map".  In the preview, you'll see a thumbnail-size map of the area (from Google Maps).

[[Image:Map-preview-1.png]]

If you execute the command, you'll be taken to the Google Maps page.  Or, you can click on the image in the preview to get a larger, interactive version.  After scrolling and zooming this map to your liking, you can click the "insert map in  page" link to insert the map into your email.

[[Image:Map-preview-2.png]]

You can give it a try by selecting the address below and issuing "map":

 Mozilla Corporation, 1981 Landings Drive, Mountain View, CA

Then click the image in the preview to get the larger map, then click the "insert map in page" link and watch what happens.  Surprised?

== The Translate command ==

That's right, Ubiquity commands can alter the contents of a page, even if the page wouldn't normally be editable.  A command that makes good use of this ability is the "Translate" command.  To try it, select the text below and issue "translate" (or just "tra") and execute.

  21??????????????????????

It's translation-by-machine, so the results are bound to sound awkward, but at least you can get the gist of the meaning.

The full command is

 translate (text) (from language) (to language)

So you can specify what language you want to translate from, and what language you want to translate to.  If you leave either of these out, Ubiquity will just make a guess about what you want.

Here are some other examples you can try:

* "tr good evening to spanish"
* "tr buenas tardes from spanish to french"
* Select some English text on this page and then: "translate this to german"

= Going Further =


== Getting Help and Discovering Commands ==

By now you're probably wondering, "How many commands are there?  What are they all called?  How am I supposed to know what a command could be unless I memorize them all?"

These are good questions!  To start getting some answers, issue the "command-list" command, and hit Return to execute it.  You'll be taken to a special page listing every command you have installed, and describing what each one does.

[[Image:Command-list.png]]

For more general help, you can execute the "help" command.  Here, you can change the hotkey that you use to activate Ubiquity, un-subscribe from command feeds, and so on.

The general help page and the command-list page link to each other, so whichever one you open, you can get to the other with a single click.

You can also get to the main help page by typing '''about:ubiquity''' into the Firefox URL bar.



== Teaching Ubiquity New Commands ==

We've mentioned that anyone can create Ubiquity commands.  Once created, these commands can be embedded in any web page.  If you have Ubiquity installed and you visit a page with an embedded command, Firefox will present you with the option of <b>subscribing</b> to the command.

To see this in action, you can visit [http://hg.toolness.com/ubiquity-firefox/raw-file/7435416f211a/examples/sample-cmd.html this example page on Atul's personal site].  You should see a bar coming down from the top of the browser window asking you whether you want to subscribe to the command or not.

http://www.toolness.com/images/20080820111209.jpg

If you choose to subscribe, you'll see a rather scary-looking warning page:

http://www.toolness.com/images/20080820111725.jpg

It's important to understand the '''dangers''' of subscribing to Ubiquity commands from sites that you don't trust.  Since a Ubiquity command can do anything, and it has full access to your web browser, a bad person could write a Ubiquity command to steal your personal information or do malicious things to your computer.  You should not install Ubiquity commands unless you are confident that the source is trustworthy.

In the future, we'll be creating something called a "trust network" that Ubiquity users can use to share knowledge about which commands are trustworthy.  When you visit a page with an embedded command, you'll be able to see what your friends with Ubiquity have said about this command -- whether they've given it a thumbs-up or left you a warning to let you know it could be dangerous.  This system doesn't exist yet, but once it does we will modify this section of the tutorial to let you know how to use it.