Difference between revisions of "LaTex Conversion Guidelines"

From OSGeo
Jump to navigation Jump to search
(New page: ==Preliminary LaTex Conversion Guidelines== * Convert all images for the article to PDF files using this command:"convert foo.tif foo.pdf" * Save articles provided as DOC or ODT files as...)
 
Line 2: Line 2:
  
 
* Convert all images for the article to PDF files using this command:"convert foo.tif foo.pdf"
 
* Convert all images for the article to PDF files using this command:"convert foo.tif foo.pdf"
 +
 +
* 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.
 
* 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 all smart quotes with back-tick and apostrophe
Line 20: Line 26:
 
* Wrap lists in itemize or enumerate blocks.
 
* Wrap lists in itemize or enumerate blocks.
  
* Set abstract in \begin{abstract} block.
+
* 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.
 
* Move “Acknowledgements” section to just before the “References” section.

Revision as of 05:08, 24 February 2010

Preliminary LaTex Conversion Guidelines

  • Convert all images for the article to PDF files using this command:"convert foo.tif foo.pdf"
  • 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.