Labs/Ubiquity/Documentation/Command Documentation

From MozillaWiki
Jump to: navigation, search

Contents

Template

Here's a template you can use when adding documentation for a command:

command-name

Description: a single sentence that says what the command does.

also called synonym

by Author - licensed as License

View more information at http://website.url.com

Detailed help text, including an example of how to use the command, sample 
arguments and what they will do, whether you should select text before using 
it, how to interact with the preview, what happens if you execute it as 
opposed to just previewing it, limitations on its use, etc.

Mozilla Browser Commands

exit-firefox

Exits firefox

restart-firefox

Restarts firefox

close-window

Close current window

fullscreen

Toggles fullscreen mode

tab

Switches to the tab that matches the given name.

close-tab

Closes the tab that matches the given name, or the current tab if no name is supplied.

close-related-tabs

Closes all open tabs that have the given word in common.

count-tabs

Counts the number of opened tabs. Takes an optional filter term to count number of tabs matching filter term.

refresh

Refresh current document

bookmark

Add current document to bookmarks

print

Print current page

back

Go back in history

forward

Go forward in history

home

Go to home page

zoom

Zooms the Firefox window in or out.

tag

Adds a tag to describe the current page.

If the page is currently bookmarked, adds a tag or tags (separated by spaces)
to the current bookmark.  If the page is not bookmarked, adds a bookmark to
"Unsorted bookmarks" and also adds the tag to that bookmark.

by Dietrich Ayala - licensed as MPL/GPL/LGPL

View more information at http://autonome.wordpress.com/.

bookmarklet

Runs a bookmarklet from your favorites.

also called bml, js

by satyr - licensed as MIT

Enter nothing to reload the list.

Mozilla Social Networking Commands

twitter

Sets your Twitter status to a message of at most 160 characters.

also called tweet

You'll need a Twitter account, obviously.
If you're not already logged in you'll be asked to log in.

digg

If not yet submitted, submits the page to Digg. Otherwise, it takes you to the story's Digg page.

also called share-on-digg

by Sandro Della Giustina - licensed as MPL,GPL

View more information at http://www.gialloporpora.netsons.org.

tinyurl

Replaces the selected URL with a TinyUrl

share-on-delicious

Share the current page as a bookmark on delicious.com

by Leslie Michael Orchard - licensed as MPL/GPL/LGPL

View more information at http://decafbad.com.

Select text on the page to use as notes, or enter your own text after the
command word. You can also assign tags to the bookmark with the "tagged"
modifier, and alter the bookmark default page title with the "entitled"
modifier. Note that you must also already be logged in at delicious.com
to use this command.

rypple-ask

Asks a question on Rypple

View more information at http://www.rypple.com/ubiquity/ask.html.

You'll need a Rypple account and be logged in

Mozilla Developer Commands

view-source

Shows you the source-code of the web page you're looking at.

syntax-highlight

Treats your selection as program source code, guesses its language, and colors it based on syntax.

convert

Converts a selection to a PDF, to rich text, or to html.

escape-html-entities

Replaces html entities (<, >, &, " and ') with their escape sequences.

selector-selector

* Lets you type a jQuery selector and highlights matched elements.
* Hovering on an element generates a matching selector.

cers, satyr - licensed as MIT


Left-click / Enter
* Copy and Quit
Middle-click / C
* Copy
Right-click / Esc / Q
* Quit
M
* Move
PageUp/Dn
* Scroll vertically
shift + PageUp/Dn
*Scroll horizontally

Mozilla Page Editing Commands

delete

Deletes the selected chunk of HTML from the page.

undelete

Restores the HTML deleted by the delete command.

edit-page

Puts the web page into a mode where you can edit the contents.

In edit mode, you can edit the page like any document: Select text,
delete it, add to it, copy and paste it. Issue 'bold', 'italic', or
'underline' commands to add formatting. Issue the 'save' command to save
your changes so they persist even when you reload the page. Issue
'stop-editing-page' when you're done to go back to the normal page
viewing mode.

stop-editing-page

If you used the 'edit page' command to put the page into editable mode, use this command to end that mode and go back to normal page viewing. If you want the changes to persist on page reload, issue the 'save' command first.

save

Saves edits you've made to this page in an annotation. They will persist on page reload. You can remove them with the 'remove-annotation' command.

remove-annotations

Resets any annotation changes you've made to this page.

Mozilla General Utility Commands

bold

If you're in a rich-text-edit area, makes the selected text bold.

italic

If you're in a rich-text-edit area, makes the selected text italic.

underline

If you're in a rich-text-edit area, underlines the selected text.

undo

Undoes your latest style/formatting or page-editing changes.

redo

Redoes your latest style/formatting or page-editing changes.

highlight

Highlights your current selection, like this.

word-count

Displays the number of words in a selection.

link-to-wikipedia

Turns a phrase into a link to the matching Wikipedia article. You must be in a rich-text editable field.

calculate

Calculates the value of a mathematical expression.

Try it out: issue "calc 22/7 - 1".

gcalculate

Calculate using Google's calculator. Has all the features of a scientific calculator, knows constants such as the speed of light, and can convert between units and currencies.

by Axel Boldt - licensed as Public domain

View more information at http://math-www.uni-paderborn.de/~axel/ubiquity.html.

Try: 5% of 700 
     sin( sqrt( ln(pi)))
     (1+i)^3, 15 mod 9
     (5 choose 2) / 3!
     speed of light in miles per hour
     3 dollars in euros 
     100 USD in GBP (US dollar in Pounds)
     242 in hex
     MCMXVI in decimal

sparkline

Graphs the current selection, turning it into a sparkline.

also called graph

by Aza Raskin - licensed as MIT

Select a set of numbers -- in a table or otherwise -- and use this
command to graph them as a sparkline. Don't worry about non-numbers
getting in there. It'll handle them.

translate

Translates from one language to another.

You can specify the language to translate to, and the language to translate from.

For example, try issuing "translate mother from english to chinese". 

If you leave out the languages, it will try to guess what you want. It works on selected text in any web page, but there's a limit (a couple of paragraphs) to how much it can translate a selection at once. If you want to translate a lot of text, leave out the input and it will translate the whole page.

create-bookmarklet-command-from

Creates a new command from your saved bookmarklet when give the bookmarklet name.


by Abimanyu Raja - licensed as MPL

create-new-search-command

Creates a new Ubiquity command from a search-box and lets you set the command name.

by Marcello Herreshoff [Homepage] - licensed as GPL/LGPL/MPL

contributed by Abimanyu Raja, satyr

View more information at http://stanford.edu/~marce110/verbs/new-command-from-search-box.html.

 # Select a searchbox.
 # Execute this command to create the new search command.

Mozilla Email Commands

detect-gmail-apps-domain

Looks for and returns the gmail-for-apps domain.

detect-email-provider

Guesses your web-based email provider and displays it in a notification.

email

Begins composing an email to a person from your contact list. also called gmail.com

Currently only works with Google Mail , so you'll need a Gmail account to
use it. Try selecting part of a web page (including links, images, etc)
and then issuing "email this".
You can also specify the recipient of the email using the word "to" and
the name of someone from your contact list. For example, try issuing
"email hello to jono" (assuming you have a friend named "jono").

last-email-from

Displays your most recent incoming email. Requires a Gmail account.

get-email-address

Looks up the email address of a person from your contacts list given their name. Execute to copy the address.

Mozilla Calendar Commands

add-to-calendar

Adds an event to your calendar.

Enter the event naturally . e.g.:
   * 3pm Lunch with Myk and Thunder
   * Jono's Birthday on Friday
Currently, only works with Google Calendar so you'll need a Google account to use it.

check-calendar

Checks what events are on your calendar for a given date.

Try issuing "check thursday"
Currently, only works with Google Calendar so you'll need a Google account to use it.

Mozilla Map Commands

map

Turns an address or location name into a Google Map.

Try issuing "map kalamazoo". You can click on the map in the preview pane
to get a larger, interactive map that you can zoom and pan around. You
can then click the "insert map in page" (if you're in an editable text
area) to insert the map. So you can, for example, type an address in an
email, select it, issue "map", click on the preview, and then insert the
map.

map-these

Maps multiple selected addresses or links onto a single Google Map. (Experimental!)

Mozilla Web Search Commands

search

Search using your installed search engines

Use the "with" modifier to specify any Open Search engine you have installed.

google

Searches Google for your words. It previews your top 3 search results and allows a keyboard short cut [ctrl+alt+(1,2, or 3)] to select them.

wikipedia

Searches Wikipedia for your words, in a given language. It also previews the top 5 results.

also called lookup

by Blair McBride - licensed as MPL

contributed by Viktor Pyatkovka

View more information at http://theunfocused.net/moz/ubiquity/verbs/.

imdb

Searches the Internet Movie Database for your words (www.imdb.com).

also called movie, actor

yahoo-search

Searches Yahoo for pages matching your words. It also previews your top 3 results.

amazon

Searches Amazon.com for items matching your words. It also previews your top 5 results.

Available Indices:
   All Apparel Automotive Baby Beauty Books Classical DigitalMusic DVD
Electronics GourmetFood Grocery HealthPersonalCare HomeGarden Industrial
Jewelry Kitchen Magazines Merchants Miscellaneous Music
MusicalInstruments OfficeProducts OutdoorLiving PCHardware PetSupplies
Photo Shoes Software SportingGoods Tools Toys VHS Video VideoGames
Watches Wireless WirelessAccessories

VideoSurf

Performs a VideoSurf video search with advanced preview of your top 4 results.

also called video, videos, videosurf

by Udi Falkson

View more information at http://www.videosurf.com/.

Please email us at feedback@videosurf.com if you have any trouble or
feature ideas!

youtube

Searches YouTube for videos matching your words. Previews your top 3 results.

flickr

Searches Flickr for pictures matching your words. Previews top 8 pictures.

also called images

bugzilla

Searches Bugzilla for Mozilla bugs matching the given words.

msn-search

Searches MSN for the given words.

ebay-search

Searches EBay for auctions matching the given words.

ask-search

Searches Ask.com for the given words.

answers-search

Searches Answers.com for the given words.

yelp

Searches Yelp for restaurants matching your words. Previews top 4 results.

You can search for restaurants near a certain location using the near
modifier. For example, try "yelp pizza near boston".

weather

Checks the weather for a given location. It detects your location as a default argument. May also take optional argument for unit, c or f, for celsius or fahrenheit.

Try issuing "weather chicago". It works with zip-codes, too.
Or "weather in c" gives the weather of your current location in celsius.

define

Gives the meaning of a word in preview area. Searches answers.com.

Try issuing "define aglet"

image-search

Browse and embed pictures from Google Images

also called getimages

by Federico Parodi - licensed as MPL

View more information at http://www.jimmy2k.it/getimagescommand.

Press return to show the Google Images results, left click on a picture
to watch it, right click to insert it in a text or rich text area

Mozilla Image-Related Commands

rotate-image

rotate-page

flip-page

desaturate-image

invert-image

edge-detect-image

Mozilla built-in commands

help

Takes you to the Ubiquity main help page.

Or, enter the name of a command to get help on that command.

also called about, ?

command-editor

Takes you to the Ubiquity command editor page.

command-list

Opens the list of all Ubiquity commands available and what they all do.

skin-list

Takes you to the page where you can change your skin.

report-bug

Reports a Ubiquity bug. Report includes browser specifications, installed extensions, plugins and recent errors.

browser specs in bug report:
name	Firefox
version	3.0.10
numberOfWindows	1
numberOfTabs	3
cookieEnabled	true
language	en-GB
buildID	2009042316