Difference between revisions of "Orion/Overview for Eclipse Committers"
|Line 85:||Line 85:|
Revision as of 20:41, 31 January 2011
Welcome to Orion. This page will get you started with using the Orion demo server, hosted at http://orion.eclipse.org.
We've given existing Eclipse committers access to the demo server to kick the tires, and hopefully to inspire you to become involved in the project. The demo represents a few months of effort by a handful of developers. It is not a full-functioning development environment, but we believe it is far enough along to give you an idea of where we would like to go, and to inspire you to think of ideas about how Orion could be integrated with other web development tools.
Logging into Orion
When you first attempt to access the Orion server, you'll be prompted for credentials. All Eclipse committers have been given an Orion id. Your user name is the email you have registered with the Eclipse Foundation. Your password <will be emailed???>. If you have any questions or your credentials are not working, contact <??????>
Working with Resources
In Orion, each user has a virtual "workspace" where they can work with various folders and files. These files are maintained on the Orion server. Please note that for the time being, data may be periodically deleted from the Orion server.
For demo purposes, we currently populate every user's workspace with two folders that contain some of the Orion client source code. Once you've successfully logged into Orion, you should see two folders:
This is the default navigator view for Orion. To navigate the files, you may either expand the folders (using the triangles), or you may click on the folder links to drill into that folder. The breadcrumb at the top of the navigator allows you to navigate back up the tree.
The commands that operate on the navigator are located adjacent to the breadcrumb. Commands that apply to individual files or folders are located in the "Actions" column next to the item.
If you prefer a more traditional tree view that uses context menus, you can switch the navigator view to "Tree View" using the button at the top of the page. (We are currently offering both views as we evolve the overall navigation UI and where contributed commands appear. See Bug 334189 and its dependents for more detail about this work.)
If you wish to use Orion to edit some of your own code, you can create folders and files using the buttons adjacent to the breadcrumb.
You may also upload zip files containing your work to the server using the import button. You must first create a folder in which to import the code (the import button is not active from the workspace root). To import code from Eclipse (or any other IDE) into Orion, you must first zip up the files you wish to import. Choose this zip file in the file selection prompt offered in the import dialog. (Choosing a non-zip file may break the import dialog on some browsers, see Bug 335890).
The contents of the zip file will appear in a new folder in the navigator.
To export code from Orion to your workstation, navigate to the folder you wish to export and choose the "Download as Zip" link.
You can use the "Favorites" icon to bookmark a folder or file in your navigator. A link to this folder or file will appear in your favorites list and can be used to navigate quickly to that file or folder.
Once you've navigated to the file you want to work with, click on its link to open the editor. You'll find that the editor supports the basics (cut/copy/paste, undo/redo) as well as your favorite text-editing features from Eclipse desktop (move up/down, copy up/down, go to line, find, incremental find). For now, most of these commands are accessible only through keyboard shortcuts, using the default keybindings in Eclipse desktop.
The Orion server is Firebug-savvy, so that links in Firebug can invoke the Orion editor to make corrections. (Must use Firebug v1.71 or greater).
Syntax highlighting of CSS files is also supported. We've also implemented a bare-bones content assist based on CSS keywords.
We've implemented a simple HTML outliner based on DOM ids. (No syntax highlighting support yet).
Other languages and content types
Would you like to see more support for these languages? Or another language (PHP, Ruby, etc.) supported? Or pluggable editors for other content types (images, docs, etc.). Get involved! We have implemented these various language features as proof of concept and want to work toward a more structured extension model for the editor.
Once you are actively using Orion, you'll find that you want to move quickly between different resources. There are several ways to go about this.
The search box in the Orion navigator will perform a global search on everything in your user workspace.
The "Open resource" dialog will let you search for a file by name. It can use wildcards similar to the Eclipse desktop Open Resource dialog.
You can search on a highlighted phrase from inside the editor