How To Use Authorea Offline

Authorea Help

Authorea is an online collaborative editor, but working offline is possible, as long as you get acquainted with the versioning control technologies we use to save and track your documents: Git and GitHub (Use Bitbucket or Gitlab? Look at the note at the end of this document). This how-to guide will assume you have some basic knowledge of Git and that you have a Github account already. You can link your Authorea article with a Github repository very easily: in just one click.

Linking up Authorea and Github. From your article (main view):

  1. Make sure you are an admin (if not, ask the lead author to make you so)

  2. Click on the gear icon (Settings )

  3. Scroll down to the Advanced Settings and click on Setup Github Integration under Offline mode

  4. In the page that opens up, shown below, click on the big button Setup Github integration automatically

That’s it! Authorea and Github: connection established! Your Authorea article and Github repo are now seamlessly linked to one another. You should see a screen that tells you that the Git access bridge was successfully set up. This means that every change made to your Authorea article online will automatically be reflected on the Github repository. Similarly, when you (or your coauthors) work offline on the paper and then push their changes, the online article will automatically be updated.

Working offline. If you navigate back to your Github repository, you will see that all the basic Authorea files (bibliography folder, figures folder, etc) are now in the repo. You can now work offline using your editor of choice and push/pull to/from this Github repo to update the Authorea article. Note: if Authorea bumps into merging conflicts, it will push to a fail-safe branch called authorea .