SEGTeX: Difference between revisions

From Madagascar
Jump to navigation Jump to search
Sfomel (talk | contribs)
Jmavzer (talk | contribs)
No edit summary
 
(47 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|[https://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 [https://library.seg.org/journal/gpysa7/ 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


== 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.
 
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].


You can also [http://rsf.svn.sourceforge.net/viewvc/segtex/trunk/ browse the Subversion repository].


== Installation ==
=== Prerequisites ===
If your LaTeX installation is missing/incomplete, try installing [http://www.tug.org/texlive/ TeX Live] first.
 
Some of the required additional LaTeX packages are:
 
* [http://www.ctan.org/pkg/natbib natbib] support for (author,year) bibliography style of natural sciences


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.
== 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-2008'''] -- 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:Denver2010.jpg|frame|right|[http://abstracts.seg.org/den10 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/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

Latest revision as of 14:09, 21 March 2024

Society of Exploration Geophysicists

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[edit]

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[edit]

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[edit]

Some of the required additional LaTeX packages are:

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

Download and Install SEGTEX on Mac[edit]

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

SEG expanded abstracts[edit]

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[edit]

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

Use the manuscript style to submit papers to Geophysics.

Tips and tricks[edit]

  • 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[edit]

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

Reproducible papers[edit]

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[edit]

News[edit]

SEG/AAPG Image Conference
  • 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