Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
erik_petigura_s_paper_writing_workflow [2013/02/02 19:20]
petigura [Josiah's Paper Writing Workflow]
erik_petigura_s_paper_writing_workflow [2013/02/04 07:38]
nroth [Erik's Paper Writing Workflow]
Line 1: Line 1:
 =====Paper writing workflow===== =====Paper writing workflow=====
  
-==== Erik's Paper Writing Workflow ==== 
  
-=== Philosophy === 
-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. 
- 
-=== 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 document, and since your note is on the cloud, you can work on your paper from any computer. 
- 
-=== 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 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. 
- 
-<​code>​ 
-\usepackage{\ensuremath} ​  % user-defined commands will be typeset in math-mode in text- and math-mode. 
-\usepackage{\xspace} ​      % intelligently puts spaces after mathmode. 
-\usepackage[T1]{fontenc} ​  % greater-than and less-than symbols don't turn into upside-down question marks 
- 
-% For example: 
-\newcommand{\Rsun}{\ensuremath{R_{\odot}}\xspace} ​           ​ 
-%\Rsun Gives the right symbol in text and math-mode. ​               
- 
-</​code>​ 
- 
-=== 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 (not just the lines that were changed). 
- 
-=== References === 
-I use BibDesk to manage my references. It's pretty easy to import the bibTeX citation directly from ADS into BibDesk. 
- 
-http://​bibdesk.sourceforge.net/​ 
- 
-=== 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 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. 
- 
-https://​www.sharelatex.com/​ 
- 
-==== Josiah'​s Paper Writing Workflow ==== 
- 
-=== Preamble === 
- 
-Workflows are personal. ​ The two factors that most strongly shape my 
-own workflow is that my editor of choice is emacs and that I do not 
-work in large collaborations. ​ (It doesn'​t hurt that I like to 
-tinker.) ​ 
-The emacs learning curve can be quite steep, but because I do so many 
-different things in it, small increases in proficieny have a magnified 
-impact. ​ Also, I tend to be easily distracted, so the fewer times I 
-switch between apps, the better. 
-Instead of desribing things in gory detail, I just tried to give a 
-general overview. ​ If you have specific questions, or want to see 
-something in action, swing by my cube, D-343. ​ I'm usually happy to 
-talk about such things. 
- 
-=== Write an Outline === 
- 
-The first thing I do is write an outline using [org-mode]. ​ This is a a 
-plain text draft of the paper, though I do write the equations using 
-TeX.  Once things are reasonably converged, I export my org-mode file 
-to TeX, using built-in exporter. ​ This converts my outline headings 
-into LaTeX sections, among other nifty things. 
- 
-[org-mode]: http://​orgmode.org/​ 
- 
- 
-=== Use Version Control === 
- 
-I start a git repository with the rough draft TeX file from the 
-previous step.  When I send a draft to a co-author, I make a branch 
-for him/her, incoportate the comments when I get them back, and then 
-merge this back into my master branch.  ​ 
- 
-=== TeX Editing in emacs === 
- 
-I use [AUCTeX] which the default emacs TeX editing mode.  It has all 
-sorts of goodies: easy math-mode editing, cross reference support, 
-commands for creating environments,​ etc. 
- 
-[AUCTeX]: http://​www.gnu.org/​software/​auctex/​ 
- 
- 
-=== BibTeX === 
- 
-I do not have a solution I'm completely happy with here.  I tend to 
-make an ADS private library for each paper and then export to BibTeX 
-occasionally. ​ I've played with both BibDesk and Papers and not been 
-all that happy with either (though I do like Papers for 
-reading/​emailing).