Difference between revisions of "Overleaf instruction"
From Hall A Wiki
| Line 9: | Line 9: | ||
* edit using git | * edit using git | ||
| − | ** click "share" on the project | + | ** click "share" on the project web page to get its git link, then clone,edit,push just like any git repository. |
| + | ** '''for protected project which needs overleaf useremail and password to access, git version >= 1.8.3 is needed'''. The default version in centos7 git-1.8.3 will work, but the default version in centos6 git-1.7.1 will fail with a 401 Unauthorized error, you can use the higher version at /apps/bin/git if your computer is in jlab network | ||
** it only has the master branch, no other branch is allowed | ** it only has the master branch, no other branch is allowed | ||
** a labeled web edit will show up as a commit in git history, many unlabeled web edit will be combined into one commit in git history once someone did a git fetch | ** a labeled web edit will show up as a commit in git history, many unlabeled web edit will be combined into one commit in git history once someone did a git fetch | ||
Revision as of 20:53, 30 March 2017
overleaf.com is an online collaborating tool for latex. Several persons can edit at the same time, everyone can see all changes in real time. All edits are auto saved, there is labeling and git version control ability built in
To edit or make comments in the latex source, signup and signin at https://www.overleaf.com with a good browser (latest firefox or Chrome is recommended)
For a protected project, you should have a link in email once you are given access, click on it to add it into your projects
- general rule for our document
- We use pdflatex, so don't use any eps for figures, use pdf instead or png,jpg if you have to.
- edit using git
- click "share" on the project web page to get its git link, then clone,edit,push just like any git repository.
- for protected project which needs overleaf useremail and password to access, git version >= 1.8.3 is needed. The default version in centos7 git-1.8.3 will work, but the default version in centos6 git-1.7.1 will fail with a 401 Unauthorized error, you can use the higher version at /apps/bin/git if your computer is in jlab network
- it only has the master branch, no other branch is allowed
- a labeled web edit will show up as a commit in git history, many unlabeled web edit will be combined into one commit in git history once someone did a git fetch
- instructions for web editing and commenting
- click "project" to see file panel, then choose a tex file to edit or comment, choose a dir to upload file into it, drag and drop to move files and dirs around
- click "+" to make comment at the current location in tex file, you can also delete comments once it's fixed
- Use "Source" in editing instead of "Rich text"
- "copy,cut,paste" in "Edit" editor menu and right-click menu don't work yet, use browser edit menu or keyboard short Ctrl-C,Ctrl-X,Ctrl-V (win) Command-C,Command-X,Command-V (mac) instead
- let "preview" stay at "manual", NOT at "auto", then click "refresh preview" to compile, any error will show up for you to debug
- If "refresh preview" gives no error, you can click "pdf" to download a pdf of the current version. This is better way to view the doc instead of preview if the document is long.
- add a label after you have some major edit by "history & revisions"
- check out its help page
Ask Zhiwen Zhao zwzhao@jlab.org for any question
