LaTex Conversion Guidelines

From OSGeo
Jump to navigation Jump to search

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:

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).

From OSGeo Wiki

There is a tab for logged in users to convert a wiki page into latex. Select the latex/pdf tab and you will have some options to choose from. Many of them are unneeded or do not work, but they help if you choose:

  • Documentclass Article...
  • Remove Template and Parserfunction calls
  • Export Article... In a Textarea

Press Start Export and the next page shows the contents in latex form.

Note that images are not included in this final output, so you will have to save those images and manually add them properly to the output tex.