SEGTeX: Difference between revisions

From Madagascar
Jump to navigation Jump to search
← Older edit
Nick (talk | contribs)
Administrators, widgeteditor
1,050 edits
→‎Documentation: updated links
Fomels (talk | contribs)
15 edits
get rid of svn
 
(64 intermediate revisions by 6 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://seg.org/publications/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://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 using [https://git-scm.com/ Git] and running
<pre>
git clone <nowiki>https://github.com/SEGTeX/texmf</nowiki>
</pre>
 
You can also [https://github.com/SEGTeX/texmf browse the GitHub repository].
 
== 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].


  $ svn co <nowiki>https://segtex.svn.sourceforge.net/svnroot/segtex/trunk</nowiki> texmf


You can also [http://segtex.svn.sourceforge.net/viewcvs.cgi/segtex/trunk/ browse the Subversion repository].
=== Prerequisites ===


== Installation ==
Some of the required additional LaTeX packages are:


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.
* [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 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]
<pre>
<syntaxhighlight lang="latex">
\documentclass{article}
\documentclass{article}
\usepackage{pdfpages}
\usepackage{pdfpages}
Line 35: Line 47:
\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'''.  


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'''.


* Manuscript style '''Geophysics''' paper [http://rsf.sourceforge.net/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://rsf.sourceforge.net/geophysics_endfloat.pdf geophysics_endfloat]
* Manuscript style '''Geophysics''' paper using <tt>endfloat</tt> [http://reproducibility.org/wikilocal/docs/geophysics_endfloat.pdf geophysics_endfloat]
* Publication style two-column '''Geophysics''' paper [http://rsf.sourceforge.net/geophysics_twocolumn.pdf geophysics_twolumn]
* Manuscript style '''Geophysics''' with author information (no double-blind review) [http://reproducibility.org/wikilocal/docs/geophysics_noblind.pdf geophysics_noblind]
* '''SEG''' expanded abstract (with references) [http://rsf.sourceforge.net/segabs_example.pdf segabs_example]
* Publication style two-column '''Geophysics''' paper [http://reproducibility.org/wikilocal/docs/geophysics_twocolumn.pdf geophysics_twolumn]
* '''SEG''' expanded abstract (without references) [http://rsf.sourceforge.net/segabs_final.pdf segabs_final]
* '''SEG''' expanded abstract (with references) [http://reproducibility.org/wikilocal/docs/segabs_example.pdf segabs_example]
* Report style paper [http://rsf.sourceforge.net/geophysics_paper.pdf geophysics_paper]
* '''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 ==


* '''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>.


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 89:
\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 98:
\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 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 96: Line 111:
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 122:


== News ==
== News ==
[[Image:lv08.jpg|frame|right|[http://abstracts.seg.org/ 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/ 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 134:
* 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
* 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
Retrieved from "https://ahay.org/index.php?title=SEGTeX&oldid=4454"