Labs/Ubiquity/Ubiquity 0.5 User Tutorial: Difference between revisions

Back to [[Labs/Ubiquity]].

== In other languages ==

== Download ==

= Welcome =

[[image:email_jono.png]]

The commands that come with Ubiquity are just the beginning: anyone can create new commands and share them.  Creating Ubiquity commands — and [http://www.azarask.in/blog/post/sharing-streamable-functionality/ extending the web] — should be as easy as creating a web page.

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 to make Ubiquity easier to use, or an idea for its future 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.

You'll need to install [http://growl.info/ Growl].  This is a Mac OS X system extension that applications can use to display unobtrusive transparent messages.  Ubiquity uses Growl notifications to show you the output of commands and tell you about errors.

On Windows (XP and later), you don't need to install anything special, as Ubiquity will use the operating system's built-in "toaster"-style pop-up messaging.

On Linux, you shouldn't have to do anything special: just make sure you're updated to the latest version of Firefox.

There is an interactive tutorial that takes you through how to use Ubiquity.  You can get to it by typing '''about:ubiquity''' into the address bar.  This tutorial is meant to supplement the built-in interactive tutorial.  It goes over the basics of Ubiquity, some examples of cool things you can do with commands, how to teach Ubiquity new commands, and how to get help with Ubiquity.

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?"

[[Image:Command-list.png]]

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

== Teaching Ubiquity New Commands ==

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.