Difference between revisions of "SEGTeX"

From Madagascar
Jump to navigation Jump to search
(→‎Downloading: moved svn)
(37 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Image:SEGlogo.gif|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://segdl.org/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://rsf.svn.sourceforge.net/viewvc/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://rsf.svn.sourceforge.net/viewvc/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
  
Line 11: Line 11:
 
Access SEGTeX through its [http://sourceforge.net/projects/segtex/ SourceForge project] by downloading [http://sourceforge.net/projects/segtex/files/ 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>
 
<pre>
svn co <nowiki>https://svn.code.sf.net/p/segtex/code/trunk</nowiki> texmf
+
git clone <nowiki>https://github.com/SEGTeX/texmf</nowiki>  
 
</pre>
 
</pre>
You can also [http://sourceforge.net/p/segtex/code/ browse the Subversion repository].
+
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].
  
 
== Installation ==
 
== Installation ==
 
If your LaTeX installation is missing/incomplete, try installing [http://www.tug.org/texlive/ TeX Live] first.
 
If your LaTeX installation is missing/incomplete, try installing [http://www.tug.org/texlive/ TeX Live] first.
  
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 is <tt>$HOME/Library/texmf</tt>. You may need to run <tt>texhash</tt> or <tt>texconfig rehash</tt> to tell LaTeX about the new files.
+
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].
 +
 
 +
 
 +
=== 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
 +
 
 +
== 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/projects/segtex/files/segabs/segabs-2011.1/segabs-2011.1.tar.gz/download download '''segabs-2011'''] -- 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]
<latex>
+
<syntaxhighlight lang="latex">
 
\documentclass{article}
 
\documentclass{article}
 
\usepackage{pdfpages}
 
\usepackage{pdfpages}
Line 34: Line 50:
 
\includepdf[pages={1-4}]{segabs_example}
 
\includepdf[pages={1-4}]{segabs_example}
 
\end{document}
 
\end{document}
</latex>
+
</syntaxhighlight>
 
This solution only works with '''pdflatex'''.  
 
This solution only works with '''pdflatex'''.  
  
Line 43: 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.
  
 
Use the manuscript style to submit papers to '''Geophysics'''.
 
Use the manuscript style to submit papers to '''Geophysics'''.
  
* Manuscript style '''Geophysics''' paper [http://reproducibility.org/wikilocal/docs/geophysics_example.pdf geophysics_example]  
+
* Manuscript style '''Geophysics''' paper [http://reproducibility.org/wikilocal/docs/geophysics_example.pdf geophysics_example] [http://reproducibility.org/wikilocal/docs/geophysics_titlepage.pdf geophysics_titlepage] [http://reproducibility.org/wikilocal/docs/geophysics_notitlepage.pdf geophysics_notitlepage]
 
* Manuscript style '''Geophysics''' paper using <tt>endfloat</tt> [http://reproducibility.org/wikilocal/docs/geophysics_endfloat.pdf geophysics_endfloat]
 
* Manuscript style '''Geophysics''' paper using <tt>endfloat</tt> [http://reproducibility.org/wikilocal/docs/geophysics_endfloat.pdf geophysics_endfloat]
 +
* Manuscript style '''Geophysics''' with author information (no double-blind review) [http://reproducibility.org/wikilocal/docs/geophysics_noblind.pdf geophysics_noblind]
 
* Publication style two-column '''Geophysics''' paper [http://reproducibility.org/wikilocal/docs/geophysics_twocolumn.pdf geophysics_twolumn]
 
* Publication style two-column '''Geophysics''' paper [http://reproducibility.org/wikilocal/docs/geophysics_twocolumn.pdf geophysics_twolumn]
 
* '''SEG''' expanded abstract (with references) [http://reproducibility.org/wikilocal/docs/segabs_example.pdf segabs_example]
 
* '''SEG''' expanded abstract (with references) [http://reproducibility.org/wikilocal/docs/segabs_example.pdf segabs_example]
Line 61: Line 78:
  
 
Enclose equations in <tt>\parbox</tt> or <tt>minipage</tt>:  Instead of
 
Enclose equations in <tt>\parbox</tt> or <tt>minipage</tt>:  Instead of
<latex>
+
<syntaxhighlight lang="latex">
 
\old{wrong equation
 
\old{wrong equation
 
\begin{equation}
 
\begin{equation}
 
2*2 = 5
 
2*2 = 5
 
\end{equation}}
 
\end{equation}}
</latex>
+
</syntaxhighlight>
 
use
 
use
<latex>
+
<syntaxhighlight lang="latex">
 
\old{wrong equation \\
 
\old{wrong equation \\
 
\begin{minipage}{\textwidth}
 
\begin{minipage}{\textwidth}
Line 75: Line 92:
 
\end{equation}
 
\end{equation}
 
\end{minipage}}
 
\end{minipage}}
</latex>
+
</syntaxhighlight>
 
or
 
or
<latex>
+
<syntaxhighlight lang="latex">
 
\old{wrong equation \\
 
\old{wrong equation \\
 
\parbox{\textwidth}{
 
\parbox{\textwidth}{
Line 84: Line 101:
 
\end{equation}
 
\end{equation}
 
}}
 
}}
</latex>
+
</syntaxhighlight>
 
<tt>\parbox</tt> seems to work better with <tt>\eqnarray</tt>.
 
<tt>\parbox</tt> seems to work better with <tt>\eqnarray</tt>.
  
Line 91: Line 108:
 
== 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 108: Line 125:
  
 
== News ==
 
== News ==
[[Image:LasVegas.png|frame|right|[http://www.seg.org/web/annual-meeting-2012/technical-program SEG Technical Program Online]]]
+
[[Image:image21.png|frame|right|[https://imageevent.org/2021 SEG/AAPG Image Conference]]]
  
 
* 07/04/2006 SEGTeX moved to [http://sourceforge.net/projects/segtex 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 121: Line 138:
 
* 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
 
* 06/07/2009 version 0.8.9 and segabs-2009.1 released
* 03/09/2011 version 0.9 and segabs-2011.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
 +
* 09/05/2018 version 0.9.6 released
 +
* 08/31/2021 version 0.9.7 and segabs-2021.1 released
 +
* 10/12/2021 version 0.9.8 released

Revision as of 17:07, 1 March 2022

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
  • 09/05/2018 version 0.9.6 released
  • 08/31/2021 version 0.9.7 and segabs-2021.1 released
  • 10/12/2021 version 0.9.8 released