For manuscripts \LaTeX can be used efficiently to write, store in versions, and track changes when coordinating work between multiple authors.

If you're looking for information on putting \LaTeX in your wiki page, see Docs/WikiQuickReference.

Getting started

For example from the terminal in Ubuntu,

$> sudo apt-get install texlive-full meld kile jabref

Will install EVERYTHING necessary for latex and more. There are a number of languages that you will unlikely use, however this can be easier than installing the individual components. More information can be found here if you are interested. The above line also installs the editor Kile, the diff application Meld and the bibtex management tool JabRef.

Editing

Some of the more popular editors are:

Many editors have auto-complete functions plus buttons to convert to *.pdf, *.ps and .*html and loads of other functions. If you are looking for a latex to HTML converter -- a simple and easy to use choice is tth

Setting up version control

Subversion http://subversion.tigris.org/ Subversion can be used to set up a repository for a manuscript. The important files to add are the *.tex and *.bib files. Under the Ubuntu envrionment after asking you admin to create a repository. Note that the address below is for example purposes only.

$> sudo apt-get install subversion
$> svn co https://projects.dbbe.musc.edu/my_netID/my_repo_name
$> cd my_repo_name

Then after moving you document into the repository.

$> svn add nature_manuscript.tex
$> svn add nature_manuscript.bib
$> svn commit

More on version control

RapidSVN (installed in example above) is useful for the management of subversion repositories. If you are interested in a GUI version then try tortoisesvn. There is another page documenting further SVN. A number of tools are available examine differences between documents. Here are some examples.

Templates

FAQs


In the TeX document, can I make track changes like in a MS word document?

Yes and No. The versions of the document are controlled by SVN so if changes are made they may be visualized using the diff command. However, since a pdf is binary -- version differences cannot be viewed there. If you wish to make colored changes that are visible in the pdf add the following lines to your preamble. This add the following capabilities: comments, deletions, and additions.

\usepackage{color,ulem}
\newcommand{\add}{\textcolor {red}}
\newcommand{\remove}{\sout} 
\newcommand{\comment}{\textcolor{blue}{\textbf{Comment: }}\textcolor{blue} }


Can I convert the TeX to a word document?

You can convert it to a *.rtf document. This is done by first installing the program latex2rtf which can be called from a Shell. If you want a button in Kile then go to Tools -- Configure Kile -- Tools -- Build -- General -- New Tool. Under command put latex2rtf and under options put '%source'. You can then click on Tools -- Configure Toolbars to add the button. Please note that this does not always work perfectly and it may be in your best interest to use the arguments explained in the man page.


What if I want to view the differences between any two versions quickly from the command line?

svn diff --diff-cmd meld --revision 95:99 mydocument.tex

Then to enable word wrapping, syntax highlighting and or line numbers go to preferences and make the appropriate selection(s).

Note that this requires the installation of meld (which can be installed with yum or apt-get)


What if I want to download an old version of a file to just have a look?

svn cat -r 189 mydocument.tex
svn cat -r 189 mydocument.tex > mydocument_189.tex

Where the first line would show the source in the window and the second would redirect it to a new file with specified name


Other Questions?? Email richa[at]musc[dot]edu

Docs/LaTeX (last edited 2010-02-14 20:54:44 by richa)