Labs/Ubiquity/Interactive Tutorial Workspace: Difference between revisions

No edit summary
 
(9 intermediate revisions by the same user not shown)
Line 4: Line 4:


(You can try out this tutorial in action if you install Ubiquity from the latest source-code checkout, by using the 'help command or going to the about:ubiquity page.)
(You can try out this tutorial in action if you install Ubiquity from the latest source-code checkout, by using the 'help command or going to the about:ubiquity page.)
The tutorial is divided into short segments of text, each one containing instructions. (I've numbered the text segments on this page -- those numbers don't appear when the tutorial is running.) When the tutorial is running, it pauses after showing each segment of text and waits until the user has completed the instructions before proceeding.
On this page, I've put everything that is actually part of the tutorial contents text in
boxes like this one
so that it will not get mixed up with the commentary text, which is outside of the boxes.


Once everybody has hacked on the contents here to their satisfaction, I will put them back into the source code.
Once everybody has hacked on the contents here to their satisfaction, I will put them back into the source code.
Line 21: Line 29:
  * Selecting, Executing (Translate, Google)
  * Selecting, Executing (Translate, Google)
  * How to get help and learn more commands
  * How to get help and learn more commands
== Part 1 of 6: How to Start Ubiquity ==


=== 1 ===
=== 1 ===
Line 30: Line 40:
  Let's get started.  To summon Ubiquity, do this now:
  Let's get started.  To summon Ubiquity, do this now:


  '''Hold down the keyCombo[0] key and tap the  
  '''Hold down the keyCombo[0] key and tap the keyCombo[1]  key.'''
    keyCombo[1]  key.'''


(Note: keyCombo[0] and keyCombo[1] are replaced automatically with the current keystroke settings.)
(Note: keyCombo[0] and keyCombo[1] are replaced automatically with the current keystroke settings.)


=== 2 ===
=== 2 ===
(At this point, the tutorial adds a visual indication to the input box part of the ubiquity panel.)


  This is the Ubiquity '''input box'''.  You can type commands here.
  This is the Ubiquity '''input box'''.  You can type commands here.
Line 41: Line 52:
  If you want to get out of Ubiquity without
  If you want to get out of Ubiquity without
  giving a command, '''tap the Escape key'''.  Try that now.
  giving a command, '''tap the Escape key'''.  Try that now.
== Part 2 of 6: Weather command and Previews ==


=== 3 ===
=== 3 ===
Line 48: Line 61:
  OK, so now let's learn a command. Summon Ubiquity again...
  OK, so now let's learn a command. Summon Ubiquity again...


  (Remember, '''hold down the + keyCombo[0]  key and tap the  
  (Remember, '''hold down the keyCombo[0]  key and tap the keyCombo[1]  key.''')
  + keyCombo[1]  key.''')


(Note: keyCombo[0] and keyCombo[1] are replaced automatically with the current keystroke settings.)
(Note: keyCombo[0] and keyCombo[1] are replaced automatically with the current keystroke settings.)


=== 4 ===
=== 4 ===
(Visual indication on the input box again.)


  Now type the word '''weather'''...
  Now type the word '''weather'''...


=== 5 ===
=== 5 ===
(Visual indication on the preview area this time.)


  Even before you're done typing, the '''preview area'''
  Even before you're done typing, the '''preview area'''
Line 75: Line 91:


  When you're done checking the weather, '''hit the escape key.'''
  When you're done checking the weather, '''hit the escape key.'''
== Part 3 of 6: Calculate command and Abbreviations ==


=== 7 ===
=== 7 ===
Line 83: Line 101:


=== 8 ===
=== 8 ===
(Visual indication on the input box.)


  This time, '''type just the letter 'c''''
  This time, '''type just the letter 'c''''
Line 88: Line 108:


=== 9 ===
=== 9 ===
(Visual indication on the suggestion list.)


  The Ubiquity '''suggestion list''' displays all of
  The Ubiquity '''suggestion list''' displays all of
Line 97: Line 119:


=== 10 ===
=== 10 ===
(Indication on the input box.)


  Now '''type a space, and then type 22/7'''
  Now '''type a space, and then type 22/7'''
Line 102: Line 126:


=== 11 ===
=== 11 ===
(Visual indication on the preview area.)


  The ''calculate'' command will show you the
  The ''calculate'' command will show you the
Line 108: Line 134:
  When you're done experimenting with ''calculate'', '''hit the  
  When you're done experimenting with ''calculate'', '''hit the  
  escape key.'''
  escape key.'''
== Part 4 of 6: Wikipedia command and the suggestion list ==


=== 12 ===
=== 12 ===
Line 116: Line 144:


=== 13 ===
=== 13 ===
(Visual indication on the input box.)


  '''Type the letter 'W', a space, and the word 'cheese''''.
  '''Type the letter 'W', a space, and the word 'cheese''''.
Line 122: Line 153:


=== 14 ===
=== 14 ===
(Visual indication on the suggestion list.)


  Now '''tap the down-arrow key''' until the ''wikipedia'' command is
  Now '''tap the down-arrow key''' until the ''wikipedia'' command is
Line 127: Line 160:


=== 15 ===
=== 15 ===
(Visual indication on the preview area.)


  The ''Wikipedia'' command preview shows a snippet
  The ''Wikipedia'' command preview shows a snippet
Line 136: Line 171:
  When you're done, close that page and come back here, or just '''tap
  When you're done, close that page and come back here, or just '''tap
  escape''' to move on with the tutorial.
  escape''' to move on with the tutorial.
== Part 5 of 6: Selecting and Executing ==


=== 16 ===
=== 16 ===
Line 208: Line 245:


  It's up to you.
  It's up to you.
== Part 6 of 6: Getting Help and Learning More Commands ==


=== 23 ===
=== 23 ===


   '''Part 6 of 6: Getting Help and Learning More Commands'''
   '''Part 6 of 6: Getting Help and Learning More Commands'''


  So far you've learned the ''weather'', ''calculate'',  
  So far you've learned the ''weather'', ''calculate'',  
1,007

edits