Pt:Ubiquity 0.1.2 User Tutorial: Difference between revisions

Por enquanto, o comand email utiliza o [http://mail.google.com Email do Google]. Então você só poderá seguir com esta parte do tutorial se possuir uma conta do GMail. Posteriormente, é claro, o comando irá trabalhar com todos os principais provedores de emails, e também com aplicativos como o [http://www.mozilla.com/en-US/thunderbird/ Thunderbird].  (Se você for um programador, [http://groups.google.com/group/ubiquity-firefox adoraríamos uma ajudada sobre isto].) Por hora, se você possuir uma conta do GMail, por favor conecte-se a ela. Se não tiver, talvez queira ir diretamente até próxima parte do tutorial.

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:

(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).

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.

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

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.

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

 

Here are some other examples you can try:

* 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.

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.

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

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.