SEGTeX: Difference between revisions
→Downloading: moved svn |
get rid of svn |
||
(41 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
[[Image: | [[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 [ | * LaTeX2e class files for [https://library.seg.org/journal/gpysa7/ Geophysics] papers, SEG expanded abstracts, etc | ||
* BibTeX style files [ | * BibTeX style files [https://github.com/SEGTeX/texmf/blob/master/bibtex/bst/seg/seg.bst seg.bst] | ||
* BibTeX cumulative bibliography of geophysical publications [ | * 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, | 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> | |||
</pre> | </pre> | ||
You can also [ | |||
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 | 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 | ||
[ | [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 | 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] | ||
<latex> | <syntaxhighlight lang="latex"> | ||
\documentclass{article} | \documentclass{article} | ||
\usepackage{pdfpages} | \usepackage{pdfpages} | ||
Line 34: | Line 47: | ||
\includepdf[pages={1-4}]{segabs_example} | \includepdf[pages={1-4}]{segabs_example} | ||
\end{document} | \end{document} | ||
</ | </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 | * In [http://www.adobe.com/products/acrobatpro/ Acrobat Pro], open the PDF file with references, select <tt>Document -> Pages -> Extract</tt>, and extract the reference page with the delete option (''thanks to Norm Bleistein for the tip''.) | ||
* Another | * Another helpful program is [http://www.accesspdf.com/pdftk/ pdftk] (PDF toolkit.) | ||
== Documentation == | == Documentation == | ||
The [ | 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 56: | 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>. | ||
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}} | ||
</ | </syntaxhighlight> | ||
use | use | ||
<latex> | <syntaxhighlight lang="latex"> | ||
\old{wrong equation \\ | \old{wrong equation \\ | ||
\begin{minipage}{\textwidth} | \begin{minipage}{\textwidth} | ||
Line 75: | Line 89: | ||
\end{equation} | \end{equation} | ||
\end{minipage}} | \end{minipage}} | ||
</ | </syntaxhighlight> | ||
or | or | ||
<latex> | <syntaxhighlight lang="latex"> | ||
\old{wrong equation \\ | \old{wrong equation \\ | ||
\parbox{\textwidth}{ | \parbox{\textwidth}{ | ||
Line 84: | Line 98: | ||
\end{equation} | \end{equation} | ||
}} | }} | ||
</ | </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 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 108: | Line 122: | ||
== News == | == News == | ||
[[Image: | [[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 135: | ||
* 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 |
Latest revision as of 23:34, 24 October 2024
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.
- Manuscript style Geophysics paper geophysics_example geophysics_titlepage geophysics_notitlepage
- Manuscript style Geophysics paper using endfloat geophysics_endfloat
- Manuscript style Geophysics with author information (no double-blind review) geophysics_noblind
- Publication style two-column Geophysics paper geophysics_twolumn
- SEG expanded abstract (with references) segabs_example
- SEG expanded abstract (without references) segabs_final
- Report style paper geophysics_paper
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]
- LaTeX open project
- LaTeX Wikipedia page
- LaTeX books
News[edit]
- 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