1.4 Input File Structure
7
1.4 Input File Structure
When L
A
T
E
X2
ε
processes an input file, it expects it to follow a certain
structure. Thus every input file must start with the command
\documentclass{...}
This specifies what sort of document you intend to write. After that, add
commands to influence the style of the whole document, or load packages
that add new features to the LAT
E
Xsystem. To load such a package you use
the command
\usepackage{...}
When all the setup work is done,
4
you start the body of the text with
the command
\begin{document}
Now you enter the text mixed with some useful L
A
T
E
Xcommands. At
the end of the document you add the
\end{document}
command, which tells L
A
T
E
Xto call it a day. Anything that follows this
command will be ignored by LAT
E
X.
Figure1.1 shows the contents of a minimalLAT
E
X2
ε
file. A slightly more
complicated input file is given in Figure1.2.
1.5 A Typical Command Line Session
Ibet you must be dying to try out the neat small L
A
T
E
Xinput file shown
on page7. Here is some help: L
A
T
E
Xitself comes without a GUI or fancy
buttons to press. It is just a program that crunches away at your input file.
Some LAT
E
Xinstallations feature a graphical front-end where there is a LAT
E
X
button to start compiling your input file. On other systems there might be
4
The area between \documentclass and \begin{document} is called the preamble.
\documentclass{article}
\begin{document}
Small is beautiful.
\end{document}
Figure 1.1: A Minimal L
A
T
E
XFile.
Pdf to html conversion - application Library cloud:C# PDF Convert to HTML SDK: Convert PDF to html files in C#.net, ASP.NET MVC, WinForms, WPF application
How to Convert PDF to HTML Webpage with C# PDF Conversion SDK
www.rasteredge.com
Pdf to html conversion - application Library cloud:VB.NET PDF Convert to HTML SDK: Convert PDF to html files in vb.net, ASP.NET MVC, WinForms, WPF application
PDF to HTML Webpage Converter SDK for VB.NET PDF to HTML Conversion
www.rasteredge.com
8
Things You Need to Know
some typing involved, so here is how to coax LAT
E
Xinto compiling your input
file on a text based system. Please note: this description assumes that a
working LAT
E
Xinstallation already sits on your computer.
5
1. Edit/CreateyourL
A
T
E
Xinput file. This file must be plain ASCII text.
On Unix all the editors will create just that. On Windows you might
want to make sure that you save the file in ASCII or Plain Text format.
When picking a name for your file, make sure it bears the extension
.tex.
2. Openashellorcmdwindow,cdtothedirectorywhereyourinputfile
is located and run LAT
E
Xon your input file. If successful you will end
up with a.dvi file. It may be necessary to run LAT
E
Xseveral times to
get the table of contents and all internal references right. When your
input file has a bug L
A
T
E
Xwill tell you about it and stop processing
your input file. Type ctrl-D to get back to the command line.
latex foo.tex
3. NowyoumayviewtheDVIfile. Thereareseveralwaystodothat.
5ThisisthecasewithmostwellgroomedUnixSystems,and... RealMenuseUnix,
so ... ;-)
\documentclass[a4paper,11pt]{article}
% define the title
\author{H.~Partl}
\title{Minimalism}
\begin{document}
% generates the title
\maketitle
% insert the table of contents
\tableofcontents
\section{Some Interesting Words}
Well, and here begins my lovely article.
\section{Good Bye World}
\ldots{} and here it ends.
\end{document}
Figure 1.2: Example of a Realistic Journal Article. Note that all the
commands you see in this example will be explained later in the introduction.
application Library cloud:Online Convert PDF to HTML5 files. Best free online PDF html
This Visual C#.NET PDF to HTML conversion control component makes it extremely easy for C# developers to convert and transform a multi-page PDF document and
www.rasteredge.com
application Library cloud:C# PDF Converter Library SDK to convert PDF to other file formats
C#.NET PDF to HTML Conversion. Using provided C# code example, fast conversion from PDF to HTML can be achieved. C#.NET PDF to SVG Conversion.
www.rasteredge.com
1.6 The Layout of the Document
9
Look at the file on screen with
xdvi foo.dvi &
This only works on Unix with X11. If you are on Windows you might
want to try yap (yet another previewer).
Convert the dvi file to PostScript for printing or viewing with
GhostScript.
dvips -Pcmz foo.dvi -o foo.ps
If you are lucky your L
A
T
E
Xsystem even comes with thedvipdf tool,
which allows you to convert your .dvi files straight into pdf.
dvipdf foo.dvi
1.6 The Layout of the Document
1.6.1 Document Classes
The first information LAT
E
Xneeds to know when processing an input file is
the type of document the author wants to create. This is specified with the
\documentclass command.
\documentclass[options]{class}
Here class specifies the type of document to be created. Table1.1 lists the
document classes explained in this introduction. TheL
AT
E
X2
ε
distribution
provides additional classes for other documents, including letters and slides.
The options parameter customises the behaviour of the document class. The
options have to be separated by commas. The most common options for the
standard document classes are listed in Table1.2.
Example: An input file for a LAT
E
Xdocument could start with the line
\documentclass[11pt,twoside,a4paper]{article}
which instructs L
A
T
E
Xto typeset the document as an article with a base
font size of eleven points, and to produce a layout suitable for double sided
printing on A4 paper.
application Library cloud:.NET PDF Document Viewing, Annotation, Conversion & Processing
XDoc.PDF SDK for .NET. RasterEdge XDoc.PDF for .NET is a professional .NET PDF solution that provides complete and advanced PDF document processing features.
www.rasteredge.com
application Library cloud:VB.NET PDF Converter Library SDK to convert PDF to other file
Conversion of PDF to Html5. For how to convert PDF to HTML document in VB.NET application, a simple and easy VB.NET sample code is given on this page for you
www.rasteredge.com
10
Things You Need to Know
1.6.2 Packages
While writing your document, you will probably find that there are some
areas where basic LAT
E
Xcannot solve your problem. If you want to include
graphics, coloured text or source code from a file into your document, you
need to enhance the capabilities of L
A
T
E
X. Such enhancements are called
packages. Packages are activated with the
\usepackage[options]{package}
command, where package is the name of the package and options is a list
of keywords that trigger special features in the package. The\usepackage
command goes into the preamble of the document. See section1.4 for details.
Some packages come with theLAT
E
X2
ε
base distribution (See Table1.3).
Others are provided separately. You may find more information on the
packages installed at your site in your Local Guide [5]. The prime source for
information about LAT
E
Xpackages is The LAT
E
XCompanion [3]. It contains
descriptions on hundreds of packages, along with information of how to write
your own extensions to LAT
E
X2
ε
.
Modern T
E
Xdistributions come with a large number of packages prein-
stalled. If you are working on a Unix system, use the commandtexdoc for
accessing package documentation.
Table 1.1: Document Classes.
article forarticlesinscientificjournals,presentations,shortreports,pro-
gram documentation, invitations, ...
proc a class for proceedings based on the article class.
minimal isassmallasitcanget. Itonlysetsapagesizeandabasefont. . It
is mainly used for debugging purposes.
report forlongerreportscontainingseveralchapters, smallbooks,PhD
theses, ...
book for real books
slides forslides. Theclassusesbigsansserifletters.Youmightwantto
consider using the Beamer class instead.
application Library cloud:C# Windows Viewer - Image and Document Conversion & Rendering in
CSV Document Conversion. RasterEdge Windows Viewer SDK provides how to convert TIFF: Convert to PDF. Convert to Various Images. PDF Document Conversion.
www.rasteredge.com
application Library cloud:C# Word - Word Conversion in C#.NET
And detailed C# demo codes for these conversions are offered below. C# Demo Codes for Word Conversions. Word to PDF Conversion. PDF to Word Conversion.
www.rasteredge.com
1.6 The Layout of the Document
11
Table 1.2: Document Class Options.
10pt, 11pt, 12pt
Sets the size of the main font in the document. If no
option is specified, 10pt is assumed.
a4paper, letterpaper, ...
Defines the paper size. The default size is
letterpaper. Besides that, a5paper, b5paper, executivepaper,
and legalpaper can be specified.
fleqn
Typesets displayed formulae left-aligned instead of centred.
leqno
Places the numbering of formulae on the left hand side instead of
the right.
titlepage, notitlepage
Specifies whether a new page should be started
after the document title or not. The article class does not start a
new page by default, while report and book do.
onecolumn, twocolumn
Instructs L
A
T
E
Xto typeset the document in one
column or two columns.
twoside, oneside
Specifies whether double or single sided output
should be generated. The classesarticle andreport are single sided
and the book class is double sided by default. Note that this option
concerns the style of the document only. The optiontwoside does not
tell the printer you use that it should actually make a two-sided
printout.
landscape
Changes the layout of the document to print in landscape
mode.
openright, openany
Makes chapters begin either only on right hand
pages or on the next page available. This does not work with the
article class, as it does not know about chapters. The report class
by default starts chapters on the next page available and the book
class starts them on right hand pages.
application Library cloud:C# powerpoint - PowerPoint Conversion & Rendering in C#.NET
And detailed C# demo codes for these conversions are offered below. C# Demo Codes for PowerPoint Conversions. PowerPoint to PDF Conversion.
www.rasteredge.com
application Library cloud:VB.NET PDF Convert to Word SDK: Convert PDF to Word library in vb.
As RasterEdge VB.NET PDF to Word converter library has its own PDF decoder, it can finish high-fidelity PDF to Word conversion without depending on other third
www.rasteredge.com
12
Things You Need to Know
Table 1.3: Some of the Packages Distributed with L
A
T
E
X.
doc Allows the documentation of L
A
T
E
Xprograms.
Described in doc.dtx
a
and in The L
A
T
E
XCompanion [3].
exscale Provides scaled versions of the math extension font.
Described in ltexscale.dtx.
fontenc Specifies which font encoding LAT
E
Xshould use.
Described in ltoutenc.dtx.
ifthen Provides commands of the form
‘if...then do...otherwise do....’
Described in ifthen.dtx and The LAT
E
XCompanion [3].
latexsym To accessthe LAT
E
Xsymbol font, you should use the latexsym
package. Described inlatexsym.dtx and in The LAT
E
XCompanion [3].
makeidx Providescommandsforproducingindexes. Describedinsection4.3
and in The LAT
E
XCompanion [3].
syntonly Processes a document without typesetting it.
inputenc AllowsthespecificationofaninputencodingsuchasASCII,ISO
Latin-1, ISO Latin-2, 437/850 IBM code pages, Apple Macintosh, Next,
ANSI-Windows or user-defined one. Described in inputenc.dtx.
aThisfileshouldbeinstalledonyoursystem,andyoushouldbeabletogeta
dvifile
by typinglatex doc.dtx in any directory where you have write permission. The same is
true for all the other files mentioned in this table.
1.7 Files You Might Encounter
13
1.6.3 Page Styles
L
A
T
E
Xsupports three predefined header/footer combinations—so-called page
styles. The style parameter of the
\pagestyle{style}
command defines which one to use. Table1.4 lists the predefined page styles.
Table 1.4: The Predefined Page Styles of LAT
E
X.
plain printsthepagenumbersonthebottomofthepage,inthemiddleof
the footer. This is the default page style.
headings printsthecurrentchapterheadingandthepagenumberinthe
header on each page, while the footer remains empty. (This is the style
used in this document)
empty sets both the header and the footer to be empty.
It is possible to change the page style of the current page with the
command
\thispagestyle{style}
Adescription how to create your own headers and footers can be found
in The LAT
E
XCompanion [3] and in section4.4 on page87.
1.7 Files You Might Encounter
When you work with L
A
T
E
Xyou will soon find yourself in a maze of files
with various extensions and probably no clue. The following list explains the
various file types you might encounter when working with T
E
X. Please note
that this table does not claim to be a complete list of extensions, but if you
find one missing that you think is important, please drop me a line.
.tex LAT
E
Xor T
E
Xinput file. Can be compiled with latex.
.sty LAT
E
XMacro package. Load this into your LAT
E
Xdocument using the
\usepackage command.
.dtx DocumentedT
E
X. This is the main distribution format for L
A
T
E
Xstyle
files. If you process a .dtx file you get documented macro code of the
LAT
E
Xpackage contained in the .dtx file.
14
Things You Need to Know
.ins Theinstallerforthefilescontainedinthematching.dtxfile. Ifyou
download a LAT
E
Xpackage from the net, you will normally get a .dtx
and a .ins file. Run LAT
E
Xon the .ins file to unpack the .dtx file.
.cls Classfilesdefinewhatyourdocumentlookslike. Theyareselected
with the \documentclass command.
.fd Font description file telling LAT
E
Xabout new fonts.
The following files are generated when you run L
A
T
E
Xon your input file:
.dvi DeviceIndependentFile.ThisisthemainresultofaLAT
E
Xcompile
run. Look at its content with a DVI previewer program or send it to a
printer with dvips or a similar application.
.log Givesadetailedaccountofwhathappenedduringthelastcompiler
run.
.toc Storesallyoursectionheaders.Itgetsreadinforthenextcompiler
run and is used to produce the table of contents.
.lof This is like .toc but for the list of figures.
.lot And again the same for the list of tables.
.aux Anotherfilethattransportsinformationfromonecompilerruntothe
next. Among other things, the .aux file is used to store information
associated with cross-references.
.idx Ifyourdocumentcontainsanindex.L
A
T
E
Xstores all the words that
go into the index in this file. Process this file withmakeindex. Refer
to section4.3 on page86 for more information on indexing.
.ind Theprocessed.idxfile,readyforinclusionintoyourdocumentonthe
next compile cycle.
.ilg Logfile telling what makeindex did.
1.8 Big Projects
When working on big documents, you might want to split the input file into
several parts. LAT
E
Xhas two commands that help you to do that.
\include{filename}
Use this command in the document body to insert the contents of another file
named filename.tex. Note that LAT
E
Xwill start a new page before processing
the material input from filename.tex.
1.8 Big Projects
15
The second command can be used in the preamble. It allows you to
instruct LAT
E
Xto only input some of the \included files.
\includeonly{filename,filename,...}
After this command is executed in the preamble of the document, only
\includecommandsforthefilenamesthatarelistedintheargumentofthe
\includeonly command will be executed.
The\include command starts typesetting the included text on a new
page. This is helpful when you use\includeonly, because the page breaks
will not move, even when some include files are omitted. Sometimes this
might not be desirable. In this case, use the
\input{filename}
command. It simply includes the file specified. No flashy suits, no strings
attached.
To make L
A
T
E
Xquickly check your document use the syntonly package.
This makes L
A
T
E
Xskim through your document only checking for proper
syntax and usage of the commands, but doesn’t produce any (DVI) output.
As LAT
E
Xruns faster in this mode you may save yourself valuable time. Usage
is very simple:
\usepackage{syntonly}
\syntaxonly
When you want to produce pages, just comment out the second line (by
adding a percent sign).
Documents you may be interested
Documents you may be interested