SEGTeX: Difference between revisions

From Madagascar
Jump to navigation Jump to search
Sfomel (talk | contribs)
No edit summary
Fomels (talk | contribs)
get rid of svn
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<!-- Begin SF Tag -->
[[Image:SEG-Logo Final SM.png|thumb|[https://seg.org Society of Exploration Geophysicists]]]
<div class="sf-root" data-id="171593" data-badge="oss-community-choice-white" data-metadata="achievement=oss-community-choice" style="width:125px">
    <a href="https://sourceforge.net/projects/segtex/" target="_blank">SEGTeX </a>
</div>
<script>(function () {var sc=document.createElement('script');sc.type='text/javascript';sc.async=true;sc.src='https://b.sf-syn.com/badge_js?sf_id=171593';var p=document.getElementsByTagName('script')[0];p.parentNode.insertBefore(sc, p);})();
</script>
<!-- End SF Tag -->
 
[[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 [https://library.seg.org/journal/gpysa7/ Geophysics] papers, SEG expanded abstracts, etc
* BibTeX style files [https://github.com/SEGTeX/texmf/blob/master/bibtex/bst/seg/seg.bst 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 [https://github.com/SEGTeX/texmf/blob/master/bibtex/bib/seg/SEG.bib SEG.bib]
* BibTeX cumulative bibliography of geophysical publications [https://github.com/SEGTeX/texmf/blob/master/bibtex/bib/seg/SEG.bib SEG.bib]
Line 19: 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, access the current working version by either using [https://git-scm.com/ Git] and running
Alternatively, access the current working version by using [https://git-scm.com/ Git] and running
<pre>
<pre>
git clone <nowiki>https://github.com/SEGTeX/texmf</nowiki>  
git clone <nowiki>https://github.com/SEGTeX/texmf</nowiki>  
</pre>
</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].
You can also [https://github.com/SEGTeX/texmf browse the GitHub repository].


Line 51: 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 62: 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 ==
Line 81: 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>.

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