Written by Axelle Janiak, version 1 (2020-05-14)
If you need to collaborate in real time on the encoding of a file with others, it can be useful to use the teletype tool of the Atom editor. Before following this procedure, see the previous guide to install Atom.
Go in your toolbar to the
Atom > preferences..., depending your computer. In the opening settings, go to the tab
+install at the bottom of the left panel.
teletype and click on the
Or install Teletype with the following link:
atom://settings-view/show-package?package=teletype and click
Open Atom in the box that pops up.
Click on the antenna icon in the Atom status bar at the bottom right of the Editor.
You’ll be prompted with the message in the picture on the left telling you to go to teletype.atom.io/login.
There, you will be given a unique token to input into Atom. Note that this operation has to be done only once.
Sign in with your token, if you are the host of the collaboration. Slide the switch to start sharing a portal to your workspace.
Then invite people to join your portal by sending them your portal URL.
Once someone has provided you with a link to their portal, click on the antenna icon in the Atom status bar at the bottom right of the Editor.
You click on
Join Portal and enter the link that the host just sent.
The portal opens and all collaborators can edit together in real time. An avatar for each collaborator connected will appear on the right side of the screen. If you click one, you will then be following the person’s work.
Once the collaborative working session is done. The host must save the changes, stage, commit and push them on GitHub, otherwise the work won’t be stored and shared on DHARMA repositories. To do so, you can use your usual tool or operate with the git and GitHub possibilities provided by Atom. See the Git and Atom Guide to know more about it.