.emacs
, for default use with all org-article
exports, or within the Org-mode file using #+LaTeX_CLASS_OPTIONS:
.
Some of the features include:
- Default packages
- Options to keep individual LaTeX packages from loading make it somewhat easier to modify which LaTeX packages are loaded during the processing of LaTeX code exported by Org-mode.
- Fonts
- The package also implements several choices of fonts and takes steps to ensure that the fonts don’t clash with the symbol font files that Org-mode depends upon to typeset org-entities.
- Listing themes
- The class provides pre-defined themes for formatting source code listings, which can be used as is, or used as a basis for minor modifications.
- Compact lists
- A facility to typeset lists with less vertical space is provided.
- Double spacing
- An option is provided to set lines double spaced.
- Table of contents
- The table of contents depth can be set independently of section numbering depth.
- Section numbering
- Section numbering depth can be specified independently of the table of contents depth.
- Key=value options
- Org-article implements key=value options using pgfkeys and pgfopts.
You might be able to get the Org-mode document from GitHub using the following shell command:
git clone git://github.com/tsdye/org-article.git
This will create a sub-directory, org-article
, initialize the git
repository and download the file article-class.org
as part of the
repository. The Org-mode document can be tangled to produce the
org-article.cls
file. This is done by running org-babel-tangle
against the file, either by M-x org-babel-tangle RET
or C-c C-v
[C-]t
.
The resulting org-article.cls
file should then be moved where LaTeX
can find it. In LaTeX setups that conform to the Tex Directory
Structure, this might be path/to/texmf-local/tex/latex/base. Once
the file has been placed in an appropriate directory it is often the
case that the directory database, such as the one maintained by
Kpathsea, must then be updated. The following shell commands work on
my OS-X system with the MacTeX distribution:
sudo cp org-article.cls /usr/local/texlive/texmf-local/tex/latex/base/
sudo mktexlsr
kpsewhich org-article.cls
There are two ways to setup Org-article and your choice will probably depend on the value of the variable org-export-latex-packages-alist. If this variable is nil (or it refers to packages that you always want loaded), then the following setup should work for you. It asks Org-mode not to load the default packages, because these are loaded by Org-article. Then, it loads the packages in org-export-latex-packages-alist, which should consist of a single entry for the inputenc package. Org-mode automatically sets the input encoding based on the status of the Org-mode buffer being exported, which it can’t do if it is loaded by Org-article. Finally, any packages specified in the Org-mode buffer are loaded (the [EXTRA] argument).
The Org-article setup for the case when org-export-latex-packages-alist is nil:
The number of heading levels in the LaTeX output is determined by two factors: the number of heading levels (section, subsection, etc.) defined in org-export-latex-classes and the setting of the H: option in the export header. The number of heading levels will be the smaller of the two values, e.g., if H: 5 calls for five heading levels, but only sections are defined in org-export-latex-classes then the exported LaTeX file will only contain sections and will lack subsections, subsubsections, etc. Similarly, if headings down to subparagraph are defined in org-export-latex-classes and H: 1, then only sections will appear in the LaTeX export. In a practical sense, the only reason to restrict the number of headings specified in org-export-latex-classes would be to constrain the options available to the author of the document. Thus, Org-article defines headings to the subparagraph level, which is the maximum defined by LaTeX.
(require 'org-latex)
(setq org-export-latex-listings t)
(add-to-list 'org-export-latex-packages-alist
'("AUTO" "inputenc" t))
(add-to-list 'org-export-latex-classes
'("org-article"
"\\documentclass{org-article}
[NO-DEFAULT-PACKAGES]
[PACKAGES]
[EXTRA]"
("\\section{%s}" . "\\section*{%s}")
("\\subsection{%s}" . "\\subsection*{%s}")
("\\subsubsection{%s}" . "\\subsubsection*{%s}")
("\\paragraph{%s}" . "\\paragraph*{%s}")
("\\subparagraph{%s}" . "\\subparagraph*{%s}")))
If, for some reason, org-export-latex-packages-alist is not nil, and it includes packages that you don’t want always loaded then the following setup should work.
(require 'org-latex)
(setq org-export-latex-listings t)
(add-to-list 'org-export-latex-classes
'("org-article"
"\\documentclass{org-article}
[NO-DEFAULT-PACKAGES]
[EXTRA]"
("\\section{%s}" . "\\section*{%s}")
("\\subsection{%s}" . "\\subsection*{%s}")
("\\subsubsection{%s}" . "\\subsubsection*{%s}")
("\\paragraph{%s}" . "\\paragraph*{%s}")
("\\subparagraph{%s}" . "\\subparagraph*{%s}")))
In this case, you will need to specify the inputenc package in the Org-mode file:
#+LATEX_HEADER: \usepackage[AUTO]{inputenc}
The functionality of Org-article can be demonstrated with the following two examples of pdf output generated by Org-mode LaTeX export of this Org-mode file. In the first, these three lines appear near the top of the Org-mode file:
#+OPTIONS: H:5 num:t toc:t \n:nil @:t ::t |:t ^:nil -:t f:t *:t <:t
#+LaTeX_CLASS: org-article
#+LaTeX_CLASS_OPTIONS: [article,letterpaper,times,12pt,listings-bw,microtype]
The resulting pdf file is typeset with the standard LaTeX article on 8.5 x 11 in. paper, using Times, Helvetica, and Courier fonts with a 12 point base size. Source code listings are given in black and white, and microtypographic justification is applied.
In the second example, these three lines appear near the top of the Org-mode file:
#+OPTIONS: H:5 num:t toc:t \n:nil @:t ::t |:t ^:nil -:t f:t *:t <:t
#+LaTeX_CLASS: org-article
#+LaTeX_CLASS_OPTIONS: [koma,a5paper,landscape,twocolumn,utopia,10pt,listings-sv,microtype,paralist]
The resulting pdf file is typeset with the KOMA-script scrartcl on 5.8 x 8.3 in. paper in landscape mode, using Utopia, Bera, and Incosolata fonts with a 10 point base size. Source code listings are given in color, and microtypographic justification is applied. In addition, the paralist option has been set; compare the tightly-set list immediately below with the standard list of the first example.
In the third example, these three lines appear at the top of the Org-mode file:
#+OPTIONS: H:5 num:t toc:t \n:nil @:t ::t |:t ^:nil -:t f:t *:t <:t
#+LaTeX_CLASS: org-article
#+LaTeX_CLASS_OPTIONS: [koma,a5paper,DIV=15,landscape,utopia,10pt,listings-sv,microtype,paralist]
The resulting pdf file is typeset with the KOMA-script scrartcl on 5.8 x 8.3 in. paper in landscape mode, using Utopia, Bera, and Incosolata fonts with a 10 point base size. The size of the text block has been increased by setting DIV to a relatively high number. Source code listings are given in color, and microtypographic justification is applied. In addition, the paralist option has been set.
The fourth example, set out in the listing below, illustrates use of the Org-article section numbering facility. The option secnums has been used to number section heads but leave subsection and lower level heads unnumbered. This results in a clean look. The listings-es theme has been used for the listings, which uses color sparingly and sets code blocks off primarily by numbering and small size of the font.
#+OPTIONS: H:5 num:t toc:t \n:nil @:t ::t |:t ^:nil -:t f:t *:t <:t
#+LaTeX_CLASS: org-article
#+LaTeX_CLASS_OPTIONS: [koma,letterpaper,utopia,11pt,listings-es,microtype,paralist,colorlinks=true,urlcolor=blue,secnums]
The LaTeX class file has six standard parts:
- Identification part
- Defines the nature of the file and specifies the TeX format that it requires.
- Initial code part
- Loads packages used internally by the class file.
- Declaration of options part
- All options known to the class are declared here. It is forbidden to load packages in this part.
- Execution of options part
- Set default values and execute the code for the options that have been declared.
- Package loading part
- Load packages with the options specified in the declaration of options part using PassOptionsToPackage.
- Main code part
- Usually used to define new commands and structures.
This is a standard identification part. The NeedsTeXFormat command can take an optional argument with a release date for the oldest version of LaTeX that can use the class. Since it is relatively easy to update LaTeX installations nowadays there is less reason to use this optional argument than there was in the past. It is omitted here.
% Identification part
\NeedsTeXFormat{LaTeX2e}
\ProvidesClass{org-article}[2010/09/21 0.2 (TSD)]
% End of the identification part
%
The initial code part loads packages needed to process the class file.
% Initial code part
\RequirePackage{ifthen}
\RequirePackage{calc}
\RequirePackage{ifpdf}
\RequirePackage{remreset}
\RequirePackage{pgfopts}
% End of initial code part
The package options are declared here in a code block made up entirely of noweb references. Typically, a package referred to here will also appear in the package loading part. The package loading part also consists of noweb references, an arrangement that makes it possible to keep all the code specific to a particular package together in the LaTeX packages section.
Options defined by the base class, either the standard article or the Koma class scrartcl, are passed on to those classes by default and don’t have to be declared here.
The ProcessOptions command reclaims the memory used to store user options, so those values are now gone unless something was done with them in the declaration of options part.
% Execution of options part
\ProcessPgfOptions{/ORGART}
\ProcessOptions\relax
% End of execution of options part
By default, Org-article loads all but one of the packages in org-export-latex-default-packages-alist. It does not load inputenc directly, but instead relies on the Org-mode LaTeX exporter to load this package, which passes as an option the encoding scheme of the exported buffer. The fontenc package is loaded with the T1 option by default as a prerequisite for the various symbol packages. There is no facility to disable loading fontenc, which is unusual among LaTeX packages in its ability to be loaded more than once. This functionality is required in the case where two or more fonts with different encodings are used.
This code block is implemented as noweb references so that package-specific code can be kept together in LaTeX packages.
This part is also implemented with noweb references. It calls package-specific setup routines that are defined in the LaTeX packages section.
Arbitrary semantic markup in Org-mode files is implemented by
defining a new link type in .emacs
. The following code block
defines a new link type, latex, whose path argument can hold the
name of any LaTeX command. A link such as
[latex:proglang][Org-mode]
will export \proglang{Org-mode}
to the
LaTeX file. In this way, it is possible to make the Org-mode LaTeX
exporter conform to the semantic markup defined in arbitrary style
files. Org-mode will even complete your new link type!
Note that the code below assumes a CSS stylsheet that defines classes with the same names as the corresponding LaTeX macros.
(org-add-link-type
"latex" nil
(lambda (path desc format)
(cond
((eq format 'html)
(format "<span class=\"%s\">%s</span>" path desc))
((eq format 'latex)
(format "\\%s{%s}" path desc)))))
It is often the case that paths are long and difficult to break at the
end of a line. One way to get line breaks right is to wrap a path in
the path command from the url package. This can be done
with a link such as this one (abbreviated for obvious reasons)
[latex:path][/path/ ...]
, which gets typeset so it will break at the
end of the line,
/path/to/a/file/nested/very/deeply/in/the/directory/structure.
Semantic markup for programming language names, package names, and class file names is provided with the proglang, package, and classfile commands. Org-article currently defines all of these in the same way.
\let\proglang=\textsf
\let\package=\textsf
\let\classfile=\textsf
Markup for programming constructs is provided with the progstruct and progexample commands. Both are set in monospaced type; the examples are set at a slightly smaller size.
\let\progstruct=\texttt
\newcommand{\progexample}[1]{{\ttfamily\small #1}}
Org-article offers a choice of two base classes. The first is the standard LaTeX article class. Also available is the KOMA-script scrartcl class. The KOMA-script scrartcl is compatible with the standard LaTeX article class; input that compiles with article should also compile with scrartcl. It differs in the layout of the page and the styling of page elements, producing a somewhat more “modern” design based on principles set out by the typographer and book designer Jan Tschichold.
To select the standard LaTeX article class, put this line in your Org-mode document:
#+LaTeX_CLASS_OPTIONS: [article]
To select the KOMA-script scrartcl class, put this line in your Org-mode document:
#+LaTeX_CLASS_OPTIONS: [koma]
For information on scrartcl, you can probably read the documentation on your system with the following shell command:
texdoc koma
\newboolean{koma}
\DeclareOption{koma}{\setboolean{koma}{true}}
\newboolean{article}
\DeclareOption{article}{\setboolean{article}{true}}
\DeclareOption*{\PassOptionsToClass{\CurrentOption}{scrartcl}}
\DeclareOption*{\PassOptionsToClass{\CurrentOption}{article}}
The article class is loaded by default.
\ifthenelse{\boolean{koma}}
{%
\LoadClass{scrartcl}%
}%
{%
\LoadClass{article}%
}
The following paper size options are available for the standard LaTeX article class and the KOMA-script scrartcl class. The first three options are North American paper sizes. The a4paper, a5paper, b4paper, and b5paper options are international standard ISO 216. The landscape option orients the paper with the long axis horizontal.
#+LaTeX_CLASS_OPTIONS: [letterpaper]
#+LaTeX_CLASS_OPTIONS: [legalpaper]
#+LaTeX_CLASS_OPTIONS: [executivepaper]
#+LaTeX_CLASS_OPTIONS: [a4paper]
#+LaTeX_CLASS_OPTIONS: [a5paper]
#+LaTeX_CLASS_OPTIONS: [b4paper]
#+LaTeX_CLASS_OPTIONS: [b5paper]
#+LaTeX_CLASS_OPTIONS: [landscape]
The KOMA-script scrartcl class has options for a fuller range of the international standard ISO 216 paper sizes, in addition to the sizes offered by the standard LaTeX article class. In the example below, X is replaced by an integer [0, 1, … 10].
#+LaTeX_CLASS_OPTIONS: [aXpaper]
#+LaTeX_CLASS_OPTIONS: [bXpaper]
#+LaTeX_CLASS_OPTIONS: [cXpaper]
#+LaTeX_CLASS_OPTIONS: [dXpaper]
There are three base font size options available for the standard LaTeX article and the KOMA-script scrartcl classes. This option sets the size of the main text in the body of the document. Other fonts used in the document design, such as headers, footers, heads, sub-heads, etc., will be scaled accordingly.
#+LaTeX_CLASS_OPTIONS: [10pt]
#+LaTeX_CLASS_OPTIONS: [11pt]
#+LaTeX_CLASS_OPTIONS: [12pt]
With the koma option, the size of the text block and the resulting margins can be altered using the option DIV. A typical value of DIV is 9. Smaller text blocks with larger margins result when DIV takes a smaller value and larger text blocks with smaller margins result when DIV takes a larger value (fig. \ref{fig:div}).
The koma class can also take into account the part of the page used by the binding. This value is passed to the package with the option BCOR, which takes any LaTeX length as its argument.
For example, to set the text block large and leave ample space for binding with a clip, one might pass the following options to the class when using the koma option.
#+LaTeX_CLASS_OPTIONS: [koma,DIV=15,BCOR=15mm]
In the default configuration, the Org-mode LaTeX exporter includes a
function that sandwiches the LaTeX \tableofcontents
command between
a command that sets the depth of the headings that appear in the table
of contents (based on the number of headline levels that will be
exported as headings, rather than lists) and a command to add some
vertical space. Neither of these additions to the \tableofcontents
command is especially desireable. It is often the case that one wants
the table of contents depth to differ from the depth to which sections
are numbered. In the LaTeX world, the space between the end of one
element and the start of another is something that is specified within
a class file, rather than within the document itself. Formatting with
the class style exclusively can give the finished document a pleasing
stylistic uniformity that is difficult to achieve in an ad hoc way.
Fortunately, the LaTeX exporter is coded in such a way that it is
possible for the user to alter this behavior relatively easily.
Org-article makes it possible to set the depth of headings that
appear in the table of contents independent of the level to which
section headings are numbered. This mechanism will only work if the default behavior of the LaTeX
exporter is changed. The following bit of Emacs
Lisp code can be
placed in .emacs
:
(defun org-export-latex-format-toc-org-article (depth)
(when depth
(format "\\setcounter{secnumdepth}{%s}\n\\tableofcontents\n"
depth)))
(setq org-export-latex-format-toc-function 'org-export-latex-format-toc-org-article)
This code uses the depth to which Org-mode headlines are exported to sections, rather than lists, as the default level to which sections are numbered. This is fine for many applications, but it is possible to control this variable separately, as shown below.
Three choices are available in Org-article: sections, subsections, and subsubsections. It would be possible to create other choices, but it is generally the case that one, two, or three heading levels are sufficient for the table of contents. More levels are rarely seen and are perhaps not too desireable.
#+LaTeX_CLASS_OPTIONS: [tocdepths,tocdepthss,tocdepthsss]
\DeclareOption{tocdepths}{\AtBeginDocument{\setcounter{tocdepth}{1}}}
\DeclareOption{tocdepthss}{\AtBeginDocument{\setcounter{tocdepth}{2}}}
\DeclareOption{tocdepthsss}{\AtBeginDocument{\setcounter{tocdepth}{3}}}
It is possible to set the level to which sections will be numbered with Org-article.
(defun org-export-latex-format-toc-org-article-sec-num (depth)
(when depth
(format "%% Org-mode is exporting headings to %s levels.\n\\tableofcontents\n"
depth)))
(setq org-export-latex-format-toc-function 'org-export-latex-format-toc-org-article-sec-num)
Five choices are available in Org-article: sections, subsections, subsubsections, paragraphs, and subparagraphs.
#+LaTeX_CLASS_OPTIONS: [secnums,secnumss,secnumsss,secnump,secnumsp]
\DeclareOption{secnums}{\AtBeginDocument{\setcounter{secnumdepth}{1}}}
\DeclareOption{secnumss}{\AtBeginDocument{\setcounter{secnumdepth}{2}}}
\DeclareOption{secnumsss}{\AtBeginDocument{\setcounter{secnumdepth}{3}}}
\DeclareOption{secnump}{\AtBeginDocument{\setcounter{secnumdepth}{4}}}
\DeclareOption{secnumsp}{\AtBeginDocument{\setcounter{secnumdepth}{5}}}
The standard LaTeX article class and the KOMA-script scrartcl class both recognize two options that control formatting of equations. The option leqno will number equations on the left, rather than the right, which is the default. The option fleqn displays equations flush left, rather than centered, which is the default
#+LaTeX_CLASS_OPTIONS: [leqno]
#+LaTeX_CLASS_OPTIONS: [fleqn]
The standard LaTeX article formats captions to appear below the captioned item. However, many document styles require table captions above the table. Users of article typically use a package, topcapt, and place the command topcaption above the captioned item. With the Org-mode LaTeX exporter, this requires changes to the exported LaTeX code. The KOMA-script scrartcl class provides an option that gets rid of the need for topcapt:
#+LaTeX_CLASS_OPTIONS: [captions=tableheading]
The input encoding of the document is specified by the inputenc package. Org-mode provides a nifty method for sending options to this package, so it is not loaded directly by Org-article. See Org-mode LaTeX export setup.
The fontenc package specifies the encoding to use with a font. The history of font encodings in LaTeX is a long one; suffice it to say that the most common option is T1, also known as the Cork encoding because it was formulated at a EuroTeX conference in Ireland’s County Cork. The fontenc package pretends that it was never loaded so that it can be called several times with different options to load fonts that have various encodings.
You can probably read the documentation for fontenc on your system with the following shell command:
texdoc fontenc
This is a standard Org-mode package that is loaded by default. An option is provided to not load it.
#+LaTeX_CLASS_OPTIONS: [nofontenc]
Note that several of the font packages load fontenc themselves. These include Garamond, Palatino, Charter, and Utopia.
\newboolean{ORGART@nofontenc}
\DeclareOption{nofontenc}{\setboolean{ORGART@nofontenc}{true}}
\ifthenelse{\boolean{ORGART@nofontenc}}
{}
{\RequirePackage[T1]{fontenc}}
\DeclareOption*{%
\PassOptionsToPackage{\CurrentOption}{fontenc}
}
The fixltx2e package applies fixes to LaTeX2e that would break older documents, so have not been applied to the LaTeX2e kernel. The package doesn’t take any options.
You can probably read about fixltx2e on your system by issuing the following shell command:
texdoc fixltx2e
This is a standard Org-mode package that is loaded by default. An option is provided to not load it.
#+LaTeX_CLASS_OPTIONS: [nofixltx2e]
\newboolean{ORGART@nofixltx2e}
\DeclareOption{nofixltx2e}{\setboolean{ORGART@nofixltx2e}{true}}
\ifthenelse{\boolean{ORGART@nofixltx2e}}
{}
{\RequirePackage{fixltx2e}}
The graphicx package is typically configured with *.def files because the facilities it specifies are provided by a graphics driver, rather than by LaTeX. For this reason, it is typically loaded without options.
You should be able to read about graphicx, along with its companion packages color and graphics by issuing the following shell command:
texdoc graphicx
This is a standard Org-mode package that is loaded by default. An option is provided to not load it.
#+LaTeX_CLASS_OPTIONS: [nographicx]
\newboolean{ORGART@nographicx}
\DeclareOption{nographicx}{\setboolean{ORGART@nographicx}{true}}
\ifthenelse{\boolean{ORGART@nographicx}}
{}
{\RequirePackage{graphicx}}
The longtable package defines a new LaTeX environment that can be
used in place of the tabular
environment and can be broken by the
TeX page-breaking algorithm. It is used, as the name implies, by long
tables that typically won’t fit onto a single page. The package is
loaded without option.
You should be able to read the longtable documentation on your system by issuing the following shell command:
texdoc longtable
This is a standard Org-mode package that is loaded by default. An option is provided to not load it.
#+LaTeX_CLASS_OPTIONS: [nolongtable]
\newboolean{ORGART@nolongtable}
\DeclareOption{nolongtable}{\setboolean{ORGART@nolongtable}{true}}
\ifthenelse{\boolean{ORGART@nolongtable}}
{}
{\RequirePackage{longtable}}
Tables and figures in LaTeX are treated as floating objects. Internally, they are treated as a single (large) glyph, which makes them difficult to place on a page of otherwise small glyphs. Consequently, they are allowed to “float” until a suitable location is found. The float package provides facilities to define new floating environments, to restyle the existing float environments, and additionally defines a placement parameter, {H}, that keeps a float from floating. The package is loaded without options.
You can probably read about the float package on your system by issuing the following shell command:
texdoc float
This is a standard Org-mode package that is loaded by default. An option is provided to not load it.
#+LaTeX_CLASS_OPTIONS: [nofloat]
\newboolean{ORGART@nofloat}
\DeclareOption{nofloat}{\setboolean{ORGART@nofloat}{true}}
\ifthenelse{\boolean{ORGART@nofloat}}
{}
{\RequirePackage{float}}
The wrapfig package defines two new environments to set a narrow float at the edge of the text and wrap the text around it. Because “floats” in these new environments do not float it is sometimes the case that they appear out of order, e.g. Figure n appears before Figure n-1. Caveat emptor.
The package is loaded without options.
The documentation for this package is included at the end of the package source. You should be able to read it on your system by issuing the following shell command:
texdoc wrapfig
This is a standard Org-mode package that is loaded by default. An option is provided to not load it.
#+LaTeX_CLASS_OPTIONS: [nowrapfig]
\newboolean{ORGART@nowrapfig}
\DeclareOption{nowrapfig}{\setboolean{ORGART@nowrapfig}{true}}
\ifthenelse{\boolean{ORGART@nowrapfig}}
{}
{\RequirePackage{wrapfig}}
The soul package is used primarily for underlining text. It is loaded without options.
You can probably read the soul documentation on your system by issuing the following shell command:
texdoc soul
This is a standard Org-mode package that is loaded by default. An option is provided to not load it.
#+LaTeX_CLASS_OPTIONS: [nosoul]
\newboolean{ORGART@nosoul}
\DeclareOption{nosoul}{\setboolean{ORGART@nosoul}{true}}
\ifthenelse{\boolean{ORGART@nosoul}}
{}
{\RequirePackage{soul}}
This package provides support for the Text Companion fonts, which provide symbols used by org-entities, in particular the Euro currency symbol. It is loaded without options.
This is a standard Org-mode package that is loaded by default. An option is provided to not load it.
#+LaTeX_CLASS_OPTIONS: [notextcomp]
\newboolean{ORGART@notextcomp}
\DeclareOption{notextcomp}{\setboolean{ORGART@notextcomp}{true}}
\ifthenelse{\boolean{ORGART@notextcomp}}
{}
{\RequirePackage{textcomp}}
The marvosym package provides support for Martin Vogel’s Symbol font, some glyphs from which are required by org-entities. The package is loaded without options.
You can probably read about the marvosym package by issuing the following command in the shell:
texdoc marvosym
This is a standard Org-mode package that is loaded by default. An option is provided to not load it.
#+LaTeX_CLASS_OPTIONS: [nomarvosym]
\newboolean{ORGART@nomarvosym}
\DeclareOption{nomarvosym}{\setboolean{ORGART@nomarvosym}{true}}
\ifthenelse{\boolean{ORGART@nomarvosym}}
{}
{\RequirePackage{marvosym}}
The wasysym package makes available some symbol glyphs from the wasy fonts. It is needed to support some of the glyphs in org-entities. When it is loaded without options, this package clashes with the American Mathematical Society’s amsmath package. Using the nointegrals option resolves this clash:
#+LaTeX_CLASS_OPTIONS: [integrals, nointegrals]
You can probably read the wasysym documentation on your system by issuing the following shell command:
texdoc wasysym
This is a standard Org-mode package that is loaded by default. An option is provided to not load it.
#+LaTeX_CLASS_OPTIONS: [nowasysym]
\newboolean{ORGART@nowasysym}
\DeclareOption{nowasysym}{\setboolean{ORGART@nowasysym}{true}}
\newboolean{ORGART@integrals}
\DeclareOption{integrals}{\setboolean{ORGART@integrals}{true}}
\newboolean{ORGART@nointegrals}
\DeclareOption{nointegrals}{\setboolean{ORGART@nointegrals}{true}}
\ifthenelse{\boolean{ORGART@nowasysym}}
{}
{%
\ifthenelse{\boolean{ORGART@integrals}}%
{\RequirePackage[integrals]{wasysym}}%
{\RequirePackage[nointegrals]{wasysym}}%
}
The latexsym package provides a few glyphs, one or more of which might be required by org-entities. According to the documentation, latexsym isn’t needed if the amssymb package is loaded.
You can probably read about the latexsym package on your system by issuing the following shell command:
texdoc latexsym
This is a standard Org-mode package that is loaded by default. An option is provided to not load it.
#+LaTeX_CLASS_OPTIONS: [nolatexsym]
\newboolean{ORGART@nolatexsym}
\DeclareOption{nolatexsym}{\setboolean{ORGART@nolatexsym}{true}}
\ifthenelse{\boolean{ORGART@nolatexsym}}
{}
{\RequirePackage{latexsym}}
This package provides all the symbols defined in the American
Mathematical Society’s symbol fonts msam
and msbm
. They are
required to support org-entities. It is superseded by the
mathdesign
package, which is used by various fonts. If one of these
is specified, then the amssymb package is not loaded. If the package is
loaded, the it is loaded without options.
You can probably read the amssymb package documentation by issuing the following shell command:
texdoc amssymb
This is a standard Org-mode package that is loaded by default. An option is provided to not load it.
#+LaTeX_CLASS_OPTIONS: [noamssymb]
\newboolean{ORGART@noamssymb}
\DeclareOption{noamssymb}{\setboolean{ORGART@noamssymb}{true}}
Isn’t loaded if Times, Charter, Utopia, or Garamond are loaded. These use themathdesign package, which apparently supersedes amssymb.
\ifthenelse{\boolean{ORGART@noamssymb}\or\boolean{ORGART@utopia}\or\boolean{ORGART@charter}\or\boolean{ORGART@garamond}\or\boolean{ORGART@times}}
{}
{\RequirePackage{amssymb}}
The hyperref package turns LaTeX cross-referencing commands into
hyperlinks, including the table of contents, bibliography, etc. It is
typically configured on a site-wide basis with options kept in a file,
hyperref.cfg
. The LaTeX document loads the package without
specifying any options. The hyperref package redefines many LaTeX
commands, so it needs to be loaded at, or near the end of, the package
loading part.
The hyperref package accepts numerous options, which can be given as
key = value
pairs. Boolean options default to true
when passed
without a value. Options are passed in the usual way, and
Org-article simply passes them on to hyperref.
#+LaTeX_CLASS_OPTIONS: [anchorcolor, backref, baseurl, bookmarks,
bookmarksnumbered, bookmarksopen, bookmarksopenlevel, bookmarkstype,
breaklinks, CJKbookmarks, citebordercolor, citecolor, colorlinks,
draft, dvipdfm, dvipdfmx, dvips, dvipsone, dviwindo, encap,
extension, filebordercolor, filecolor, final, frenchlinks,
hyperfigures, hyperfootnotes, hyperindex, hypertex, hypertexnames,
implicit, latex2html, legalpaper, letterpaper, linkbordercolor,
linkcolor, linktocpage, menubordercolor, menucolor, nativepdf,
naturalnames, nesting, pageanchor, pagebackref, pdfauthor,
pdfborder, pdfcenterwindow, pdfcreator, pdfdirection,
pdfdisplaydoctitle, pdfduplex, pdffitwindow, pdfhighlight, pdfinfo,
pdfkeywords, pdflang, pdfmark, pdfmenubar, pdfnewwindow,
pdfnonfullscreenpagemode, pdfnumcopies, pdfpagelayout, pdfpagemode,
pdfpagelabels, pdfpagescrop, pdfpagetransition,
pdfpicktraybypdfsize, pdfprintarea, pdfprintclip, pdfprintpagerange,
pdfprintscaling, pdfproducer, pdfstartpage, pdfstartview,
pdfsubject, pdftex, pdftitle, pdftoolbar, pdftrapped, pdfview,
pdfviewarea, pdfviewclip, pdfwindowui, plainpages, ps2pdf,
raiselinks, runbordercolor, runcolor, setpagesize, tex4ht, textures,
unicode, urlbordercolor, urlcolor, verbose, vtex, xetex]
You can probably read the hyperref documentation by issuing the following shell command:
texdoc hyperref
This is a standard Org-mode package that is loaded by default. An option is provided to not load it. If the user chooses not to load hyperref, then the url package is loaded instead to provide support for the path command.
#+LaTeX_CLASS_OPTIONS: [nohyperref]
\newboolean{ORGART@nohyperref}
\DeclareOption{nohyperref}{\setboolean{ORGART@nohyperref}{true}}
\ifthenelse{\boolean{ORGART@nohyperref}}
{\RequirePackage{url}}
{\RequirePackage{hyperref}}
Options do not include debug
.
\DeclareOption{anchorcolor}{%
\PassOptionsToPackage{anchorcolor}{hyperref}}
\DeclareOption{backref}{%
\PassOptionsToPackage{backref}{hyperref}}
\DeclareOption{baseurl}{%
\PassOptionsToPackage{baseurl}{hyperref}}
\DeclareOption{bookmarks}{%
\PassOptionsToPackage{bookmarks}{hyperref}}
\DeclareOption{bookmarksnumbered}{%
\PassOptionsToPackage{bookmarksnumbered}{hyperref}}
\DeclareOption{bookmarksopen}{%
\PassOptionsToPackage{bookmarksopen}{hyperref}}
\DeclareOption{bookmarksopenlevel}{%
\PassOptionsToPackage{bookmarksopenlevel}{hyperref}}
\DeclareOption{bookmarkstype}{%
\PassOptionsToPackage{bookmarkstype}{hyperref}}
\DeclareOption{breaklinks}{%
\PassOptionsToPackage{breaklinks}{hyperref}}
\DeclareOption{CJKbookmarks}{%
\PassOptionsToPackage{CJKbookmarks}{hyperref}}
\DeclareOption{citebordercolor}{%
\PassOptionsToPackage{citebordercolor}{hyperref}}
\DeclareOption{citecolor}{%
\PassOptionsToPackage{citecolor}{hyperref}}
\DeclareOption{colorlinks}{%
\PassOptionsToPackage{colorlinks}{hyperref}}
\DeclareOption{draft}{%
\PassOptionsToPackage{draft}{hyperref}}
\DeclareOption{dvipdfm}{%
\PassOptionsToPackage{dvipdfm}{hyperref}}
\DeclareOption{dvipdfmx}{%
\PassOptionsToPackage{dvipdfmx}{hyperref}}
\DeclareOption{dvips}{%
\PassOptionsToPackage{dvips}{hyperref}}
\DeclareOption{dvipsone}{%
\PassOptionsToPackage{dvipsone}{hyperref}}
\DeclareOption{dviwindo}{%
\PassOptionsToPackage{dviwindo}{hyperref}}
\DeclareOption{encap}{%
\PassOptionsToPackage{encap}{hyperref}}
\DeclareOption{extension}{%
\PassOptionsToPackage{extension}{hyperref}}
\DeclareOption{filebordercolor}{%
\PassOptionsToPackage{filebordercolor}{hyperref}}
\DeclareOption{filecolor}{%
\PassOptionsToPackage{filecolor}{hyperref}}
\DeclareOption{final}{%
\PassOptionsToPackage{final}{hyperref}}
\DeclareOption{frenchlinks}{%
\PassOptionsToPackage{frenchlinks}{hyperref}}
\DeclareOption{hyperfigures}{%
\PassOptionsToPackage{hyperfigures}{hyperref}}
\DeclareOption{hyperfootnotes}{%
\PassOptionsToPackage{hyperfootnotes}{hyperref}}
\DeclareOption{hyperindex}{%
\PassOptionsToPackage{hyperindex}{hyperref}}
\DeclareOption{hypertex}{%
\PassOptionsToPackage{hypertex}{hyperref}}
\DeclareOption{hypertexnames}{%
\PassOptionsToPackage{hypertexnames}{hyperref}}
\DeclareOption{implicit}{%
\PassOptionsToPackage{implicit}{hyperref}}
\DeclareOption{latex2html}{%
\PassOptionsToPackage{latex2html}{hyperref}}
\DeclareOption{legalpaper}{%
\PassOptionsToPackage{legalpaper}{hyperref}}
\DeclareOption{letterpaper}{%
\PassOptionsToPackage{letterpaper}{hyperref}}
\DeclareOption{linkbordercolor}{%
\PassOptionsToPackage{linkbordercolor}{hyperref}}
\DeclareOption{linkcolor}{%
\PassOptionsToPackage{linkcolor}{hyperref}}
\DeclareOption{linktocpage}{%
\PassOptionsToPackage{linktocpage}{hyperref}}
\DeclareOption{menubordercolor}{%
\PassOptionsToPackage{menubordercolor}{hyperref}}
\DeclareOption{menucolor}{%
\PassOptionsToPackage{menucolor}{hyperref}}
\DeclareOption{nativepdf}{%
\PassOptionsToPackage{nativepdf}{hyperref}}
\DeclareOption{naturalnames}{%
\PassOptionsToPackage{naturalnames}{hyperref}}
\DeclareOption{nesting}{%
\PassOptionsToPackage{nesting}{hyperref}}
\DeclareOption{pageanchor}{%
\PassOptionsToPackage{pageanchor}{hyperref}}
\DeclareOption{pagebackref}{%
\PassOptionsToPackage{pagebackref}{hyperref}}
\DeclareOption{pdfauthor}{%
\PassOptionsToPackage{pdfauthor}{hyperref}}
\DeclareOption{pdfborder}{%
\PassOptionsToPackage{pdfborder}{hyperref}}
\DeclareOption{pdfcenterwindow}{%
\PassOptionsToPackage{pdfcenterwindow}{hyperref}}
\DeclareOption{pdfcreator}{%
\PassOptionsToPackage{pdfcreator}{hyperref}}
\DeclareOption{pdfdirection}{%
\PassOptionsToPackage{pdfdirection}{hyperref}}
\DeclareOption{pdfdisplaydoctitle}{%
\PassOptionsToPackage{pdfdisplaydoctitle}{hyperref}}
\DeclareOption{pdfduplex}{%
\PassOptionsToPackage{pdfduplex}{hyperref}}
\DeclareOption{pdffitwindow}{%
\PassOptionsToPackage{pdffitwindow}{hyperref}}
\DeclareOption{pdfhighlight}{%
\PassOptionsToPackage{pdfhighlight}{hyperref}}
\DeclareOption{pdfinfo}{%
\PassOptionsToPackage{pdfinfo}{hyperref}}
\DeclareOption{pdfkeywords}{%
\PassOptionsToPackage{pdfkeywords}{hyperref}}
\DeclareOption{pdflang}{%
\PassOptionsToPackage{pdflang}{hyperref}}
\DeclareOption{pdfmark}{%
\PassOptionsToPackage{pdfmark}{hyperref}}
\DeclareOption{pdfmenubar}{%
\PassOptionsToPackage{pdfmenubar}{hyperref}}
\DeclareOption{pdfnewwindow}{%
\PassOptionsToPackage{pdfnewwindow}{hyperref}}
\DeclareOption{pdfnonfullscreenpagemode}{%
\PassOptionsToPackage{pdfnonfullscreenpagemode}{hyperref}}
\DeclareOption{pdfnumcopies}{%
\PassOptionsToPackage{pdfnumcopies}{hyperref}}
\DeclareOption{pdfpagelayout}{%
\PassOptionsToPackage{pdfpagelayout}{hyperref}}
\DeclareOption{pdfpagemode}{%
\PassOptionsToPackage{pdfpagemode}{hyperref}}
\DeclareOption{pdfpagelabels}{%
\PassOptionsToPackage{pdfpagelabels}{hyperref}}
\DeclareOption{pdfpagescrop}{%
\PassOptionsToPackage{pdfpagescrop}{hyperref}}
\DeclareOption{pdfpagetransition}{%
\PassOptionsToPackage{pdfpagetransition}{hyperref}}
\DeclareOption{pdfpicktraybypdfsize}{%
\PassOptionsToPackage{pdfpicktraybypdfsize}{hyperref}}
\DeclareOption{pdfprintarea}{%
\PassOptionsToPackage{pdfprintarea}{hyperref}}
\DeclareOption{pdfprintclip}{%
\PassOptionsToPackage{pdfprintclip}{hyperref}}
\DeclareOption{pdfprintpagerange}{%
\PassOptionsToPackage{pdfprintpagerange}{hyperref}}
\DeclareOption{pdfprintscaling}{%
\PassOptionsToPackage{pdfprintscaling}{hyperref}}
\DeclareOption{pdfproducer}{%
\PassOptionsToPackage{pdfproducer}{hyperref}}
\DeclareOption{pdfstartpage}{%
\PassOptionsToPackage{pdfstartview}{hyperref}}
\DeclareOption{pdfsubject}{%
\PassOptionsToPackage{pdfsubject}{hyperref}}
\DeclareOption{pdftex}{%
\PassOptionsToPackage{pdftex}{hyperref}}
\DeclareOption{pdftitle}{%
\PassOptionsToPackage{pdftitle}{hyperref}}
\DeclareOption{pdftoolbar}{%
\PassOptionsToPackage{pdftoolbar}{hyperref}}
\DeclareOption{pdftrapped}{%
\PassOptionsToPackage{pdftrapped}{hyperref}}
\DeclareOption{pdfview}{%
\PassOptionsToPackage{pdfview}{hyperref}}
\DeclareOption{pdfviewarea}{%
\PassOptionsToPackage{pdfviewarea}{hyperref}}
\DeclareOption{pdfviewclip}{%
\PassOptionsToPackage{pdfviewclip}{hyperref}}
\DeclareOption{pdfwindowui}{%
\PassOptionsToPackage{pdfwindowui}{hyperref}}
\DeclareOption{plainpages}{%
\PassOptionsToPackage{plainpages}{hyperref}}
\DeclareOption{ps2pdf}{%
\PassOptionsToPackage{ps2pdf}{hyperref}}
\DeclareOption{raiselinks}{%
\PassOptionsToPackage{raiselinks}{hyperref}}
\DeclareOption{runbordercolor}{%
\PassOptionsToPackage{runbordercolor}{hyperref}}
\DeclareOption{runcolor}{%
\PassOptionsToPackage{runcolor}{hyperref}}
\DeclareOption{setpagesize}{%
\PassOptionsToPackage{setpagesize}{hyperref}}
\DeclareOption{tex4ht}{%
\PassOptionsToPackage{tex4ht}{hyperref}}
\DeclareOption{textures}{%
\PassOptionsToPackage{textures}{hyperref}}
\DeclareOption{unicode}{%
\PassOptionsToPackage{unicode}{hyperref}}
\DeclareOption{urlbordercolor}{%
\PassOptionsToPackage{urlbordercolor}{hyperref}}
\DeclareOption{urlcolor}{%
\PassOptionsToPackage{urlcolor}{hyperref}}
\DeclareOption{verbose}{%
\PassOptionsToPackage{verbose}{hyperref}}
\DeclareOption{vtex}{%
\PassOptionsToPackage{vtex}{hyperref}}
\DeclareOption{xetex}{%
\PassOptionsToPackage{xetex}{hyperref}}
LaTeX documents might need three text fonts, one for the serif typeface used for text, the sans-serif typeface often used for heads and sub-heads, and the monospace typewriter typeface typically used to set code examples and the like. Each of the following options specifies all three of the fonts, but takes its name after the serif font used to set text.
The times
option uses URW Nimbus Roman, a Times clone, for the serif
font, URW Nimbus Sans, a Helvetica clone, for the sans-serif font,
and URW Nimbus Mono, a Courier clone, for the typewriter font. This
is a standard set of common typefaces typically used in scientific
publications. All of the fonts should be included in a typical LaTeX
distribution.
Times New Roman was designed by Stanley Morison for The Times of London during a redesign of the newspaper prompted, in part, by Morison’s criticism of its typography in 1929. Helvetica was developed in 1957 by Max Miedinger. Courier was designed by Howard Kettler in 1955 for use in IBM typewriters.
#+LaTeX_CLASS_OPTIONS: [times]
\newboolean{ORGART@times}
\DeclareOption{times}{\setboolean{ORGART@times}{true}}
Helvetica looks better if it is set slightly smaller than the serif font.
\ifthenelse{\boolean{ORGART@times}}
{%
\ifpdf
\RequirePackage[T1]{fontenc}
\RequirePackage{mathptmx}
\RequirePackage[scaled=.90]{helvet}
\RequirePackage{courier}
\fi}%
{}
Garamond refers to a group of old-style serif typefaces and is named after the sixteenth-century type designer, Claude Garamond. It is an elegant typeface. The sans-serif font is Bera, an adaptation of a font originally named Vera. It was designed by Jim Lyles. The typewriter font is Inconsolata, which was created by Raph Levien and is based on Vera.
#+LaTeX_CLASS_OPTIONS: [garamond]
\newboolean{ORGART@garamond}
\DeclareOption{garamond}{\setboolean{ORGART@garamond}{true}}
Garamond requires a bit more leading than normal.
\ifthenelse{\boolean{ORGART@garamond}}
{%
\ifpdf
\RequirePackage[T1]{fontenc}
\RequirePackage[urw-garamond]{mathdesign}
\RequirePackage[scaled]{berasans}
\RequirePackage{inconsolata} % tt
\linespread{1.0609}
\fi}%
{}
The beautiful, old-style serif font, Palatino, was designed by Herman Zapf. It is somewhat heavier and easier to read than Garamond. It is paired here with Helvetica and Courier, as is Times, for which it is an alternative.
#+LaTeX_CLASS_OPTIONS: [palatino]
\newboolean{ORGART@palatino}
\DeclareOption{palatino}{\setboolean{ORGART@palatino}{true}}
Palatino gets a bit more leading than normal.
\ifthenelse{\boolean{ORGART@palatino}}
{%
\ifpdf
\RequirePackage[T1]{fontenc}
\RequirePackage{mathpazo}%
\linespread{1.05}%
\RequirePackage[scaled]{helvet}%
\RequirePackage{courier} % tt
\fi}%
{}
Utopia is a transitional serif font designed by Robert Slimbach for Adobe in 1989. It became free software in 2006. It is paired here with Bera and Inconsolata, as is Garamond.
Note that the utopia font clashes with the amssymb package.
#+LaTeX_CLASS_OPTIONS: [utopia]
\newboolean{ORGART@utopia}
\DeclareOption{utopia}{\setboolean{ORGART@utopia}{true}}
\ifthenelse{\boolean{ORGART@utopia}}
{%
\ifpdf
\RequirePackage[T1]{fontenc}
\RequirePackage[adobe-utopia]{mathdesign}
\RequirePackage[scaled]{berasans}
\RequirePackage{inconsolata} % tt
\fi}%
{}
Charter was designed to reproduce well on low-resolution 300 dpi printers. It is paired here with Helvetica and Courier, like Times, for which it is an alternative.
These fonts conflict with the amssymb package.
#+LaTeX_CLASS_OPTIONS: [charter]
\newboolean{ORGART@charter}
\DeclareOption{charter}{\setboolean{ORGART@charter}{true}}
Helvetica is set a bit smaller to better match the Charter font.
\ifthenelse{\boolean{ORGART@charter}}
{%
\ifpdf
\RequirePackage[T1]{fontenc}
\RequirePackage[bitstream-charter]{mathdesign}
\RequirePackage[scaled=.90]{helvet}
\RequirePackage{courier} % tt
\fi}%
{}
Packages not included in the Org-mode list of default packages are made available in Org-article. These include facilities to apply microtypographic adjustments to suitable fonts, set the line spacing of the document to double space, set lists more compactly than the standard LaTeX article, and typeset source code listings using one of several color or black and white themes.
The microtype package makes available the micro-typographic extensions of pdfTeX. Prominent among these are font expansion and character protrusion, which together result in fewer bad line breaks and a visually even right margin.
You can probably read the microtype documentation, which runs to more than 200 pages, on your system by issuing the shell command:
texdoc microtype
This package is not loaded by default. An option is provided to load it.
#+LaTeX_CLASS_OPTIONS: [microtype]
\newboolean{ORGART@microtype}
\DeclareOption{microtype}{\setboolean{ORGART@microtype}{true}}
\ifthenelse{\boolean{ORGART@microtype}}
{%
\ifpdf
\RequirePackage{microtype}
\fi}%
{}
The setspace package is used here for the sole purpose of creating double-spaced documents, such as manuscripts submitted to some publishing houses. If it is loaded, then the option doublespace will produce a double-spaced document.
This package is not loaded by default. An option is provided to load it, and to set linespacing to doublespace.
#+LaTeX_CLASS_OPTIONS: [setspace,doublespace]
\newboolean{ORGART@setspace}
\newboolean{ORGART@doublespace}
\DeclareOption{setspace}{\setboolean{ORGART@setspace}{true}}
\DeclareOption{doublespace}{\setboolean{ORGART@doublespace}{true}}
\ifthenelse{\boolean{ORGART@setspace}}
{\RequirePackage{setspace}}
{}
\ifthenelse{\boolean{ORGART@setspace}}%
{\ifthenelse{\boolean{ORGART@doublespace}}%
{\doublespacing}%
{\singlespacing}}%
{}%
The paralist package was designed to meet the widespread request for
more tightly set lists in the standard LaTeX classes. If it is
loaded, then the LaTeX environments itemize
, enumerate
, and
description
are over-ridden by their paralist counterparts.
You can probably read the paralist documentation on your system by issuing the shell command:
texdoc paralist
This package is not loaded by default. An option is provided to load it.
#+LaTeX_CLASS_OPTIONS: [paralist]
\newboolean{ORGART@paralist}
\DeclareOption{paralist}{\setboolean{ORGART@paralist}{true}}
% Set the standard LaTeX list environments to their compact counterparts
\ifthenelse{\boolean{ORGART@paralist}}
{%
\RequirePackage{paralist}
\let\itemize\compactitem%
\let\description\compactdesc%
\let\enumerate\compactenum%
}
{}
The listings package is a source code printer for LaTeX. Except for
the two options draft
and final
, which the listings package is
configured to pick up itself from options passed to documentclass,
the other options were introduced to ease debugging or to trigger
compatibility with earlier versions of the package. It seems unwise
to use this mechanism to set options for the listings package
because there is no reason to assume that it will be stable. One
solution would be to process options for this package using a key =
value
interface that sets the values of keys recognized by the
package’s lstset function. This is relatively difficult to do. An
easier approach groups package options into themes, which can be
selected with simple options, rather than key = value
pairs. It is
the approach adopted here.
This package is not loaded by default. Options are provided to load it in its default state, set up for black and white reproduction, and with two themes for color reproduction.
#+LaTeX_CLASS_OPTIONS: [listings, listings-bw, listings-color, listings-sv]
Themes are defined for the listings package. The
listings-color
theme was lifted from a post to the Org-mode list by
Eric Schulte. The listings-sv
theme was posted to the list by
Sebastian Vauban; it has been modified here to work with the color
package, rather than the xcolor package used by Sebastian, and to
allow breaking of long lines.
Caveat emptor: the line-breaking mechanism in the listings package appears to
break when resetmargins = false. This means that the listing will
always be set to \textwidth
, rather than \linewidth
. Thus, care
should be taken to ensure that listings do not occur in lists.
Probably the best way to ensure that this doesn’t happen is to make
sure the H:
option in the export header is set to a suitably high
level, so source code blocks always occur at an Org-mode headline
level that exports as a heading, rather than a list, e.g. if source
code appears in a three-asterisk headline and now lower, then setting
H: 3
should ensure that listing margins are always aligned with text
margins.
\newboolean{listings}
\newboolean{color}
\DeclareOption{listings}{\setboolean{listings}{true}}
\DeclareOption{listings-bw}{%
\setboolean{listings}{true}%
\AtBeginDocument{%
\lstset{
basicstyle=\ttfamily\footnotesize,%
frame=lines,%
breaklines=true,%
showstringspaces=false}%
}%
}
\DeclareOption{listings-color}{%
\setboolean{listings}{true}%
\setboolean{color}{true}%
\AtBeginDocument{%
\definecolor{keywords}{RGB}{255,0,90}%
\definecolor{comments}{RGB}{60,179,113}%
\definecolor{back}{RGB}{231,231,231}%
\lstset{%
keywordstyle=\color{keywords},%
commentstyle=\color{comments},%
backgroundcolor=\color{back},%
basicstyle=\ttfamily\footnotesize,%
showstringspaces=false,%
frame=lines,%
breaklines=true,%
resetmargins=true%
}%
}%
}
\DeclareOption{listings-sv}{%
\setboolean{listings}{true}%
\setboolean{color}{true}%
\AtBeginDocument{%
\definecolor{...@lstbackground}{RGB}{255,255,204} % light yellow
\definecolor{...@lstkeyword}{RGB}{0,0,255} % blue
\definecolor{...@lstidentifier}{RGB}{0,0,0} % black
\definecolor{...@lstcomment}{RGB}{255,0,0} % red
\definecolor{...@lststring}{RGB}{0,128,0} % dark green
\lstset{%
basicstyle=\ttfamily\scriptsize, % the font that is used for the code
tabsize=4, % sets default tabsize to 4 spaces
numbers=left, % where to put the line numbers
numberstyle=\tiny, % line number font size
stepnumber=0, % step between two line numbers
breaklines=true, %!! do break long lines of code
showtabs=false, % show tabs within strings adding particular underscores
showspaces=false, % show spaces adding particular underscores
showstringspaces=false, % underline spaces within strings
keywordstyle=\color{...@lstkeyword},
identifierstyle=\color{...@lstidentifier},
stringstyle=\color{...@lststring},
commentstyle=\color{...@lstcomment},
backgroundcolor=\color{...@lstbackground}, % sets the background color
resetmargins=true,%
captionpos=b, % sets the caption position to `bottom'
extendedchars=false %!?? workaround for when the listed file is in UTF-8
}%
}%
}
\DeclareOption{listings-es}{%
\setboolean{listings}{true}%
\setboolean{color}{true}%
\AtBeginDocument{%
\definecolor{dkgreen}{rgb}{0,0.5,0}%
\definecolor{dkred}{rgb}{0.5,0,0}%
\definecolor{gray}{rgb}{0.5,0.5,0.5}%
\lstset{%
basicstyle=\ttfamily\bfseries\scriptsize,
keywordstyle=\color{blue},
ndkeywordstyle=\color{red},
commentstyle=\color{dkred},
stringstyle=\color{dkgreen},
numbers=left,
breaklines=true,
numberstyle=\ttfamily\footnotesize\color{gray},
stepnumber=1,
numbersep=10pt,
backgroundcolor=\color{white},
tabsize=4,
showspaces=false,
showstringspaces=false,
xleftmargin=.23in
}%
}%
}
\ifthenelse{\boolean{listings}}
{\RequirePackage{listings}}
{}
\ifthenelse{\boolean{listings}}%
{\lstdefinelanguage{org}%
{%
morekeywords={:results, :session, :var, :noweb, :exports},%
sensitive=false,%
morestring=[b]",%
morecomment=[l]{\#},%
}%
\lstdefinelanguage{dot}
{%
morekeywords={graph},
sensitive=false,
}%
\lstdefinelanguage{ditaa}
{%
breaklines=false
}%
}%
{}%