[Journal] Questions on LaTex paragraph command, format for citations, and SVN naming convention.

Tyler Mitchell (OSGeo) tmitchell at osgeo.org
Tue Feb 23 12:31:19 EST 2010


Great feedback Barry, thanks.  A bunch of related comments below, and
some SVN stuff at the end.

I'm going to commit this into a 'checklist' file in svn.

Barry Rowlingson wrote:
>  * create top-level master.tex file:
> 
> \documentclass{article}
> \usepackage{graphics}
> \begin{document}
> \input{163-291-1-LE.tex}
> \end{document}

Copy the previous volumes OSGeoJournal_volX.tex file as the master.
Remove all the \input, then insert the new ones.

> * Convert images to PDF with "convert foo.tif foo.pdf"
> 
> * Save .doc from OpenOffice as text - rename as .tex, load into emacs

I've also done some OpenOffice -> LaTeX export which is an option in OO
these days.  But in some cases it's quite a mess unfortunately.

> * Add paragraph breaks and reformat long lines
> 
> * Replace all smart quotes with back-tick and apostrophe
> 
> * Replace & with \&
> 
> * Replace - with -- where needed. Note .docs often contain - chars
> which arent ascii - chars. These can end up invisible in LaTeX.
> 
> * Add \section and \subsection headings

We also use \chapter - but that's in the master doc level.  So
everything else in the child documents can have a section\subsection.

> * Reformat table text. Add captions and labels, reference the labels
> in the text.
> 
> * Add \begin{figure} blocks for figures (I still need some of the
> figure graphics!). Add captions and labels, reference the labels in
> the text.
> 
> * Wrap lists in itemize or enumerate blocks
> 
> * set abstract in \begin{abstract} block

I'd really like to start capturing abstracts at some point in the
future.  We can also enter them into OJS so that people can search on
the terms in the abstract.  But I won't push it for this volume ;)

> * move Acknowledgements section to just before References [is that right?]

Sounds good.

>  * References - always fiddly to do manually and I don't want to
> fiddle lots and then find the citation format is numbers in square
> brackets instead of (author, year) or whatever. BiBTeX does all this
> but we'd need a standard for BiBTeX over the journal and a way for
> individual authors and LaTeX converters to hook in.

Hmm If I remember correctly we had an example in previous volumes.
Yes, see:
http://svn.osgeo.org/osgeo/journal/template/bibtex.bib - is that what
we're after?

>  * title and author boilerplate. I have two authors from different
> places and one is a corresponding author with a full address. How do I
> format all this?

Not sure about the problem here.  We've typically put author contact
info at end of articles, but I assume you're talking about bibliographic
stuff?

>  * I should probably SVN commit this - but where exactly?

The repository is at:
http://svn.osgeo.org/osgeo/journal/volume_6/en-us/ - then in the
subfolder applicable to your category.

Hope that all makes sense!
Tyler



More information about the newsletter mailing list