Difference between revisions of "SEGTeX"

From Madagascar
Jump to: navigation, search
(Documentation: updated links)
(News)
 
(49 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Image:segglobe2.png|frame|right|[http://seg.org Society of Exploration Geophysicists]]]
+
[[Image:SEG-Logo Final SM.png|thumb|[http://seg.org Society of Exploration Geophysicists]]]
  
 
'''SEGTeX''' is a LaTeX package for geophysical publications. It consists of
 
'''SEGTeX''' is a LaTeX package for geophysical publications. It consists of
* LaTeX2e class files for [http://seg.org/publications/geophysics/ Geophysics] papers, SEG expanded abstracts, etc
+
* LaTeX2e class files for [http://segdl.org/geophysics/ Geophysics] papers, SEG expanded abstracts, etc
* BibTeX style files [http://segtex.svn.sourceforge.net/viewcvs.cgi/segtex/trunk/bibtex/bst/seg/seg.bst?view=markup seg.bst]
+
* BibTeX style files [https://github.com/SEGTeX/texmf/blob/master/bibtex/bst/seg/seg.bst seg.bst]
* BibTeX cumulative bibliography of geophysical publications [http://segtex.svn.sourceforge.net/viewcvs.cgi/segtex/trunk/bibtex/bib/seg/SEG.bib?view=markup SEG.bib]
+
* BibTeX cumulative bibliography of geophysical publications [https://github.com/SEGTeX/texmf/blob/master/bibtex/bib/seg/SEG.bib SEG.bib]
 
* [http://www.latex2html.org/ latex2html] customizations
 
* [http://www.latex2html.org/ latex2html] customizations
  
 
== Downloading ==
 
== Downloading ==
  
Access SEGTeX through its [http://sourceforge.net/projects/segtex/ SourceForge project] by downloading [http://sourceforge.net/project/showfiles.php?group_id=171593 the latest stable release].
+
Access SEGTeX through its [http://sourceforge.net/projects/segtex/ SourceForge project] by downloading [http://sourceforge.net/projects/segtex/files/ the latest stable release].
  
Alternatively, use a [http://subversion.tigris.org/ Subversion] client to acess the current working version, as follows:
+
Alternatively, access the current working version by either using [https://git-scm.com/ Git] and running
 +
<pre>
 +
git clone <nowiki>https://github.com/SEGTeX/texmf</nowiki>
 +
</pre>
 +
or using [http://subversion.tigris.org/ Subversion] and running
 +
<pre>
 +
svn co <nowiki>https://github.com/SEGTeX/texmf/trunk</nowiki> texmf
 +
</pre>
 +
You can also [https://github.com/SEGTeX/texmf browse the GitHub repository].
  
  $ svn co <nowiki>https://segtex.svn.sourceforge.net/svnroot/segtex/trunk</nowiki> texmf
+
== Installation ==
 +
If your LaTeX installation is missing/incomplete, try installing [http://www.tug.org/texlive/ TeX Live] first.
  
You can also [http://segtex.svn.sourceforge.net/viewcvs.cgi/segtex/trunk/ browse the Subversion repository].
+
To install, put the contents of the <tt>texmf</tt> folder where LaTeX can find it. Most systems recognize <tt>$HOME/texmf</tt> as one of the default places. On MacOS X, it can be <tt>$HOME/Library/texmf</tt>. You may need to run <tt>texhash</tt> to tell LaTeX about the new files. For more help on <tt>texmf</tt>, see [http://www.tex.ac.uk/cgi-bin/texfaq2html?label=privinst “Private” installations of files].
  
== Installation ==
 
  
To install, put the contents of the <tt>texmf</tt> folder where LaTeX can find it. Most systems recognize <tt>$HOME/texmf</tt> as one of the default places.
+
=== Prerequisites ===
 +
 
 +
Some of the required additional LaTeX packages are:
 +
 
 +
* [http://www.ctan.org/pkg/natbib natbib] support for (author,year) bibliography style of natural sciences
  
If your LaTeX installation is missing/incomplete, try installing [http://www.tug.org/texlive/ TeX Live], install SEGTeX  described in the previous paragraph, then run <tt>texconfig rehash</tt> .
+
== Download and Install SEGTEX on Mac ==
 +
cd $HOME/Library
 +
git clone https://github.com/SEGTEX/texmf
 +
sudo port install texlive-latex-extra
  
 
== SEG expanded abstracts ==
 
== SEG expanded abstracts ==
  
 
'''SEGTeX''' includes '''segabs.cls''' -- a LaTeX class for generating SEG expanded abstracts. Alternatively,  you can  
 
'''SEGTeX''' includes '''segabs.cls''' -- a LaTeX class for generating SEG expanded abstracts. Alternatively,  you can  
[http://sourceforge.net/project/showfiles.php?group_id=171593&package_id=214451 download '''segabs-2007'''] -- a packaged expanded abstract template.
+
[https://sourceforge.net/projects/segtex/files/segabs/segabs-2015.1/ download '''segabs-2015'''] -- a packaged expanded abstract template.
  
To generate an expanded abstract without references, as required by SEG, use two LaTeX files: one for the abstract itself, and the other for separating pages without references. Examples are [http://segtex.svn.sourceforge.net/viewvc/segtex/trunk/tex/latex/seg/segabs_example.ltx?view=markup segabs_example.ltx] and [http://segtex.svn.sourceforge.net/viewvc/segtex/trunk/tex/latex/seg/segabs_final.ltx?view=markup segabs_final.ltx]
+
To generate an expanded abstract without references, as required by SEG, use two LaTeX files: one for the abstract itself, and the other for separating pages without references. Examples are [http://sourceforge.net/p/segtex/code/HEAD/tree/trunk/tex/latex/seg/segabs_example.ltx segabs_example.ltx] and [http://sourceforge.net/p/segtex/code/HEAD/tree/trunk/tex/latex/seg/segabs_final.ltx segabs_final.ltx]
<pre>
+
<syntaxhighlight lang="latex">
 
\documentclass{article}
 
\documentclass{article}
 
\usepackage{pdfpages}
 
\usepackage{pdfpages}
Line 35: Line 50:
 
\includepdf[pages={1-4}]{segabs_example}
 
\includepdf[pages={1-4}]{segabs_example}
 
\end{document}
 
\end{document}
</pre>
+
</syntaxhighlight>
 
This solution only works with '''pdflatex'''.  
 
This solution only works with '''pdflatex'''.  
  
Line 44: Line 59:
 
== Documentation ==
 
== Documentation ==
  
The [http://rsf.svn.sourceforge.net/viewvc/segtex/trunk/tex/latex/seg/ tex/latex/seg] directory contains several example files.
+
The [https://github.com/SEGTeX/texmf/tree/master/tex/latex/seg tex/latex/seg] directory contains several example files.
  
* Manuscript style '''Geophysics''' paper [http://rsf.sourceforge.net/geophysics_example.pdf geophysics_example]  
+
Use the manuscript style to submit papers to '''Geophysics'''.
* Manuscript style '''Geophysics''' paper using <tt>endfloat</tt> [http://rsf.sourceforge.net/geophysics_endfloat.pdf geophysics_endfloat]
+
 
* Publication style two-column '''Geophysics''' paper [http://rsf.sourceforge.net/geophysics_twocolumn.pdf geophysics_twolumn]
+
* Manuscript style '''Geophysics''' paper [http://reproducibility.org/wikilocal/docs/geophysics_example.pdf geophysics_example]  
* '''SEG''' expanded abstract (with references) [http://rsf.sourceforge.net/segabs_example.pdf segabs_example]
+
* Manuscript style '''Geophysics''' paper using <tt>endfloat</tt> [http://reproducibility.org/wikilocal/docs/geophysics_endfloat.pdf geophysics_endfloat]
* '''SEG''' expanded abstract (without references) [http://rsf.sourceforge.net/segabs_final.pdf segabs_final]
+
* Publication style two-column '''Geophysics''' paper [http://reproducibility.org/wikilocal/docs/geophysics_twocolumn.pdf geophysics_twolumn]
* Report style paper [http://rsf.sourceforge.net/geophysics_paper.pdf geophysics_paper]
+
* '''SEG''' expanded abstract (with references) [http://reproducibility.org/wikilocal/docs/segabs_example.pdf segabs_example]
 +
* '''SEG''' expanded abstract (without references) [http://reproducibility.org/wikilocal/docs/segabs_final.pdf segabs_final]
 +
* Report style paper [http://reproducibility.org/wikilocal/docs/geophysics_paper.pdf geophysics_paper]
  
 
== Tips and tricks ==
 
== Tips and tricks ==
Line 60: Line 77:
  
 
Enclose equations in <tt>\parbox</tt> or <tt>minipage</tt>:  Instead of
 
Enclose equations in <tt>\parbox</tt> or <tt>minipage</tt>:  Instead of
<pre>
+
<syntaxhighlight lang="latex">
 
\old{wrong equation
 
\old{wrong equation
 
\begin{equation}
 
\begin{equation}
 
2*2 = 5
 
2*2 = 5
 
\end{equation}}
 
\end{equation}}
</pre>
+
</syntaxhighlight>
 
use
 
use
<pre>
+
<syntaxhighlight lang="latex">
 
\old{wrong equation \\
 
\old{wrong equation \\
 
\begin{minipage}{\textwidth}
 
\begin{minipage}{\textwidth}
Line 74: Line 91:
 
\end{equation}
 
\end{equation}
 
\end{minipage}}
 
\end{minipage}}
</pre>
+
</syntaxhighlight>
 
or
 
or
<pre>
+
<syntaxhighlight lang="latex">
 
\old{wrong equation \\
 
\old{wrong equation \\
 
\parbox{\textwidth}{
 
\parbox{\textwidth}{
Line 83: Line 100:
 
\end{equation}
 
\end{equation}
 
}}
 
}}
</pre>
+
</syntaxhighlight>
 
<tt>\parbox</tt> seems to work better with <tt>\eqnarray</tt>.
 
<tt>\parbox</tt> seems to work better with <tt>\eqnarray</tt>.
  
Line 90: Line 107:
 
== Communication ==
 
== Communication ==
  
The SEGTeX development is discussed at the [http://listserver.seg.org/mailman/listinfo/segtex SEGTeX mailing list] maintained by Joe Dellinger.
+
The SEGTeX development is discussed at the [http://listserver.seg.org/cgi-bin/mailman/listinfo/segtex SEGTeX mailing list] maintained by Joe Dellinger.
  
 
== Reproducible papers ==
 
== Reproducible papers ==
Line 96: Line 113:
 
SEGTeX is used in the [[Main Page|Madagascar]] package to produce [[Reproducible Documents|reproducible research papers]].
 
SEGTeX is used in the [[Main Page|Madagascar]] package to produce [[Reproducible Documents|reproducible research papers]].
  
See a [http://reproducibility.org/wikilocal/docs/vancouver06/fomel_latex.pdf presentation on LaTeX and Web tools] from the [[RSF School and Workshop%2C Vancouver_2006]].
+
See a [http://reproducibility.org/wikilocal/docs/vancouver06/fomel_latex.pdf presentation on LaTeX and Web tools] from the [[RSF School and Workshop%2C Vancouver 2006]].
  
 
== LaTeX references ==
 
== LaTeX references ==
Line 107: Line 124:
  
 
== News ==
 
== News ==
[[Image:lv08.jpg|frame|right|[http://abstracts.seg.org/ SEG Technical Program Online]]]
+
[[Image:SEG-2017.jpg|frame|right|[http://seg.org/Annual-Meeting-2017/Schedule/Sessions SEG Technical Program]]]
  
* 07/04/2006 SEGTeX moved to [http://sourceforge.net/ SourceForge]
+
* 07/04/2006 SEGTeX moved to [http://sourceforge.net/projects/segtex SourceForge]
* 07/07/2006 version 0.8 released
+
* 07/07/2006 version 0.8   released
 
* 10/26/2006 version 0.8.1 released
 
* 10/26/2006 version 0.8.1 released
 
* 10/27/2006 version 0.8.2 released
 
* 10/27/2006 version 0.8.2 released
Line 119: Line 136:
 
* 04/27/2008 version 0.8.7 and segabs-2008.2 released
 
* 04/27/2008 version 0.8.7 and segabs-2008.2 released
 
* 05/16/2008 version 0.8.8 released
 
* 05/16/2008 version 0.8.8 released
 +
* 06/07/2009 version 0.8.9 and segabs-2009.1 released
 +
* 03/09/2011 version 0.9  and segabs-2011.1 released
 +
* 03/23/2013 version 0.9.1 and segabs-2013.1 released
 +
* 03/11/2014 version 0.9.2 and segabs-2014.1 released
 +
* 03/06/2015 version 0.9.3 and segabs-2015.1 released
 +
* 07/28/2015 SEGTeX repository moved to [https://github.com/SEGTeX/texmf GitHub]
 +
* 03/07/2016 version 0.9.5 and segabs-2016.1 released

Latest revision as of 06:13, 18 July 2017

SEGTeX is a LaTeX package for geophysical publications. It consists of

  • LaTeX2e class files for Geophysics papers, SEG expanded abstracts, etc
  • BibTeX style files seg.bst
  • BibTeX cumulative bibliography of geophysical publications SEG.bib
  • latex2html customizations

Downloading

Access SEGTeX through its SourceForge project by downloading the latest stable release.

Alternatively, access the current working version by either using Git and running

git clone https://github.com/SEGTeX/texmf 

or using Subversion and running

svn co https://github.com/SEGTeX/texmf/trunk texmf 

You can also browse the GitHub repository.

Installation

If your LaTeX installation is missing/incomplete, try installing TeX Live first.

To install, put the contents of the texmf folder where LaTeX can find it. Most systems recognize $HOME/texmf as one of the default places. On MacOS X, it can be $HOME/Library/texmf. You may need to run texhash to tell LaTeX about the new files. For more help on texmf, see “Private” installations of files.


Prerequisites

Some of the required additional LaTeX packages are:

  • natbib support for (author,year) bibliography style of natural sciences

Download and Install SEGTEX on Mac

cd $HOME/Library
git clone https://github.com/SEGTEX/texmf 
sudo port install texlive-latex-extra

SEG expanded abstracts

SEGTeX includes segabs.cls -- a LaTeX class for generating SEG expanded abstracts. Alternatively, you can download segabs-2015 -- a packaged expanded abstract template.

To generate an expanded abstract without references, as required by SEG, use two LaTeX files: one for the abstract itself, and the other for separating pages without references. Examples are segabs_example.ltx and segabs_final.ltx

\documentclass{article}
\usepackage{pdfpages}
\begin{document}
\includepdf[pages={1-4}]{segabs_example}
\end{document}

This solution only works with pdflatex.

Alternatively, you can separate pages using an external program.

  • In Acrobat Pro, open the PDF file with referenes, select Document -> Pages -> Extract, and extract the reference page with the delete option (thanks to Norm Bleistein for the tip.)
  • Another useful program is pdftk (PDF toolkit.)

Documentation

The tex/latex/seg directory contains several example files.

Use the manuscript style to submit papers to Geophysics.

Tips and tricks

  • Equations, citation commands, etc don't work inside \old.

Enclose citations in \mbox: Instead of \old{wrong citation \cite{wrong}}, use \old{wrong citation \mbox{\cite{wrong}}}.

Enclose equations in \parbox or minipage: Instead of

\old{wrong equation
\begin{equation}
2*2 = 5
\end{equation}}

use

\old{wrong equation \\
\begin{minipage}{\textwidth}
\begin{equation}
2*2 = 5
\end{equation}
\end{minipage}}

or

\old{wrong equation \\
\parbox{\textwidth}{
\begin{equation}
2*2 = 5
\end{equation}
}}

\parbox seems to work better with \eqnarray.

Thanks to Brad Artman and James Gunning for reporting this problem.

Communication

The SEGTeX development is discussed at the SEGTeX mailing list maintained by Joe Dellinger.

Reproducible papers

SEGTeX is used in the Madagascar package to produce reproducible research papers.

See a presentation on LaTeX and Web tools from the RSF School and Workshop, Vancouver 2006.

LaTeX references

News

  • 07/04/2006 SEGTeX moved to SourceForge
  • 07/07/2006 version 0.8 released
  • 10/26/2006 version 0.8.1 released
  • 10/27/2006 version 0.8.2 released
  • 12/11/2006 version 0.8.3 and segabs-2007.1 released
  • 03/15/2007 version 0.8.4 and segabs-2007.2 released
  • 04/03/2007 version 0.8.5 and segabs-2007.3 released
  • 04/20/2008 version 0.8.6 and segabs-2008.1 released
  • 04/27/2008 version 0.8.7 and segabs-2008.2 released
  • 05/16/2008 version 0.8.8 released
  • 06/07/2009 version 0.8.9 and segabs-2009.1 released
  • 03/09/2011 version 0.9 and segabs-2011.1 released
  • 03/23/2013 version 0.9.1 and segabs-2013.1 released
  • 03/11/2014 version 0.9.2 and segabs-2014.1 released
  • 03/06/2015 version 0.9.3 and segabs-2015.1 released
  • 07/28/2015 SEGTeX repository moved to GitHub
  • 03/07/2016 version 0.9.5 and segabs-2016.1 released