Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "ECF/DocShare Plugin"
| Line 1: | Line 1: | ||
ECF version 2.0.0 includes a plugin called DocShare ('''org.eclipse.ecf.docshare''') that implements real-time shared editing. | ECF version 2.0.0 includes a plugin called DocShare ('''org.eclipse.ecf.docshare''') that implements real-time shared editing. | ||
| + | |||
| + | =Requirements= | ||
| + | |||
| + | *[http://www.eclipse.org/ecf/downloads.php ECF 2.0.0]. ECF 2.0.0 will run on either Eclipse 3.3 and/or Eclipse 3.4. | ||
| + | *Connect via a supported provider that supports the [[ECF_API_Docs#Datashare_API | ECF Datashare API]]. Supported providers are: XMPP/Google Talk, Skype (found [http://ecf1.osuosl.org here]). Instructions for connecting are [http://help.eclipse.org/help33/index.jsp?topic=/org.eclipse.ecf.doc/html/gettingstarted/quickStart.html here]. | ||
=How to Use= | =How to Use= | ||
| − | |||
| − | |||
*Open a TextEditor on a text resource from your workspace (e.g. a .java file, or .txt file). | *Open a TextEditor on a text resource from your workspace (e.g. a .java file, or .txt file). | ||
| − | *Open the Context Menu (right click) on the editor, and you should see a context menu like this | + | *Open the Context Menu (right click) on the text editor, and you should see a context menu like this |
[[Image:docshareslewis2.png]] | [[Image:docshareslewis2.png]] | ||
| − | *Select the target user to share your editor session with. Note that if you select a target user | + | *Select the target user to share your editor session with. Note that if you select a target user that is not running ECF client, it will have no effect and the target user will not see a notification. In the near future (ECF 2.0.1), only the users that support/are running docshare will appear in this list, but for now all contacts will appear. |
| − | that is not running ECF it will have no effect and the target user will not see a notification. In the near future, only the users that support/are running docshare | + | |
| − | Once the receiver accepts the docshare, both participants may edit the document and the | + | Once the receiver accepts the docshare, both participants may edit the document via their local editor and the changes will be immediately distributed to the other participant via ECF. |
===How to Stop=== | ===How to Stop=== | ||
Revision as of 19:39, 16 June 2008
ECF version 2.0.0 includes a plugin called DocShare (org.eclipse.ecf.docshare) that implements real-time shared editing.
Requirements
- ECF 2.0.0. ECF 2.0.0 will run on either Eclipse 3.3 and/or Eclipse 3.4.
- Connect via a supported provider that supports the ECF Datashare API. Supported providers are: XMPP/Google Talk, Skype (found here). Instructions for connecting are here.
How to Use
- Open a TextEditor on a text resource from your workspace (e.g. a .java file, or .txt file).
- Open the Context Menu (right click) on the text editor, and you should see a context menu like this
- Select the target user to share your editor session with. Note that if you select a target user that is not running ECF client, it will have no effect and the target user will not see a notification. In the near future (ECF 2.0.1), only the users that support/are running docshare will appear in this list, but for now all contacts will appear.
Once the receiver accepts the docshare, both participants may edit the document via their local editor and the changes will be immediately distributed to the other participant via ECF.
How to Stop
- Open the context menu for the editor being shared.
- Select "Stop Sharing Editor with ..."
Screen Shots
'slewis' client (the initiator), before starting editor sharing
'fliwatuet' client (the receiver), before starting editor sharing
Slewis initiates the real-time shared editing by opening the context menu in the editor, and choosing Share Editor With -> slewis@ecf.eclipse.org ->ECF -> fliwatuet@ecf.eclipse.org
Fliwatuet receives a notice and can accept or reject the shared editing session
If fliwatuet accepts, the editor is opened with slewis' current editor content on fliwatuet's workbench
At this point, both participants can edit the text and updates will be immediately distributed and shown on the other's corresponding editor.
So, for example, here fliwatuet enters a new method (baz)
These same updates appear immediately on slewis' workbench. Slewis can also make changes and these are reflected on fliwatuet's workbench.
