Labs/Ubiquity/Interactive Tutorial Workspace: Difference between revisions

no edit summary
No edit summary
Line 21: Line 21:
  * Selecting, Executing (Translate, Google)
  * Selecting, Executing (Translate, Google)
  * How to get help and learn more commands
  * How to get help and learn more commands
=== 1 ===
'''Ubiquity Tutorial, part 1 of 6: How to start Ubiquity'''
Welcome to the Ubiquity tutorial.
Let's get started.  To summon Ubiquity, do this now:
'''Hold down the  keyCombo[0]  key and tap the
    keyCombo[1]  key.'''
(Note: keyCombo[0] and keyCombo[1] are replaced automatically with the current keystroke settings.)
=== 2 ===
This is the Ubiquity '''input box'''.  You can type commands here.
If you want to get out of Ubiquity without
giving a command, '''tap the Escape key'''.  Try that now.
=== 3 ===
'''Ubiquity Tutorial, part 2 of 6: Weather command and Previews'''
OK, so now let's learn a command. Summon Ubiquity again...
(Remember, '''hold down the  + keyCombo[0]  key and tap the
  + keyCombo[1]  key.''')
(Note: keyCombo[0] and keyCombo[1] are replaced automatically with the current keystroke settings.)
=== 4 ===
Now type the word '''weather'''...
=== 5 ===
Even before you're done typing, the '''preview area'''
shows a preview of the results of your command — in this case, a
weather report.
If you don't enter a location, the ''weather'' command takes a
guess where you are.
Now let's give it a location: '''type a space, and then the word
Chicago'''.
=== 6 ===
 
See how that works?  Feel free to delete
"chicago" and try some other locations.
When you're done checking the weather, '''hit the escape key.'''
=== 7 ===
'''Ubiquity Tutorial, part 3 of 6: Calculate command and Abbreviations'''
Summon Ubiquity again, and we'll learn some more commands.
=== 8 ===
This time, '''type just the letter 'c''''
(lower-case) and see what happens.
=== 9 ===
The Ubiquity '''suggestion list''' displays all of
the commands that start with the letter 'C'.
Let's say you want the ''calculate'' command.  You don't have
to type the whole command name.  Just '''type the letter 'A''''
(so that your input says ''''ca'''').
=== 10 ===
Now '''type a space, and then type 22/7'''
(so that your input says ''''ca 22/7''''.)
=== 11 ===
The ''calculate'' command will show you the
result of any arithmetic expression you type in.
When you're done experimenting with ''calculate'', '''hit the
escape key.'''
=== 12 ===
'''Ubiquity Tutorial, part 4 of 6: Wikipedia command and the suggestion list'''
Summon Ubiquity again...
=== 13 ===
'''Type the letter 'W', a space, and the word 'cheese''''.
(Like, 'w cheese').
=== 14 ===
Now '''tap the down-arrow key''' until the ''wikipedia'' command is
hilighted.
=== 15 ===
The ''Wikipedia'' command preview shows a snippet
from each article on Wikipedia matching your search term.
Those article titles are links — you can click on one of them to
open the article in a new page.
When you're done, close that page and come back here, or just '''tap
escape''' to move on with the tutorial.
=== 16 ===
'''Part 5 of 6: Selecting and Executing'''
If you select text on a web page before summoning Ubiquity, then
you can have your commands do things to the selected text.
Let's see an example. Use the mouse to '''select the Japanese text'''
below. Then '''summon Ubiquity'''.
The box below shows:
アドオンを選んで、自分だけのブラウザをつくろう。
=== 17 ===
Now issue the ''translate'' command.
('''type 'translate'''', or just 'tr').
=== 18 ===
At this point, you could type in some words that you want to have
Ubiquity translate.  But as you can see in the preview
area, Ubiquity is already translating the words that you have
selected.
Next, '''tap the enter key''' to execute the command.
=== 19 ===
Notice how the Japanese text that you selected was
''replaced'' with the translation.  That's because you executed
the command by pressing 'enter'.
Each command does something different when you execute it.  Most
often, it will open a new page, or change something on the current
page.
   
Click here to continue.
=== 20 ===
Let's do one more example.  Say you're browsing the
web and you come across an unfamiliar word... like the one in the box
below.
'''Select the word in the box below and then summon Ubiquity'''.
The box below shows:
aglet
=== 21 ===
You don't want to translate this word, you want to
look it up.  So '''issue the ''google'' command''' (type 'google'
or just 'goo').
=== 22 ===
Now, if the preview of the ''google'' command
tells you what you want to know, then you're done — you can dismiss
Ubiquity and go on your way.
But if you want more information, you can tap the enter key to
execute the ''google'' command, which will open the search results
in a new page.
It's up to you.
=== 23 ===
  '''Part 6 of 6: Getting Help and Learning  More Commands'''
So far you've learned the ''weather'', ''calculate'',
''wikipedia'', ''translate'', and ''google'' commands.
That's a good start, but there are dozens more commands
included with Ubiquity — plus you can find more on the Web.
How will you find out what commands are available?
One way is by using the ''help'' command.
'''Summon Ubiquity...'''
=== 24 ===
Suppose you want to know if there are any commands
that deal with tabs.  You can use the ''help'' command like this:
'''type 'help tab''''.
=== 25 ===
In the suggestion list, you can see all of the commands
that have 'tab' in their names.
Use the arrow keys to move through the suggestion list.  The preview
area shows help information about each command that you highlight.
When you're done, '''tap escape'''.
=== 26 ===
Finally, there's the ''command-list'' command.  This command will take
you to a page that shows every command Ubiquity has installed.  You can
learn all sorts of useful things by browsing the command-list page!
This is the end of the tutorial. Once you go to the command-list
page, you are on your own to experiment and learn new commands at your
own pace.
'''Summon Ubiquity, issue 'command-list', and tap the enter key to execute.'''
Good-bye!
1,007

edits