Text.LaTeX.Base.Commands

This module is the Prelude of LaTeX functions. It includes commands, environments, and some other useful abstractions, that don't require you to import additional LaTeX packages.

Basic functions

raw :: LaTeXC l => Text -> l

Insert a raw piece of Text. This functions doesn't escape LaTeX reserved characters, it insert the text just as it is received.

Warning: This function is unsafe, in the sense that it does not check that the input text is a valid LaTeX block. Make sure any braces, commands or environments are properly closed.

between :: Monoid m => m -> m -> m -> m

Calling between c l1 l2 puts c between l1 and l2 and appends them.

between c l1 l2 = l1 <> c <> l2

comment :: LaTeXC l => Text -> l

Create a comment.

(%:) :: LaTeXC l => l -> Text -> l

This operator appends a comment after a expression. For example:

textbf "I'm just an example." %: "Insert a few words here."

The implementation is

(%:) l = (l <>) . comment

Since you are writing in Haskell, you may not need to output comments as you can add them in the Haskell source. I added this feature for completeness. It may be useful for debugging the output as well.

Preamble commands

title :: LaTeXC l => l -> l

Set the title of your document.

author :: LaTeXC l => l -> l

Set the author(s) of the document.

date :: LaTeXC l => l -> l

Set a date for your document.

institute :: LaTeXC l => Maybe l -> l -> l

Set either an institute or an organization for the document. It does not work for a document of the article class.

thanks :: LaTeXC l => l -> l

documentclass

Arguments

:: LaTeXC l

=> [ClassOption]

Class options

-> ClassName

Class name

-> l

Set the document class. Needed in all documents.

usepackage :: LaTeXC l => [l] -> PackageName -> l

Import a package. First argument is a list of options for the package named in the second argument.

linespread :: LaTeXC l => Float -> l

Classes

Document classes

article :: ClassName

proc :: ClassName

report :: ClassName

minimal :: ClassName

book :: ClassName

slides :: ClassName

Class options

data ClassOption

A class option to be passed to the documentclass function.

Constructors

Draft

TitlePage

NoTitlePage

OneColumn

TwoColumn

OneSide

TwoSide

Landscape

OpenRight

OpenAny

Fleqn

Leqno

FontSize Measure

Paper PaperType

CustomOption String

Instances

Render ClassOption

Defined in Text.LaTeX.Base.Commands

Methods

render :: ClassOption -> Text

renderBuilder :: ClassOption -> Builder

IsString ClassOption

Defined in Text.LaTeX.Base.Commands

Methods

fromString :: String -> ClassOption

Show ClassOption

Defined in Text.LaTeX.Base.Commands

Methods

showsPrec :: Int -> ClassOption -> ShowS

show :: ClassOption -> String

showList :: [ClassOption] -> ShowS

customopt :: String -> ClassOption

draft :: ClassOption

titlepage :: ClassOption

notitlepage :: ClassOption

onecolumn :: ClassOption

twocolumn :: ClassOption

oneside :: ClassOption

twoside :: ClassOption

landscape :: ClassOption

Changes the layout of the document to print in landscape mode

openright :: ClassOption

Makes chapters begin either only on right hand pages

openany :: ClassOption

Makes chapters begin on the next page available.

fleqn :: ClassOption

Typesets displayed formulae left-aligned instead of centred.

leqno :: ClassOption

Places the numbering of formulae on the left hand side instead of the right.

Paper sizes

data PaperType

LaTeX available paper types.

Constructors

A0

A1

A2

A3

A4

A5

A6

B0

B1

B2

B3

B4

B5

B6

Letter

Executive

Legal

Instances

Render PaperType

Defined in Text.LaTeX.Base.Commands

Methods

render :: PaperType -> Text

renderBuilder :: PaperType -> Builder

Show PaperType

Defined in Text.LaTeX.Base.Commands

Methods

showsPrec :: Int -> PaperType -> ShowS

show :: PaperType -> String

showList :: [PaperType] -> ShowS

a0paper :: ClassOption

a1paper :: ClassOption

a2paper :: ClassOption

a3paper :: ClassOption

a4paper :: ClassOption

a5paper :: ClassOption

a6paper :: ClassOption

b0paper :: ClassOption

b1paper :: ClassOption

b2paper :: ClassOption

b3paper :: ClassOption

b4paper :: ClassOption

b5paper :: ClassOption

b6paper :: ClassOption

letterpaper :: ClassOption

executivepaper :: ClassOption

legalpaper :: ClassOption

Page styles

pagestyle :: LaTeXC l => PageStyle -> l

thispagestyle :: LaTeXC l => PageStyle -> l

plain :: PageStyle

headings :: PageStyle

empty :: PageStyle

myheadings :: PageStyle

markboth :: LaTeXC l => l -> l -> l

Used in conjunction with myheadings for setting both the left and the right heading.

markright :: LaTeXC l => l -> l

Used in conjunction with myheadings for setting the right heading.

Body commands

document :: LaTeXC l => l -> l

The document environment contains the body of the document.

maketitle :: LaTeXC l => l

Append a blank comment. eol :: LaTeXC l => l eol = comment ""

Generate the title. It normally contains the title name of your document, the author(s) and date.

Document structure

tableofcontents :: LaTeXC l => l

Create the table of contents, automatically generated from your sections, subsections, and related functions.

abstract :: LaTeXC l => l -> l

Abstract section.

appendix :: LaTeXC l => l

Sections

part :: LaTeXC l => l -> l

chapter :: LaTeXC l => l -> l

Start a new chapter with the given title.

section :: LaTeXC l => l -> l

Start a new section with a given title.

section' :: LaTeXC l => l -> l

Start a new unnumbered section with a given title.

subsection :: LaTeXC l => l -> l

Start a new subsection.

subsection' :: LaTeXC l => l -> l

Start a new unnumbered subsection.

subsubsection :: LaTeXC l => l -> l

Start a new subsubsection.

subsubsection' :: LaTeXC l => l -> l

Start a new unnumbered subsubsection.

paragraph :: LaTeXC l => l -> l

Start a paragraph.

subparagraph :: LaTeXC l => l -> l

Start a subparagraph (minimal level of sectioning).

Logos & symbols

today :: LaTeXC l => l

Render the date at compilation time.

thePage :: LaTeXC l => l

Render the current page.

tex :: LaTeXC l => l

TeX logo.

latex :: LaTeXC l => l

The LaTeX logo.

laTeX2 :: LaTeXC l => l

LaTeX logo.

laTeXe :: LaTeXC l => l

ldots :: LaTeXC l => l

Horizontal dots.

vdots :: LaTeXC l => l

Vertical dots.

ddots :: LaTeXC l => l

Diagonal dots.

HaTeX specific

hatex :: LaTeXC l => l

Print the HaTeX logo.

hatex3 :: LaTeXC l => l

Print the HaTeX 3 logo.

version :: Version

hatex_version :: LaTeXC l => l

Print the HaTeX logo, beside the complete version number.

Document layout

par :: LaTeXC l => l

Start a new paragraph

newline :: LaTeXC l => l

Start a new line. It can be used only in paragraph mode.

lnbk :: LaTeXC l => l

Start a new line. The exactly meaning depends on the context where it is used. In normal running text when it forces a line break it is essentially a shorthand for '\newline' (does not end horizontal mode or end the paragraph, it just inserts some glue and penalties at that point into the horizontal material so that when the paragraph does end a line break will occur at that point with the short line padded with white space). In alignment environments (like tabular), it starts a new row, so use newline instead to start a new line.

lnbk_ :: LaTeXC l => l

Like lnbk, lnbk_ introduces a line break, but preventing a page break.

lnbkspc :: LaTeXC l => Measure -> l

Like lnbk, introduces a line break. But it has an argument that specifies how much extra vertical space is to be inserted before the next line. This can be a negative amount.

lnbkspc_ :: LaTeXC l => Measure -> l

Like lnbkspc, lnbkspc_ introduces a line break with an extra vertical space, but preventing a page break.

newpage :: LaTeXC l => l

cleardoublepage :: LaTeXC l => l

clearpage :: LaTeXC l => l

linebreak :: LaTeXC l => l -> l

Request to break the current line at the point of the command stretching the line so that it extends to the right margin. The number must be a number from 0 to 4. The higher the number, the more insistent the request is (0 means it will be easily ignored and 4 means do it anyway). When this line break option is used, LaTeX will try to produce the best line breaks possible.

nolinebreak :: LaTeXC l => l -> l

Like linebreak, but prevents a like break instead of requesting one.

pagebreak :: LaTeXC l => Maybe l -> l

nopagebreak :: LaTeXC l => Maybe l -> l

hspace :: LaTeXC l => Measure -> l

hspace_ :: LaTeXC l => Measure -> l

vspace :: LaTeXC l => Measure -> l

Add vertical white space, except at the end of a page.

vspace_ :: LaTeXC l => Measure -> l

Add vertical white space, even at the end of a page.

addvspace :: LaTeXC l => Measure -> l

Add extra vertical white space. In a sequence of addvspace the length of the final white space is given by the maximum of the individual lengths.

quad :: LaTeXC l => l

Space equal to the current font size (= 18 mu). \(a\quad b\)

qquad :: LaTeXC l => l

Twice of quad (= 36 mu). \(a\qquad b\)

hfill :: LaTeXC l => l

Fill out all available horizontal space.

vfill :: LaTeXC l => l

Fill out all available vertical space.

dotfill :: LaTeXC l => l

Fill out all available horizontal space with dots.

hrulefill :: LaTeXC l => l

Fill out all available horizontal space with a line.

stretch :: LaTeXC l => Double -> l

smallskip :: LaTeXC l => l

medskip :: LaTeXC l => l

bigskip :: LaTeXC l => l

baselineskip :: LaTeXC l => l

indent :: LaTeXC l => l

noindent :: LaTeXC l => l

Document measures

textwidth :: LaTeXC l => l

textheight :: LaTeXC l => l

linewidth :: LaTeXC l => l

Formatting text

verbatim :: LaTeXC l => Text -> l

The point of verbatim is to include text that will not be parsed as LaTeX in any way at all, but should simply appear as given in the document, in a separate display in typewriter font.

verb :: LaTeXC l => Text -> l

Include text, as given and in typewriter, but in-line. Note that, for LaTeX-specific technical reasons, verbatim text can generally only be used "at the top level", not in e.g. section titles or other command-arguments.

Unlike verbatim, which LaTeX implements as an ordinary environment, its command verb uses a syntax trick to avoid braking its parsing when the literal text contains a closing brace: rather than using braces at all, the first character after \verb will be the right delimiter as well. Translating this method to HaTeX wouldn't really make sense since Haskell has string literals with their own escaping possibilities; instead, we make it secure by automatically choosing a delimiter that does not turn up in the given string.

Fonts

textbf :: LaTeXC l => l -> l

Set the given argument to bold font face.

textit :: LaTeXC l => l -> l

texttt :: LaTeXC l => l -> l

Set the given argument to monospaced font.

textrm :: LaTeXC l => l -> l

textsf :: LaTeXC l => l -> l

textmd :: LaTeXC l => l -> l

textup :: LaTeXC l => l -> l

textsl :: LaTeXC l => l -> l

textsc :: LaTeXC l => l -> l

Set the given argument to small caps format.

textnormal :: LaTeXC l => l -> l

underline :: LaTeXC l => l -> l

emph :: LaTeXC l => l -> l

Sizes

Sizes are sorted from smallest to biggest.

tiny :: LaTeXC l => l -> l

scriptsize :: LaTeXC l => l -> l

footnotesize :: LaTeXC l => l -> l

small :: LaTeXC l => l -> l

normalsize :: LaTeXC l => l -> l

large :: LaTeXC l => l -> l

large2 :: LaTeXC l => l -> l

large3 :: LaTeXC l => l -> l

huge :: LaTeXC l => l -> l

huge2 :: LaTeXC l => l -> l

Environments

Math environments, such as equation, defined in Text.LaTeX.Packages.AMSMath.

enumerate :: LaTeXC l => l -> l

Environment of ordered lists. Use item to start each list item.

itemize :: LaTeXC l => l -> l

Environment of unordered lists. Use item to start each list item.

item :: LaTeXC l => Maybe l -> l

An item of a list (see enumerate or itemize). The optional argument sets the design of the item.

flushleft :: LaTeXC l => l -> l

Left-justify the argument.

flushright :: LaTeXC l => l -> l

Right-justify the argument.

center :: LaTeXC l => l -> l

Center-justify the argument.

quote :: LaTeXC l => l -> l

verse :: LaTeXC l => l -> l

cite :: LaTeXC l => l -> l

description :: LaTeXC l => l -> l

minipage

Arguments

:: LaTeXC l

=> Maybe Pos

Optional position

-> l

Width

-> l

Minipage content

-> l

Minipage environment.

figure

Arguments

:: LaTeXC l

=> Maybe Pos

Optional position.

-> l

Figure content (should usually contain includegraphics, caption and label).

-> l

Figure environment. Use this for floating Text.LaTeX.Packages.Graphicx content out of the text block and giving it a caption. The figure can be referred to with ref from elsewhere in the document.

table

Arguments

:: LaTeXC l

=> [Pos]

Position preferences. Leave empty to use default.

-> l

Table content (assemble with tabular/matrixTabular, caption and label).

-> l

Table environment. Use this for floating a tabular out of the text block and giving it a caption. The table can be referred to with ref.

Page numbering

pagenumbering :: LaTeXC l => l -> l

arabic :: LaTeXC l => l

Arabic numerals.

roman :: LaTeXC l => l

Lowercase roman numerals.

roman_ :: LaTeXC l => l

Uppercase roman numerals.

alph :: LaTeXC l => l

Lowercase letters.

alph_ :: LaTeXC l => l

Uppercase letters.

Boxes

mbox :: LaTeXC l => l -> l

fbox :: LaTeXC l => l -> l

parbox :: LaTeXC l => Maybe Pos -> Measure -> l -> l

framebox :: LaTeXC l => Maybe Measure -> Maybe HPos -> l -> l

makebox :: LaTeXC l => Maybe Measure -> Maybe HPos -> l -> l

raisebox :: LaTeXC l => Measure -> Maybe Measure -> Maybe Measure -> l -> l

rule

Arguments

:: LaTeXC l

=> Maybe Measure

Optional lifting.

-> Measure

Width.

-> Measure

Height.

-> l

Produce a simple black box.

Cross references

caption :: LaTeXC l => l -> l

label :: LaTeXC l => l -> l

ref :: LaTeXC l => l -> l

pageref :: LaTeXC l => l -> l

Tables

tabular

Arguments

:: LaTeXC l

=> Maybe Pos

This optional parameter can be used to specify the vertical position of the table. Defaulted to Center.

-> [TableSpec]

Table specification of columns and vertical lines.

-> l

Table content. See &, lnbk, hline and cline.

-> l

Resulting table syntax.

The tabular environment can be used to typeset tables with optional horizontal and vertical lines.

tabularnewline :: LaTeXC l => l

tabularnewline ends a row in array or tabular environments. The '\' command has different meanings in different contexts. It can end a line in normal text, or it can end an array or tabular line. It may be preferrable to use newline and in the first case, and tabularnewline in the second.

tabularnewlineSpc :: LaTeXC l => Measure -> l

arraybackslash :: LaTeXC l => l

arraybackslash resets the definition of '\' to tabularnewline.

array

Arguments

:: LaTeXC l

=> Maybe Pos

This optional parameter can be used to specify the vertical position of the table. Defaulted to Center.

-> [TableSpec]

Table specification of columns and vertical lines.

-> l

Table content. See &, lnbk, hline and cline.

-> l

Resulting table syntax.

Like tabular but in math mode by default

(&) :: LaTeXC l => l -> l -> l

Column separator.

hline :: LaTeXC l => l

Horizontal line.

cline :: LaTeXC l => Int -> Int -> l

cline i j writes a partial horizontal line beginning in column i and ending in column j.

multicolumn :: LaTeXC l => Int -> [TableSpec] -> l -> l

Cell taking multiple columns.

Special tables

matrixTabular

Arguments

:: (LaTeXC l, Texy a)

=> [l]

(Non-empty) List of column titles

-> Matrix a

Matrix of data

-> l

Data organized in a tabular environment

If you are able to arrange some data in matrix form, you might want to use this function to quickly generate a tabular with your data. Each element of the matrix is rendered using the Texy instance of its type. If you want a custom instance for an already instantiated type, wrap that type using newtype, and then create your own instance. Since every element of a matrix must be of the same type, for mixed tables you might want to create an union type. For example, if your data matrix contains Ints and Doubles:

data Number = R Double | I Int

instance Texy Number where
  texy (R x) = texy x
  texy (I x) = texy x

Now you can have a matrix of type Matrix Number and use it to render your mixed data in a LaTeX table.

The function matrixTabular does not give you many options, so it is not as flexible as generating the table by yourself, but it uses a reasonable standard style.

A very simple example:

matrixTabular (fmap textbf ["x","y","z"]) $
  fromList 3 3 [ (1 :: Int)..]

This code generates the following table:

For more examples see the file Examples/tables.hs, included in the source distribution.

For more info about how to generate and manipulate matrices, see Data.Matrix.

Others

centering :: LaTeXC l => l

raggedleft :: LaTeXC l => l

raggedright :: LaTeXC l => l

footnote :: LaTeXC l => l -> l

footnotemark :: LaTeXC l => l

Prints a foot note mark but without the actual footnote.

footnotetext :: LaTeXC l => l -> l

Prints the footnote corresponding to the previous footnotemark. Useful when dealing with footnotes in tabular environment.

stepcounter :: LaTeXC l => String -> l

Increases by 1 the value of given counter

addtocounter :: LaTeXC l => String -> Int -> l

Increases by n the value of given counter t

protect :: LaTeXC l => l -> l

hyphenation :: LaTeXC l => l -> l

hyp :: LaTeXC l => l

qts :: LaTeXC l => l -> l

Quotation marks.

Maths commands

module Text.LaTeX.Base.Math

External files

input :: LaTeXC l => FilePath -> l

Import an external file and insert its content as it is.

include :: LaTeXC l => FilePath -> l

Similar to input, but forces a page break.

Note: the file you are including cannot include other files.