Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
Last revisionBoth sides next revision
paper_writing_workflows [2013/02/04 07:40] – created nrothpaper_writing_workflows [2013/02/04 08:37] – [Erik's Paper Writing Workflow] petigura
Line 2: Line 2:
  
 === Philosophy === === Philosophy ===
-When I write a paper, it begins as a largely creative processes where I'm trying to effectively convey my scientific contribution. By submissio\ +When I write a paper, it begins as a largely creative processes where I'm trying to effectively convey my scientific contribution. By submission time, I feel like a typesetter tracking down TeX errors, fixing broken references, and changing my figures to f1.eps, f2.eps, etc. I find the typesetting aspect distracting and I put it off as long as possible.
-n time, I feel like a typesetter tracking down TeX errors, fixing broken references, and changing my figures to f1.eps, f2.eps, etc. I find the\ +
- typesetting aspect distracting and I put it off as long as possible.+
  
 === Drafting === === Drafting ===
-I like to quickly hammer out a rough draft of a paper in a no-frills text editor. I like EverNote because it's easy to throw figures into the d\ +I like to quickly hammer out a rough draft of a paper in a no-frills text editor. I like EverNote because it's easy to throw figures into the document, and since your note is on the cloud, you can work on your paper from any computer.
-ocument, and since your note is on the cloud, you can work on your paper from any computer.+
  
 === Move into TeX === === Move into TeX ===
-Once the paper is nearly done, I'll move it into a TeX document. I like to use TeXShop for Mac because it updates the PDF view of the paper wit\ +Once the paper is nearly done, I'll move it into a TeX document. I like to use TeXShop for Mac because it updates the PDF view of the paper with every compile. I use pdfTeX since I've found it's easier to throw in different sorts of files (.jpg, .png, .pdf). I also like to have these packages in the preamble.
-h every compile. I use pdfTeX since I've found it's easier to throw in different sorts of files (.jpg, .png, .pdf). I also like to have these p\ +
-ackages in the preamble.+
  
 <code> <code>
Line 27: Line 22:
  
 === Version control === === Version control ===
-I track the TeX source documents (.tex & .bib) and all figures with. The <code>git diff --color-words</code> command shows the specific words (\ +I track the TeX source documents (.tex & .bib) and all figures with. The <code>git diff --color-words</code> command shows the specific words (not just the lines that were changed).
-not just the lines that were changed).+
  
 === References === === References ===
-I use BibDesk to manage my references. It's pretty easy to import the bibTeX citation directly from ADS into BibDesk.+I use BibDesk to manage my references. //Note: this only works on Macs//. It's pretty easy to import the bibTeX citation directly from ADS into BibDesk.
  
 http://bibdesk.sourceforge.net/ http://bibdesk.sourceforge.net/
 +
 +//Nathan adds:// There exists a nice tool to simultaneously import the bibTeX citation and download the associated pdf in one step, called ADS to Bibdesk (http://www.jonathansick.ca/adsbibdesk/). It works on the command line out of the box, but you can easily turn it into a service that you call from a web browser. This package also comes with a script that can update all pre-prints in a bibliography by adding the references to their peer-reviewed versions and downloading those new journal articles, if they have become available on ADS.  
  
 === Collaboration === === Collaboration ===
-This obviously depends on how savvy your collaborators are. I'll email a .zip file of my TeX source to my collaborators and instruct them to ed\ +This obviously depends on how savvy your collaborators are. I'll email a .zip file of my TeX source to my collaborators and instruct them to edit the TeX source directly, reminding them that I've got version control running so I'll see all their changes. I'm keeping an eye on the ShareLaTeX product. It promisses to make working collaboratively on a TeX doc like a working on a Google doc. I'm not quite ready to use it yet, but I think it has promise.
-it the TeX source directly, reminding them that I've got version control running so I'll see all their changes. I'm keeping an eye on the Share\ +
-LaTeX product. It promisses to make working collaboratively on a TeX doc like a working on a Google doc. I'm not quite ready to use it yet, but\ +
- I think it has promise.+
  
 https://www.sharelatex.com/ https://www.sharelatex.com/
- 
 ==== Josiah's Paper Writing Workflow ==== ==== Josiah's Paper Writing Workflow ====
  

Trace: