LaTex Conversion Guidelines

Preliminary LaTex Conversion Guidelines

 * make a folder under the section (case_studies, peer_review, etc) using the name of the first author. Work there.


 * name your TeX file according to the title. Add to SVN and checkin.


 * If this is an article, wrap it in \begin{article} \end{article}


 * Convert all images for the article to PNG files using this command:"convert foo.tif foo.png"


 * Extract images from PDF originals using 'pdfimages' - convert ppm and pbm to png using convert as above.


 * Specify widths for images as fractions of \textwidth so they fit in columns, eg \includegraphics[width=0.5\textwidth]{foo.pdf}


 * Floats (tables and figures) that need to span two columns should be in \begin{table*} or \begin{figure*} environments. Single column floats don't need the star. I've seen tables disappear until I made them the starred version. The multicol package docs mentions this.


 * Save articles provided as DOC or ODT files as ASCII text files and rename with a TEX file extension.


 * Saving text from PDF can result in non-ASCII single-character codes for ligatures - ff, fi etc - replace them!


 * Replace all smart quotes with back-tick and apostrophe


 * Replace & with \&


 * Replace - with -- where needed. Note that DOC and ODT documents often contain – characters which aren’t ASCII - characters. These may be invisible in LaTeX.


 * Add \section and \subsection headings


 * Reformat table text. Add captions and labels. Also reference the table labels in the text.


 * Add \begin{figure} blocks for figures. Add captions and labels for the figures. Also reference the labels in the text.


 * Wrap lists in itemize or enumerate blocks.


 * Set abstract in \begin{abstract} block. But this breaks within the OSGeo journal master TeX file structure.


 * Move “Acknowledgements” section to just before the “References” section.

Per-Article Bibliographies
This uses the chapterbib package.


 * Create a title.bib file in your folder and stick \bibliography{section/author/title} or similar in your title.tex file.


 * input your file from the main using \cbinput{section/author/title}


 * Run pdflatex on the master file with the draft option:

\documentclass[draft,a4paper]{report}

this makes


 * Run bibtex on each .aux file that has bibliographies - this runs bibtex on all subdir .aux files (and not the top-level .aux)

find ./*/ -name '*aux' | while read line ;do bibtex $line; done


 * Now remove the draft option and re-run pdflatex (twice, at least).