most recent 30 from http://mathoverflow.net 2013-05-19T21:45:13Z http://mathoverflow.net/feeds/question/3044 http://www.creativecommons.org/licenses/by-nc/2.5/rdf http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing Tyler Lawson 2009-10-28T13:15:11Z 2012-09-25T16:28:31Z

<p>I personally use a revision control system (git) to manage my own paper writing, back things up, and synchronize between different machines. However, I've found most programmer's revision control systems to require a bit too much training to try and push on a co-author for the purposes of working on a joint paper.</p> <p>Are there any people out there using software tools to help handle joint writing? How successful have they been?</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/3047#3047 Gerald Edgar 2009-10-28T13:39:11Z 2009-10-28T13:39:11Z

<p>How about a wiki?</p> <p>Every collaboration has its own personality, so I am sure there is no best-for-everyone solution to this question.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/3050#3050 Lars 2009-10-28T13:44:53Z 2009-10-28T13:44:53Z

<p>I've been using <a href="http://getdropbox.com" rel="nofollow">Dropbox</a> for a while. It works like this: You sign up at their webpage for free to get 2gb space which you can access via their webinterface. If you want (and this is the novel part) you can install their software, which sets up a folder on your computer which is automatically (and in the background) synchronized with their server. You can share folders with other dropbox users. Underlying their system is a modified version of svn (I think), and you can go back to revisions via their webinterface. I don't know how concurrent editing is handled.</p> <p>There are some features missing (selective synching, branching, milestones) but overall it's an awesome free service. The software is very well done and not distracting, I am synching folders from my office computer (linux) with my home computer (windows xp) and it works like a charm.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/3060#3060 Michael Lugo 2009-10-28T14:40:01Z 2009-10-28T14:40:01Z

<p>I've heard that the reason people like Google Wave is precisely because it makes collaboration easy. I don't have experience with it, though; perhaps somebody who has used it can comment?</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/3066#3066 Humberto Rafeiro 2009-10-28T15:08:45Z 2009-10-28T15:08:45Z

<p>There is a tool that is very promising, it is called <em>ScribTeX</em>, The free collaborative LaTeX editor. Its description is giving</p> <blockquote> <p>Welcome to ScribTeX, the online collaborative LaTeX editor. ScribTeX allows you to work on LaTeX documents from anywhere with internet access and share them with your friends and colleagues easily. You can:</p> <pre><code>* Create and edit LaTeX documents and automatically render them to PDFs; * View a complete revision history of all your files; * Keep your documents private, allow people of your choosing to view or edit them, or publish them to world; * Use BibTeX to keep track of your references and include them in LaTeX documents; * Upload images and include them in your LaTeX documents; * Create custom style files and use them in your LaTeX documents. </code></pre> </blockquote> <p>Hope this can help many of us doing better collaborative work.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/3095#3095 TG 2009-10-28T17:25:11Z 2009-10-28T17:25:11Z

<p>I've been using svn for all my papers for about a year, and I can't imagine not using some kind of version control now. I've had no problem with getting coauthors to use it, though I don't have any technophobe collaborators.</p> <p>The disadvantage of Dropbox (much as I love it for other things) is that it's not so good for simultaneous editing; no easy way to merge commits. You also don't get to keep a complete revision history with comments.</p> <p>I'm less convinced of the value of Google Wave so far; real time typing is almost a distraction, and if I want to discuss math in real time I'm usually best off using the phone, I find.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/3109#3109 Andrew Stacey 2009-10-28T18:38:18Z 2009-10-28T18:47:57Z

<p>I use bzr (any particular reason why git, by the way?) and I've ended up using it for just about everything: papers, seminars, teaching, configuration files, my entire website, just about everything I do on a computer is in a bzr repository. Although I've yet to convince any collaborator to use it as well, I still find that it makes life easier since I can easily keep a record of when I sent something to someone else and merge in changes against that particular revision. I can also publish a repository and make it easy for a collaborator to have access to the files without needing to use bzr themselves.</p> <p>Within a paper, I use the changes.sty package for sharing comments back and forth between myself and a collaborator.</p> <p>Bzr has "nice" frontends so it might be possible to persuade a non-technologically minded person to use it (I'm a commandline junkie so have no experience of the available GUIs).</p> <p>I also use a wiki (nlab, naturally) but that is (at the moment) for less focussed projects than a specific paper. However, when writing anything substantial there then I do it "offline" (even so far as to "compiling" and viewing it) and only sending it into the ether when I'm happy with it.</p> <p>I find it completely incomprehensible that people want everything to be "in the cloud". I have access to several high-powered computers which are capable of running whatever software I'm using incredibly fast. Why would I swap that for a slow, crackly internet link which is guaranteed to be down the one time that I really need it? By using a DVCS (distributed version control system), I only need to be connected to the internet at the start of a given session and I can get my files off any one of a number of machines so it doesn't matter if one or other is down. In the worst case scenario that I can't connect, I can work offline on something and then merge my changes back again later. Indeed, my entire DVCS currently takes up a mere 71Mb (of which 25Mb consists of my local copies of Instiki and xournal) so I could easily carry it around with me on a memory stick (encrypted, of course).</p> <p>If I really did want to do some "real time" collaboration, I would use either gobby (for working on files or papers) or jarnal (for working on maths). Gobby has real-time editing (and has had for quite some time) whilst with jarnal I can use my graphics tablet to actually write the mathematics for the other person to see just as if we were at a blackboard together. After all, if I'm doing real-time collaboration then I don't want to bother with getting the LaTeX syntax exactly right. I'm not bad at TeX, but if I'm in "Math Mode" then I don't want to be bothering with it.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/5033#5033 dougashton 2009-11-11T11:57:56Z 2009-11-11T11:57:56Z

<p>Google Wave does have a robot called watexy that can add maths into conversations. Once you've added it you put LaTeX commands inbetween double $$ signs and it automatically replaces it with an image.</p> <p>Useful for a maths chat but by no means usable for hacking together a paper or a proof that you can later cut and paste into a proper LaTeX document.</p> <p>It's a start though.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/5037#5037 Jon Awbrey 2009-11-11T12:30:50Z 2009-11-11T12:30:50Z

<p>People who like MediaWiki or Semantic MediaWiki might look into the facilities at <a href="http://mywikibiz.com/" rel="nofollow">MyWikiBiz</a>. This is a "directory" site that operates on a 2-level model. There are mainspace pages that can be edited by anyone &mdash; these are supposed to be verifiable and so on. Then there are author-owned directory pages that only the author and sysops can edit &mdash; these are free to be anything within bounds of ethical and legal reason. Collaborative work is possible via the discussion pages and any number of user subpages that you want to create, where a group can hash out a draft and then have the principal or responsible author copy the latest authorized version to the directory page for the paper. I haven't used the Semantic MW and ASK Query features all that much, but they are there for the asking.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/5055#5055 Gregory Kohs 2009-11-11T14:50:34Z 2009-11-11T14:50:34Z

<p>Just to add to Jon Awbrey's generous plug for my wiki website, MyWikiBiz... I am currently working behind the scenes with Dr. Martin Hepp who heads the e-business &amp; web science research group at the Universitaet der Bundeswehr Muenchen, to implement the "GoodRelations" semantic properties to our site, which will hopefully organize and streamline a host of semantic data fields (attributes and relations). It will be geared more toward business information, but I'm just pointing out that I am actively willing to collaborate with research/university initiatives to make MyWikiBiz your academic workshop, even if for simply testing out ontologies or collaboration styles. -- Gregory Kohs</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/5101#5101 Jason Polak 2009-11-11T20:38:50Z 2009-11-11T20:38:50Z

<p>For joint collaboration I've used subversion. Having a central repository I think is a really good idea for a paper, although you can set up central repositories in bzr and git. </p> <p>I would stay away from git for two reasons, however. First, Windows support doesn't seem to me that great. You have to either use something like Cygwin or the port, which is hardly optimal. Unfortunately many people use Windows. The second is that it's a bit harder to use git. I love git myself but subversion is straightforward: there's commit (and conflict), whereas with git you have a local repository you can commit to and then you can also push to a remote repository.</p> <p>In the end I like subversion for collaborative efforts. The only downside is if you really like to branch your work, then subversion is horrible compared to git or bzr. Bzr and svn also have nice version numbers ;)</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/5134#5134 Alex 2009-11-12T01:16:58Z 2009-11-12T01:16:58Z

<p>This may not be exactly what your looking for, but people are using wiki's to collaboratively write papers. Polymath collaborations are discussed on this blog. And recently a collaborative paper was posted on arXiv from people working on the <a href="http://michaelnielsen.org/polymath1/index.php?title=Main%5FPage" rel="nofollow">polymath wiki</a>. This is joint writing taken to the limit.</p> <p><strong>*New users can only post one link! Sorry, my links to the paper and blog were removed *</strong></p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/5327#5327 Jose Capco 2009-11-13T08:52:06Z 2009-11-13T16:01:17Z

<p>Sadly, I haven't collaborated yet.. but I would use svn for collaboration. If it's supposed to be a top-secret collaboration, then I'd go for a commercial web svn repository (lots out there that are very cheap). If you think no one could really steal the work from you or that it's ok for people to read it, I would use a free svn repository. The pain is when your partner isn't a techy person, you can't even ask him to merge new versions of works with some sort of merger.. you are supposed to do all the merging from his end. </p> <p>As for myself, I would not use svn. I usually have papers 15 pages long or so, and I just keep backups everytime I make a milestone and then zip the whole thing (like every month or so).. in case something goes wrong I go back to the backup, it's like a small scale inefficient svn.. but you don't want to kill a bird with an atomic bomb. Always worked for me, I'm not sure for writing books.. probably an svn would become necessary, but I won't be suprised if my backup technique work as well.. it worked for my PhD dissertation anyway :p</p> <p><strong>EDIT</strong>: Most of us mathematician wouldn't have our entire .tex work exceeding 200Mb. For that I would recommend the svn web repositories like (these support closed source, i.e. private projects): <a href="http://www.xp-dev.com/" rel="nofollow">XP-Dev</a> and <a href="http://unfuddle.com/" rel="nofollow">Unfuddle</a> These two are free if you don't exceed 200Mb and you can choose to have the project (you are allowed max 2 or 1 projects for these free repositories.. but I would just keep them in one big folder and name them as 1 project). I like the look and feel of Unfuddle, but XP-Dev isn't that bad either. The advantage of SVN is that it caters for both windows and linux users (for windows I'd recommend TortoiseSVN Client). In case you exceed the 200Mb (which for our purpose is hardly believable.. unless you have lots of images in your LaTeX documents), then I would recommend <a href="http://www.assembla.com" rel="nofollow">Assembla</a> because it's very cheap (like \$3/Month/user + \$0.3/100Mb/User) and reliable and you can buy as much space as you want.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/5391#5391 balazs komuves 2009-11-13T16:48:46Z 2009-11-13T16:48:46Z

<p>A (distributed) version control system which has a solid theoretical background, unlike most others, is <a href="http://darcs.net" rel="nofollow">darcs</a> (originally written by a physicist). Unfortunately it does not have a nice user interface yet, so it may be not easy to "force" your coauthors to use it... </p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/13815#13815 Yossi Farjoun 2010-02-02T10:53:27Z 2010-02-02T10:53:27Z

<p>One tool that works better than diff (in my opinion) is latexdiff <a href="http://www.ctan.org/tex-archive/support/latexdiff/" rel="nofollow">http://www.ctan.org/tex-archive/support/latexdiff/</a> . The advantage is that the result is a tex file with the deleted text struck-out and the added text underlined. It also uses color. the reason this is nice is for collaborating with people that don't want to use your version control method. once you get the file back from them you simply commit it to the repository and then use latexdiff-vc to see the differences. One of my collaborators likes writing latex in one long line (one line per paragraph) so using regular diff is almost useless with him....</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/19807#19807 Michael 2010-03-30T08:42:51Z 2010-03-30T08:42:51Z

<p>If you like Google Docs there is something (currently still in development) called <a href="http://docs.latexlab.org/" rel="nofollow">Latexlab</a> which is</p> <blockquote> <p>an open source implementation of a web based LaTeX editor for Google Docs</p> </blockquote> <p>I haven't played too much with it, but it looks very nice, so I thought I'd point it out here. One can try it out on the website.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/19818#19818 Yuri Bakhtin 2010-03-30T12:11:01Z 2010-03-30T12:11:01Z

<p>I use svn even for my papers with no coauthors. I have a repository at my department that gets backed up frequently, and I can have a copy of the repository on any machine in the world. It keeps track of changes and I know exactly which version was sent to the journal or arxive.org, etc. It allows for simultaneous edits by the collaborators. It is also easy to learn, at least the basics.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/19866#19866 Alex 2010-03-30T19:08:12Z 2010-03-30T19:08:12Z

<p><a href="http://crocodoc.com/" rel="nofollow">Crocodoc</a> is a new site that has helped me collaborate on already-written papers.<br> For document generation, <a href="http://etherpad.com/" rel="nofollow">Etherpad</a> is still my favorite collaborative text editor by far.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/21540#21540 Alejandro Erickson 2010-04-16T06:21:48Z 2010-04-16T06:21:48Z

<p>On most papers it is far easier to coordinate your efforts by email than it is to learn svn or whatever. But I think the best is yet to come and it will be part of the class of tools being pioneered by scribtex.com verbosus.com and docs.latexlab.org. Take any of these and add -ftp or similarly convenient uploading, -some kind of guarantee of relative security/privacy, -inline preview like auctex and finally (fingers crossed), -compile with server or local TeX installations -offline mode. Those things combined will be very compelling with the added bonus of not having to install anything.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/29186#29186 Jason 2010-06-23T01:43:45Z 2010-06-23T01:43:45Z

<p>For years, I've used CVS to mediate collaborative writing of grant proposals and technical reports with others. I highly recommend this approach to anyone who is interested in collaborative work with faculty and student collaborators, whether they be local or distant.</p> <p>Most of our writing has been in a LaTeX environment, which is a barrier to participation for folks who aren't used to that markup. I anticipate moving to Markdown or HTML to bring in collaborators who aren't LaTeX-savvy, provided I can find ways to author MathML when mathematical notation is necessary.</p> <p>Looking ahead, I want to transition to Git as it will allow local commits for each author in their own copy of the repository. What I haven't figured out is how to manage the 'pushing' and 'merging' of changes made by each collaborator to each of the collaborator's local repository.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/39339#39339 Predrag Punosevac 2010-09-19T21:50:55Z 2010-09-19T21:50:55Z

<p>One more vote for old trusted CVS here. Actually, I use OpenCVS since my OS of choice is OpenBSD. </p> <p>I would like to bring to attention of SVN users the following package</p> <p><a href="http://www.ctan.org/tex-archive/macros/latex/contrib/svn-multi/" rel="nofollow">http://www.ctan.org/tex-archive/macros/latex/contrib/svn-multi/</a></p> <p>which allow you to create (TeX) log messages on the LaTeX document itself. There is another package for using SVN with LaTeX called svn. Disadvantage of svn is that is not playing well with the papers which are broken into multiple files. Here are couple very good articles from the PracTeX journal about SVN, LaTeX and even using it with TextMate</p> <p><a href="http://www.tug.org/pracjourn/2007-3/kalderon-svnmulti/" rel="nofollow">http://www.tug.org/pracjourn/2007-3/kalderon-svnmulti/</a></p> <p><a href="http://www.tug.org/pracjourn/2007-3/skiadas-svn/" rel="nofollow">http://www.tug.org/pracjourn/2007-3/skiadas-svn/</a></p> <p><a href="http://www.tug.org/pracjourn/2007-3/scharrer/" rel="nofollow">http://www.tug.org/pracjourn/2007-3/scharrer/</a></p> <p>Another interesting reading from the same issue of PracTeX Journal</p> <p><a href="http://www.tug.org/pracjourn/2007-3/henningsen/" rel="nofollow">http://www.tug.org/pracjourn/2007-3/henningsen/</a></p> <p>which addresses original question. </p> <p>I am not a big fun of distributed revision control systems like Git. If I would have to pick one distributed system it would be Mercurial.</p> <p>I would like to point another issue. Traditional revision control systems are intended to be used with text files (source codes). Most classical revision control systems like CVS, SVN have troubles dealing with binary files. TeX files are of course text files. However, illustrations in papers unless created with the programming languages like PSTricks, MetaPost, PGF/TikZ, or Asymtote are binary files. So they are not plying well with the revision control systems. That is one more reason for young mathematicians to start programming their illustrations instead of creating them with vector graphics editor like Xfig. My favorite is PSTricks because it is essentially the easiest way to use pure PostScript inside TeX documents. As we all know PostScript is THE page description language. Therefore, I also have strong preference for Powerdot (PSTricks) over Beamer(PGF/TikZ).</p> <p>Unfortunately, there is a disturbing trend at least when it comes to grant proposals of using proprietary binary formats like <strong>doc</strong>. Those formats do not play well with revision control systems which makes collaboration on grant writing very painful. Hopefully, as the "new" <strong>docx</strong> format which is default format of MS Office 2007 becomes more wide spread this problem will slowly disappear (At least for the people that are familiar that <strong>docx</strong> is just bunch of XML files zipped together, only two of the files are actually important, one being XML version of document itself and another being Style Sheet file. People familiar with DocBook (apparently MS people were not one of them since they reinvented the wheel invented 1992) will know what I am talking about).</p> <p>Cheers,</p> <p>Predrag</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/62397#62397 Peter 2011-04-20T11:51:11Z 2011-04-20T11:51:11Z

<p>The <a href="http://www.verbosus.com" rel="nofollow">Online LaTeX Editor</a> is a browser based LaTeX editor solution that supports collaboration. You can easily share projects with other users by simply choosing the project you want to share and enter the username of the collaborator.</p> <p>Maybe an alternative to traditional tools like LED et al.</p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/89632#89632 Leandro 2012-02-27T04:06:57Z 2012-02-27T04:06:57Z

<p>There is a new project called Sharelatex the website is <a href="http://www.sharelatex.com%20/" rel="nofollow">www.sharelatex.com</a> </p> <p>It is a web application where the collaborators can edit the text at the same time. We can get a free account to test the software. </p>

http://mathoverflow.net/questions/3044/tools-for-collaborative-paper-writing/108070#108070 Gejza Jenča 2012-09-25T16:28:31Z 2012-09-25T16:28:31Z

<p><a href="https://gist.github.com/" rel="nofollow">Gist</a> is very useful for initial writeup of ideas. Allows to create a git repository for a small file instantly. Anyone can edit the file and save (commit) a new version. Does not allow branching -- only the newest version is editable. Registration is not necessary, but useful. </p> <p>Feel free to edit <a href="https://gist.github.com/2725927" rel="nofollow">this gist</a>.</p>