SEGTeX: Difference between revisions

From Madagascar
Jump to navigation Jump to search
Sfomel (talk | contribs)
Fomels (talk | contribs)
get rid of svn
 
(24 intermediate revisions by 5 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|[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


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 using [https://git-scm.com/ Git] and running
<pre>
<pre>
svn co <nowiki>http://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].
 
You can also [https://github.com/SEGTeX/texmf browse the GitHub repository].


== Installation ==
== Installation ==
Line 21: Line 22:


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].
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 ===
=== Prerequisites ===
Line 27: Line 29:


* [http://www.ctan.org/pkg/natbib natbib] support for (author,year) bibliography style of natural sciences
* [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 ==
Line 33: Line 40:
[https://sourceforge.net/projects/segtex/files/segabs/segabs-2015.1/ download '''segabs-2015'''] -- 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://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]
To generate an expanded abstract without references, as SEG requires, 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]
<syntaxhighlight lang="latex">
<syntaxhighlight lang="latex">
\documentclass{article}
\documentclass{article}
Line 44: Line 51:


Alternatively, you can separate pages using an external program.  
Alternatively, you can separate pages using an external program.  
* In [http://www.adobe.com/products/acrobatpro/ Acrobat Pro], open the PDF file with referenes, select <tt>Document -&gt; Pages -&gt; Extract</tt>, and extract the reference page with the delete option (''thanks to Norm Bleistein for the tip''.)
* In [http://www.adobe.com/products/acrobatpro/ Acrobat Pro], open the PDF file with references, select <tt>Document -&gt; Pages -&gt; Extract</tt>, and extract the reference page with the delete option (''thanks to Norm Bleistein for the tip''.)
* Another useful program is [http://www.accesspdf.com/pdftk/ pdftk] (PDF toolkit.)
* Another helpful program is [http://www.accesspdf.com/pdftk/ pdftk] (PDF toolkit.)


== 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 62: Line 70:
== Tips and tricks ==
== Tips and tricks ==


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


Enclose citations in <tt>\mbox</tt>: Instead of <tt>\old{wrong citation \cite{wrong}}</tt>, use  <tt>\old{wrong citation \mbox{\cite{wrong}}}</tt>.
Enclose citations in <tt>\mbox</tt>: Instead of <tt>\old{wrong citation \cite{wrong}}</tt>, use  <tt>\old{wrong citation \mbox{\cite{wrong}}}</tt>.
Line 97: Line 105:
== 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 114: Line 122:


== News ==
== News ==
[[Image:seg2015.png|frame|right|[http://www.seg.org/web/seg-new-orleans-2015/technical-program SEG Technical Program]]]
[[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]
Line 131: Line 139:
* 03/11/2014 version 0.9.2 and segabs-2014.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
* 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 23:34, 24 October 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 using Git and running

git clone https://github.com/SEGTeX/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 SEG requires, 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 references, select Document -> Pages -> Extract, and extract the reference page with the delete option (thanks to Norm Bleistein for the tip.)
  • Another helpful 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