--- a/latex/handout.rst Thu Sep 17 03:24:47 2009 +0530
+++ b/latex/handout.rst Thu Sep 17 13:45:31 2009 +0530
@@ -3,7 +3,7 @@
Introduction
------------
-LaTeX is a typesetting program that is excellent for producting scientific and mathematical documents of high typographical quality. It is also suitable for producing all sorts of other documents, from simple letters to complete books. LaTeX uses TeX as its formatting engine.
+LaTeX is a typesetting program used to produce excellently typeset documents. It is extensively used for producing high quality scientific and mathematical documents. It may also be used for producing other kinds of documents, ranging from simple one page articles or letters
TeX & LaTeX
@@ -12,100 +12,47 @@
TeX
+++
-TeX is a typesetting system designed and mostly written by Donald Knuth. It was designed with two goals in mind-
-
+TeX is a typesetting system designed by Donald Knuth, the renowned Computer Scientist and Emeritus professor at Stanford University. Typesetting is placing text onto a page with all the style formatting defined, so that content looks as intended.
+
+It was designed with two goals in mind-
+
1. To allow anybody to produce high-quality books using a reasonable amount of effort.
2. To provide a system that would give the exact same results on all computers, now and in the future
-It’s also a Turing-complete programming language, in the sense that it supports the if-else construct, it can calculate (the calculations are performed while compiling the document), etc., but you would find it very hard to make anything else but typesetting with it. The fine control TeX offers makes it very powerful, but also difficult and time-consuming to use.
-
-TeX is renowned for being extremely stable, for running on many different kinds of computers, and for being virtually bug free.
+TeX is well known for it's stability and portability.
-The version number of TeX is converging to π and is now at 3.1415926.
+TeX is pronounced as "tech".
-The characters T, E, X in the name come from capital Greek letters tau, epsilon, and chi, as the name of TeX derives from the Greek: τέχνη (skill, art, technique); for this reason, TeX's creator Donald Knuth promotes a /tɛx/ pronunciation
+The current version of TeX is 3.1415926 and is converging to π.
LaTeX
+++++
-LaTeX is a macro package based on TeX created by Leslie Lamport. It was intended to provide a high-level language that provides access to TeX. It essentially comprises a collection of TeX macros and a program to process LaTeX documents. For the end-users, it is much simpler to use than TeX. It has become the dominant method for using TeX (relatively few people write in TeX anymore).
+
+LaTeX was originally written by Leslie Lamport in the early 1980s. It is an extension of TeX, consisting of TeX macros and a program to parse the LaTeX files. It is easier to use than TeX itself, at the same time producing the same quality of output.
LaTeX is pronounced either as "Lah-tech" or "Lay-tech"
WYSIWG vs. WYSIWM
~~~~~~~~~~~~~~~~~
-The Advantages-
-
- * It is free (both as in free-beer and free-speech)
- * It is platform independent.
- * It is very stable.
- * LaTeX is ASCII and any text editor of your choice can be used to view and edit the source.
- * The typesetting is better, especially the maths.
- * It encourages Authors to write well-structured texts, since specifying structure is an integral part of how LaTeX works.
- * LaTeX is extensible. If you want a new feature, you can look around for a free add-on or write one yourself.
-
-and some Disadvantages -
-
- * Font selection is difficult
- * LaTeX's not good at flowing text around pictures.
- * LaTeX encourages (almost insists on) structured writing and the separation of style from content. This is not the way that many people (especially non-programmers) are used to working.
- * Without a WYSIWYG front end, it's not always easy to find out how to do things.
-LaTeX Source
-~~~~~~~~~~~~
-
-::
-
- %hello.tex - First LaTeX document
- \documentclass{article}
+WYSIWG is an acronym for "What You See Is What You Get". Word processors, are typically WYSIWG tools. LaTeX, TeX or other TeX based tools are not. They are typesetting or text formatting or document description programs. They can be called WYSIWM or "What You See Is What you Mean" systems, since you give a description of how things look, and LaTeX typesets the document for you.
- \begin{document}
- Hello, World!
- \end{document}
-
-
-Spaces
-++++++
-
-LaTeX ignores whitespaces. Multiple white spaces are treated as one space. An empty line between two lines of text is considered as a change of paragraphs.
+Here are a few reasons, why you should use LaTeX -
-Special Characters
-++++++++++++++++++
-
-The characters ``~ # $ % ^ & _ { } \`` have special meanings associated with them.
-
-These characters can be used in your document by adding a prefix backslash. ``\~ \# \% \$ \^ \& \_ \{ \} \textbackslash``
-
-Comments
-++++++++
-
-% character is used to insert comments into a LaTeX document. All the text from the % character to the end of that line is ignored by LaTeX.
-
-
-LaTeX Commands
-++++++++++++++
+ * LaTeX produces documents with excellent visual quality, especially mathematical and scientific documents.
+ * It does the typesetting to you. Typically, when one works with a word-processor, the user is doing the text formatting or typesetting along with typing out the content. LaTeX allows the user to concentrate on the content leaving aside the typesetting to LaTeX.
+ * It is light on your resources as compared to most of the word processors available today.
+ * It is well known for it's stability and for it's virtually bug free code base.
+ * It encourages users to structure documents by meaning rather than appearance, thereby helping produce well structured documents.
+ * It uses plain text files as input, which have a lot of well known advantages over binary files. To state a few, they can be opened with any editor on any operating system, they are smaller in size compared to the binaries, can be version controlled and can be processed using widely used text processing utilities.
+ * The output can be generated in more than one formats.
+ * It is free software (free as in freedom) and gratis too.
+ * It is widely used.
-* LaTeX commands are case sensitive.
-* They start with a backslash ``\``
-* They come in two formats
-
- - a backslash followed by a name consisting of letters only. These command names are terminated by any non-letter.
- - a backslash followed by exactly one non-character.
-
-* Some commands need to be given a parameter, which is enclosed in curly braces ``{ }``
-* Some command support optional parameters, which are added after the name in square brackets ``[ ]``
+Hello World
+~~~~~~~~~~~
-LaTeX Environments
-++++++++++++++++++
-
-Environments are similar in their role, to commands, except that they effect a larger part of the document.
-
-* They begin with a ``\begin`` and end with a ``\end``
-* Nested environments are generally supported
-
-Anything in LaTeX can be expressed in terms of Commands and Environments.
-
-Hello, World!
-~~~~~~~~~~~~~
+Ok, let's get started with our first LaTeX document. Open up your favorite editor and type in the following code.
::
@@ -116,33 +63,10 @@
Hello, World!
\end{document}
-Now, look at what each line does.
-
-
-``%hello.tex - First LaTeX document``
-
- This line is a comment. Comments in LaTeX begin with a %
-
-``\documentclass{article}``
-
- This line is a command and sets the documentclass to be used for this document to ``article``. If you want to change the appearance of the document, you simply have to change the documentclass.
-
-
-``\begin{document}``
-
- This line is the beginning of a LaTeX environment called ``document``. It informs LaTeX that the content of the document is beginning. Anything between the ``\documentclass`` line and this line is called the *preamble*
-
-``Hello, World!``
-
- This is the text that is displayed in the document.
-
-``\end{document}``
-
- The ``document`` environment ends here. It tells LaTeX that the document is complete and anything written after this line will be ignored by LaTeX.
+Save the file as ``hello.tex`` and open up a terminal to compile your ``tex`` file to get the output in a ``pdf`` format.
Compiling & Output
-~~~~~~~~~~~~~~~~~~
-``latex`` command can be used to get ``dvi`` output. But, we shall be using ``pdflatex`` all through this document and producing ``pdf`` output.
+++++++++++++++++++
::
@@ -151,297 +75,236 @@
Output written on hello.pdf (1 page, 5733 bytes).
Transcript written on hello.log.
-.. .. image:: sample/hello.jpg
+Open the ``hello.pdf`` to see the output as shown.
+
+.. image:: examples/hello.jpg
+
+Note: The command ``latex`` is often used to get the ``dvi`` output. But, throughout this course, we shall use pdflatex to compile our documents.
+A peek at the source
+++++++++++++++++++++
+
+``%hello.tex - First LaTeX document``
+
+ This line is a comment. LaTeX ignores this line and it is meant only for the human readers. LaTeX ignores anything after a ``%`` symbol to the end of the line.
+
+``\documentclass{article}``
+
+ This line is a command and sets the ``documentclass`` of the document to ``article``. LaTeX has other classes like ``report``, ``book``, ``letter``, etc. The typesetting of the document varies depending on the ``documentclass`` of the document.
-Document Structure
-------------------
+``\begin{document}``
+
+ This line informs LaTeX that this is the beginning of the content of the document.
+
+``Hello, World!``
+
+ This is the actual text displayed in the document.
+
+``\end{document}``
+
+ This line tells LaTeX that the document is complete and LaTeX will simply ignore anything written after this line.
+
+Where do we want to go
+~~~~~~~~~~~~~~~~~~~~~~
+
+During the course of this session we will learn how to do various things in LaTeX and try to produce the sample document provided.
+
+Some Basics
+~~~~~~~~~~~
+Before we get started with creating the document, let's try to understand a few things that would be useful during the course of this session.
+
+Spaces
+++++++
+
+LaTeX treats multiple empty spaces (or lines) as a single space (or line). An empty line between two lines of text is considered as a change of paragraphs.
+
+Line & Page Breaks
+++++++++++++++++++
+
+LaTeX usually does the job of breaking up your content into lines and pages, and does it well. But under some circumstances, you might want to instruct LaTeX to break line or start a new page at a particular point.
+
+``\\`` or ``\newline`` command is used to create a new line at the point where the command is issued.
+Appending ``*`` to ``\\``, instructs LaTeX to create a new line, without creating a new page at that point.
-This section gives a basic idea about the general sturcture of a LaTeX document. LaTeX is different from other typesetting software in that, it requires the user to specify the logical and semantic structure of the text. Therefore, it helps (almost forces) the author to organize his text better and hence improving the structure and clarity of the document.
+Paragraphs
+++++++++++
+
+As already mentioned, LaTeX considers an empty line between two lines of text as a new paragraph. ``\par`` command may also be used to start a newline. It is equivalent to the blank line.
+
+By default LaTeX indents new paragraphs. If you do not wish to have the paragraph indented, you can use the ``\nointend`` command at the beginning of the paragraph.
+
+Special Characters
+++++++++++++++++++
+
+LaTeX associates special meaning to the characters ``~ # $ % ^ & _ { } \``.
+
+To have these characters in the text of your document, you need to prefix a backslash to them. ``\~ \# \% \$ \^ \& \_ \{ \} \textbackslash``
+
+
+Commands
+++++++++
+
+* All LaTeX commands start with a backslash ``\``.
+* Like the commands in Linux, they are case sensitive.
+* They usually have a backslash followed by a consisting of letters only. Any character other than letters, like space, numbers or special characters terminate the command.
+* The commands for producing special characters in the text, is an exception. They contain a backslash followed by a single special character.
+* Commands may have parameters, which are supplied to them by enclosing them in curly braces ``{ }``.
+* They may also have a few optional parameters which are added after the name in square brackets ``[ ]``.
+
+
+Environments
+++++++++++++
+
+Environments are very similar to the commands, except that they effect larger parts of the document. For example, we used the ``document`` environment in our first LaTeX document.
+
+* They begin with a ``\begin`` and end with a ``\end``
+* In general environments can be nested within each other.
+
+Some Structural Elements
+------------------------
``\documentclass``
~~~~~~~~~~~~~~~~~~
+As already stated, the ``documentclass`` command tells LaTeX, the type of the document that you intend to create. Each class has a few differences in how the content of the document is typeset. We presently have it set to the article class. Let us try changing it to the report class.
-The type of the document to be created is specified using the ``\documentclass`` command.
-::
+Note that the top matter of the document appears in a different page for the report class.
- \documentclass[options]{class}
+Some of the LaTeX classes that you may want to use are, article, proc, report, book, slides, letter.
+
+The ``documentclass`` command also accepts a few optional parameters. For example::
+ \documentclass[12pt,a4paper,oneside,draft]{report}
-Here, ``class`` defines the type of document that is to be created. The LaTeX distribution provides a variety of document class, that can be used for a variety of purposes. The ``options`` parameter customizes various properties of the document. The options have to be separated by commas.
+``12pt`` specifies the size of the main font in the document. The relative sizes of the various fonts is maintained, when the font size is changed. If no size is specified, ``10pt`` is assumed by default.
+
+``a4paper`` specifies the size of the paper to be used for the document.
-For example ``\documentclass[11pt, twoside, a4paper]{article}`` produces a document of the article class with the base font size as eleven points, and to produce a layout suitable for double sided printing on A4 paper.
+``oneside`` specifies that the document will be printed only on one side of the paper. The ``article`` and ``report`` classes are ``oneside`` by default and the ``book`` class is ``twoside``.
-Some of the document classes that are available in LaTeX are ``article, report, book, slides, letter``
+``draft`` marks the hyphenation and justification problems in the document with a small square in the right hand margin of the document, so that they can be easily spotted.
+
+Note: Everything written in between the ``\documentclass`` command and the ``\begin{document}`` command is called the Preamble.
-The document environment
-~~~~~~~~~~~~~~~~~~~~~~~~
-The text of the document is enclosed in between the commands ``\begin{document}`` and ``\end{document}`` which identify the beginning and the end of the document respectively.
+Parts, Chapters and Sections
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The reason for marking off the beginning of your text is that LaTeX allows you to insert extra setup specifications before it. The reason for marking off the end of your text is to provide a place for LaTeX to be programmed to do extra stuff automatically at the end of the document, like making an index.
-
-A useful side-effect of marking the end of the document text is that you can store comments or temporary text underneath the \end{document} in the knowledge that LaTeX will never try to typeset them
+Often documents are divided into various parts, chapters, sections and subsections. LaTeX provides an intuitive mechanism to include this in your documents. It has various commands like ``part``, ``chapter``, ``section``, ``subsection``, ``subsubsection``, ``paragraph`` and ``subparagraph``. Note that all these commands are not available in all the document classes. The ``chapter`` command is available only in books and reports. Also, the ``letter`` document class does not have any of these commands.
-Preamble
-~~~~~~~~
-Everything written in between the ``\documentclass`` command and the ``\begin{document}`` command is called the Preamble. It normally contains commands that effect the whole document.
+Let us now give our document some structure, using these commands.
-Packages
-~~~~~~~~
-
-While writing your document, you will probably find that there are some areas where basic LaTeX cannot 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 LaTeX. Such enhancements are called packages. Packages are activated with the
+Note that you do not need to provide any numbers to the commands. LaTeX automatically takes care of the numbering.
+Also, you do not need to enclose the text of a block within ``\begin`` and ``\end`` commands. LaTeX starts a new block each time it finds a sectioning command.
::
- \usepackage[options]{package}
+ \section[Short Title]{This is a very long title and the Short Title will appear in the Table of Contents.}
+
+
+Section Numbering
++++++++++++++++++
+
+As already, you don't need to explicitly do any numbering in LaTeX. Parts are numbered using roman numerals; Chapters and sections are numbered using decimal numbers. When the table of contents is inserted into a document, all the numbered headings automatically appear in it.
-command, where package is the name of the package and options is a list of keywords that trigger special features in the package. Some packages come with the LaTeX2e distribution and others are provided separately. You can even write your own packages, if and when required.
+By default LaTeX has numbering up 2 levels, i.e, the parts, chapters, sections and subsections are numbered. You can change this by setting the ``secnumdepth`` counter using the ``\setcounter`` command. The following command removes numbering of the subsections. Only parts, chapters and sections are numbered.
+::
+
+ \setcounter{secnumdepth}{1}
+
+A sectioning command appended with an asterisk gives an unnumbered heading that is not included in the table of contents.
+::
+
+ \section*{Introduction}
Top Matter
~~~~~~~~~~
-At the beginning of most documents there will be information about the document itself, such as the title and date, and also information about the authors, such as name, address, email etc. All of this type of information within Latex is collectively referred to as top matter. Although never explicitly specified (there is no \topmatter command) you are likely to encounter the term within Latex documentation.
+The information about the document such as it's title, the date, the author(s) information etc, is collectively known as the topmatter. Though there is no command called ``topmatter``, the term topmatter is frequently used in LaTeX documentation.
-An example::
+Let us input the top matter for our document now.
+::
- \documentclass[11pt,a4paper,oneside]{report}
- \title{LaTeX - A Howto}
+ \title{LaTeX - A How-to}
\author{The FOSSEE Team}
- \date{August 2009}
- \maketitle
+ \date
-The ``\title``, ``\author`` and ``\date`` commands are self-explanaotry. You put the title, author name, and date in curly braces after the relevant command. If no date command is used, today's date is insert by default.
+The commands ``\title`` and ``\author`` are self explanatory.
+The ``\date`` command automatically puts in today's date into the document. Now let us compile and look at the result.
-Topmatter is always finished by the ``\maketitle`` command
+You would observe that the details do not appear in the document after recompilation. This is because, LaTeX has not been instructed what to do with the top matter information that you have given it. Use the ``\maketitle`` command within the document environment to instruct LaTeX to place the top matter information into the document.
Abstract
~~~~~~~~
-
-As most research papers have an abstract, there are predefined commands for telling LaTeX which part of the content makes up the abstract. This should appear in its logical order, therefore, after the top matter, but before the main sections of the body. This command is available for the document class article and report, but not book.
+Lets now place and abstract in the document using the ``abstract`` environment of LaTeX. The abstract appears in the document after the topmatter but before the main body of the document.
::
- \documentclass{article}
\begin{abstract}
- Your abstract goes here...
+ The abstract abstract.
\end{abstract}
- \begin{document}
- ...
- \end{document}
-
-By default, LaTeX will use the word “Abstract” as a title for your abstract, if you want to change it into anything else, e.g. “Executive Summary”, add the following line in the preamble::
-
- \renewcommand{\abstractname}{Executive Summary}
-
-Sectioning Commands
-~~~~~~~~~~~~~~~~~~~
-
-The commands for inserting sections are fairly intuitive. Of course, certain commands are appropriate to different document classes. For example, a book has chapters but an article doesn’t.
-
-Examples::
-
- \Chapter{LaTeX}
-
- \section{Introduction}
- \subsection{TeX & LaTeX}
-
- \subsubsection{TeX}
-
-Notice that you do not need to specify section numbers. LaTeX will sort that out for you! Also, for sections, you do not need to markup which content belongs to a given block, using \begin and \end commands, for example.
-
-All the titles of the sections are added automatically to the table of contents (if you decide to insert one). But if you make manual styling changes to your heading, for example a very long title, or some special line-breaks or unusual font-play, this would appear in the Table of Contents as well, which you almost certainly don’t want. LaTeX allows you to give an optional extra version of the heading text which only gets used in the Table of Contents and any running heads, if they are in effect. This optional alternative heading goes in [square brackets] before the curly braces.
-::
-
- \section[Short Title]{This is a very long title and the Short Title will appear in the Table of Contents.}
-
-Section Numbering
-+++++++++++++++++
-
-You don't need to explicitly do any section numbering as LaTeX does it automatically. Parts get roman numerals, Chapters and Sections get decimal numbering and Appendices are lettered. You can change the depth to which section numbering occurs, which is set to 2 by default.
-
-For example, if you want only the Parts, Chapters and Sections to be numbered and not the subsections, subsubsections etc., you can set the ``secnumdepth`` to 1 using the ``\setcounter`` command.
-::
-
- \setcounter{secnumdepth}{1}
-
-To get an unnumbered section heading which does not go into the Table of Contents, follow the command name with an asterisk before the opening curly brace.
-::
-
- \subsection*{Introduction}
-
-All the divisional commands from ``\part*`` to ``\subparagraph*`` have this “starred” version which can be used on special occasions for an unnumbered heading when the setting of ``secnumdepth`` would normally mean it would be numbered.
Appendices
~~~~~~~~~~
-The separate numbering of appendices is also supported by LaTeX. The \appendix macro can be used to indicate that following sections or chapters are to be numbered as appendices.
+LaTeX allows for separate numbering for appendices. ``\appendix`` command indicates that the sections following are to be included in the appendix.
::
\appendix
\chapter{First Appendix}
- \appendix
- \section{First Appendix}
-
Table of Contents
~~~~~~~~~~~~~~~~~
-All auto-numbered headings get entered in the Table of Contents (ToC) automatically. Just add the command ``\tableofcontents`` at the point where you want it placed.
+Parts, chapters or sections that have been auto numbered by LaTeX automatically appear in the Table of Contents (ToC). ``\tableofcontents`` command places a the ToC, where the command has been issued.
-The counter ``tocdepth`` specifies what depth to take the ToC to. It can be set using the ``\setcounter`` command as shown below.
+The counter ``tocdepth`` specifies the depth up to which headings appear in the ToC. It can be set using the ``\setcounter`` command as shown below.
::
\setcounter{tocdepth}{3}
-If you want the unnumbered section to be in the table of contents anyway, use the ``\addcontentsline`` command like this.
+Unnumbered sections can be placed in the table of contents using the ``\addcontentsline`` command as shown below.
::
\section*{Introduction}
\addcontentsline{toc}{section}{Introduction}
-Entries for the ToC are recorded each time you process your document, and re- produced the next time you process it, so you need to re-run LaTeX one extra time to ensure that all ToC pagenumber references are correctly calculated. We’ve already seen how to use the optional argument to the sectioning commands to add text to the ToC which is slightly different from the one printed in the body of the document. It is also possible to add extra lines to the ToC, to force extra or unnumbered section headings to be included.
-
-
-Bibliography
-~~~~~~~~~~~~
-Any good research paper will have a whole list of references. LaTeX, therefore, has a sane way to manage your references. There are two ways to insert references into your LaTeX document:
-
-1. You can embed them within the doucment itself. It's simpler, but it can be time consuming if you are writing several papers about similar subjects so that you often have to cite the same references
-2. You can store them in an external BibTeX file and then link them to your current document. You can also use a BibTeX style to define how they should appear. This way you create a small databases of the references you might need, and use them as and when you need to cite them.
-
-We shall discuss this in more detail in the Bibliography section.
-
-Including files
-~~~~~~~~~~~~~~~
-When you are working on a large document, you might want to split the input files into multiple files. LaTeX has three methods for inserting one file into another when compiling.
+Note: To get the correct entries in your table of contents, you will need to run one extra compilation, each time. This is because, the entries of the table of contents are collected during each compilation of the document and utilized during the next compilation.
-1. ``\input``
-
- It is equivalent to an automatic cut-paste just before compiling. To include ``file1.tex`` in our document, we just say
- ::
-
- \input{file1}
-
+Elementary Text Typesetting
+---------------------------
-2. ``\include``
-
- It is similar to the ``\input`` command, except that it inserts a new page, each time it is executed. So, it is useful for inserting large blocks like new chapters. To inlcude chapter1.tex in our document, we say
- ::
-
- \include{chapter1}
-
-3. ``\includeonly``
+Emphasizing
+~~~~~~~~~~~
- This command is useful in restricting the ``\include`` commands that we wish to be executed. For example, if we have ``\include{chapter1}``, ``\include{chapter2}`` and ``\include{chapter3}`` in the document, but we wish to just verify the changes made to ``chapter1.tex`` and ignore the other chapters for a while, we could add the following command to the preamble.
- ::
-
- \includeonly{chapter1}
-
-A note on filenames
-+++++++++++++++++++
+*Italic* font is generally used to emphasize text. The ``\emph`` command may be used to achive this effect in LaTeX.
+::
-Never use filenames or directories that contain spaces. Make filenames as long or short as you would like, but strictly avoid spaces. Stick to upper or lower case letters (without accents), the digits, the hyphen and the full stop or period.
-
-Typesetting Text
-----------------
-
-Line and Page Breaks
-~~~~~~~~~~~~~~~~~~~~
-
-Books are often typeset with each line having the same length. LaTeX inserts the necessary line breaks and spaces between words by optimizing the con- tents of a whole paragraph. If necessary, it also hyphenates words that would not fit comfortably on a line. How the paragraphs are typeset depends on the document class.
+ This is the \emph{emphasized text}.
-In special cases it might be necessary to order LaTeX to start a newline.
-
-``\\`` or ``\newline`` starts a newline without starting a new paragraph.
-
-``\\*`` additionally prohibits a page break after the line break.
-
-[Optional material::
+If the ``\emph`` command is nested within another emphasize command, LaTeX emphasized that text using normal fonts.
+::
- \linebreak[n], \nolinebreak[n], \pagebreak[n], \nopagebreak[n]
-
- \hyphenation
+ \emph{Did you wonder what happens when we try \emph{emphasizing text} within \emph{emphasized text}}?
- \mbox
-
-]
-
-Symbols & More Special Characters
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+*This is emphasized text, and* this is emphasized text with normal font *, within* emphasized text.
Quotation Marks
-+++++++++++++++
+~~~~~~~~~~~~~~~
-You should not use the " for quotation marks as you would on a typewriter. In publishing there are special opening and closing quotation marks. In A LaTeX, use two ` (grave accent) for opening quotation marks and two ' (vertical quote) for closing quotation marks. For single quotes you use just one of each.
+When typing in LaTeX, the double quotation mark ``"`` character shouldn't be used. The grave accent ````` character produces the left quote and the apostrophe ``'`` character produces the right quote. To obtain double quotes they are, each, used twice.
::
`` Here is an example of putting `text' in quotes ''
-“ Here is an example of putting ‘text’ in quotes ”
-Need to include an image as example. ?
+Dashes and Hyphens
+~~~~~~~~~~~~~~~~~~
-Dashes and Hyphens
-++++++++++++++++++
-
-LaTeX has four kinds of dashes. Three of them can be accessed with different number of consecutive dashes. The fourth one is a mathematical symbol, the minus sign.
+LaTeX has four dashes of different lengths. Three of them can be produces with different number of consecutive dashes. The short dashes are used for hyphens, slightly longer ones for number ranges and the longest ones for comments. The fourth one is a mathematical symbol, the minus sign.
::
The names of these dashes are: `-' hyphen, `--' en-dash, `---' em-dash and `$-$' minus sign.
The names for these dashes are: ‘‐’ hyphen, ‘–’ en-dash, ‘—’ em-dash and ‘−’ minus sign.
-Tilde(~)
-++++++++
-
-A character often seen in web addresses is the tilde. To generate this in LaTeX you can use ``\~`` but the result ˜ is not really what you want. Try ``$\sim$`` instead.
-::
-
- http://www.rich.edu/\~{}bush\\
- http://www.clever.edu/$\sim$demo
-
-
-http://www.rich.edu/˜bush
-
-http://www.clever.edu/~demo
-
-Ellipsis
-++++++++
-
-On a typewriter, a comma or a period takes the same amount of space as any other letter. In book printing, these characters occupy only a little space and are set very close to the preceding letter. Therefore, you cannot enter ‘ellipsis’ by just typing three dots, as the spacing would be wrong. Instead, there is a special command for these dots. It is called ``\ldots``
-
-Emphasized Words
-~~~~~~~~~~~~~~~~
-
-If a text is typed using a typewriter, important words are emphasized by underlining them.
-::
-
- \underline{text}
-
-In printed books, however, words are emphasized by typesetting them in an *italic* font. LaTeX provides the command
-::
-
- \emph{text}
-
-to emphasize text. If you use emphasizing inside emphasized text, LaTeX uses normal font for emphasizing.
-::
-
- \emph{This is emphasized text, and \emph{this is emphasized text with normal font}, within emphasized text.}
-
-*This is emphasized text, and* this is emphasized text with normal font, *within emphasized text.*
-
-
-Cross References
-~~~~~~~~~~~~~~~~
-
-In books, reports and articles, there are often cross-references to figures, tables and special segments of text. LaTeX provides the following commands for cross referencing::
-
- \label{marker}, \ref{marker} and \pageref{marker}
-
-where ``marker`` is an identifier chosen by the user. LaTeX replaces ``\ref`` by the number of the section, subsection, figure, table, or theorem after which the corresponding ``\label`` command was issued. ``\pageref`` prints the page number of the page where the ``\label`` command occurred.
-
-As with the section titles, the numbers from the previous run are used. Therefore, to get the correct numbering, you will need to compile twice.
-
-
Footnotes
~~~~~~~~~
@@ -451,97 +314,82 @@
a footnote is printed at the foot of the current page. Footnotes should always be put after the word or sentence they refer to. Footnotes referring to a sentence or part of it should therefore be put after the comma or period.
-[optional::
-
- \marginpar - Margin notes.
-
-]
-
-
-Itemize, Enumerate, and Description
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-::
-
- \begin{enumerate}
- \item You can mix the list environments to your taste:
-
- \begin{itemize}
- \item But it might start to look silly.
- \item[-] With a dash.
- \end{itemize}
-
- \item Therefore remember:
-
- \begin{description}
- \item[Stupid] things will not become smart
- because they are in a list.
- \item[Smart] things, though, can be
- presented beautifully in a list
- \end{description}
-
- \end{enumerate}
-
-1. You can mix the list environments to your taste:
-
- * But it might start to look silly
-
- - With a dash.
-
-2. Therefore remember:
-
- **Stupid** things will not become smart because they are in a list
-
- **Smart** things, though, can be presented beautifully in a list.
-
-
+Note: Look at the ``\marginpar`` command to insert margin notes
Flushleft, Flushright, and Center
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The environments ``flushleft`` and ``flushright`` generate paragraphs that are either left- or right-aligned. The ``center`` environment generates centered text.
+The environments ``flushleft`` and ``flushright`` generate paragraphs that are either left- or right-aligned.
+
+The ``center`` environment generates centered text.
+
+Itemize, Enumerate, and Description
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+LaTeX has three different enivronments for producing lists. Itemize, Enumerate and Description allow you to produce lists of various types in LaTeX.
+
+Itemize is used to produce unnumbered lists. The bullets of the list can be easily changed to use any character. Enumerate environment allows you to produce auto-numbered lists. The description environment, allows you to produce a list of definitons. These environments can be nested within each other, easily.
+
+::
-
+ \begin{itemize}
+ \item Now we move onto some elementary \emph{Text Typesetting}.
+ \item How do we get \emph{emphasized or italic text}?
+ \item \emph{Did you wonder what happens when we try \emph{emphasizing text} within \emph{emphasized text}}?
+ \item ``Beautiful is better than ugly.''
+ \end{itemize}
+
+ \begin{description}
+ \item[Description] This list is a description list.
+ \item[Enumerate] Numbered lists are often useful.
+ \begin{enumerate}
+ \item First
+ \item Second
+ \item Third
+ \item \ldots
+ \end{enumerate}
+ \item[Itemize] The list above this description list is an itemize list.
+ \end{description}
+
Quote, Quotation, and Verse
~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The ``quote`` environment is useful for quotes, important phrases and examples.
+LaTeX provides a ``quote`` environment that can be used for quoting, highlighting important material, etc.
::
- A typographical rule of thumb for the line length is:
+ The Zen of Python
\begin{quote}
- On average, no line should
- be longer than 66 characters.
+ The Zen of Python, by Tim Peters
+
+ Beautiful is better than ugly.
+ Explicit is better than implicit.
+ Simple is better than complex.
+ Complex is better than complicated.
+ Flat is better than nested.
+ Sparse is better than dense.
+ Readability counts.
+ Special cases aren't special enough to break the rules.
+ Although practicality beats purity.
+ Errors should never pass silently.
+ Unless explicitly silenced.
+ In the face of ambiguity, refuse the temptation to guess.
+ There should be one-- and preferably only one --obvious way to do it.
+ Although that way may not be obvious at first unless you're Dutch.
+ Now is better than never.
+ Although never is often better than *right* now.
+ If the implementation is hard to explain, it's a bad idea.
+ If the implementation is easy to explain, it may be a good idea.
+ Namespaces are one honking great idea -- let's do more of those!
\end{quote}
- This is why LaTeX pages have
- such large borders by default
- and also why multicolumn print
- is used in newspapers.
-
-A typographical rule of thumb for the line length is:
-
- On average, no line should be longer than 66 characters.
-This is why LaTeX pages have such large borders by default and also why multicolumn print is used in newspapers.
-
-
-There are two similar environments: the quotation and the verse environments. The quotation environment is useful for longer quotes going over several paragraphs, because it indents the first line of each paragraph.
-
-The verse environment is useful for poems where the line breaks are important. The lines are separated by issuing a \\\\ at the end of a line and an empty line after each verse.
-
-
+LaTeX provides two other similar environments, the quotation and the verse environments.
-Abstract
-~~~~~~~~
-In scientific publications it is customary to start with an abstract which gives the reader a quick overview of what to expect. LaTeX provides the abstract environment for this purpose. Normally abstract is used in documents typeset with the article document class.
-::
+The quotation environment can be used for longer quotes which have several paragraphs, since it indents the first line of each paragraph.
- \begin{abstract}
- The abstract abstract.
- \end{abstract}
+The verse environment may be used to quote verses or poems, since the line breaks are important in quoting them. The lines are separated using ``\\\\`` at the end of a line and an empty line after each verse.
Verbatim
~~~~~~~~
-Text that is enclosed between ``\begin{verbatim}`` and ``\end{verbatim}`` will be directly printed, as if typed on a typewriter, with all line breaks and spaces, without any LaTeX command being executed.
+The verbatim environment allows us to insert pre-formatted text in a LaTeX document. It is useful for inserting code samples within the document. The verbatim text needs to be enclosed between ``\begin{verbatim}`` and ``\end{verbatim}``.
::
\begin{verbatim}
@@ -552,24 +400,12 @@
from numpy import *
a = linspace(0, 5, 50, endpoint = False)
-Within a paragraph, similar behavior can be accessed with
+To insert verbatim text inline, the ``\verb`` command can be used.
::
- \verb+text+
-
-The + is just an example of a delimiter character. You can use any character except letters, * or space.
-
-The starred verstion of the verbatim environment emphasizes the spaces in the text.
-::
+ The verb command allows placing \verb|verbatim text| inline.
- \begin{verbatim}
- from numpy import *
- a = linspace(0, 5, 50, endpoint = False)
- \end{verbatim}
-
- from␣numpy␣import␣*
- a␣=␣linspace(0,␣5,␣50,␣endpoint␣=␣False)
-
+The | is just an example of a delimiter character. You can use any character except letters, * or space.
Tables, Figures and Captions
----------------------------
@@ -577,44 +413,58 @@
The ``\tabular`` environment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The tabular environment can be used to typeset beautiful tables with optional horizontal and vertical lines. LaTeX determines the width of the columns automatically.
+The ``tabular`` environment allows you to typeset tables in LaTeX. ``\begin{tabular}[pos]{col fmt}`` command can be used to specify the parameters of the table and start creating the table.
+
+The ``pos`` argument specifies the vertical position of the table relative to the baseline of the surrounding text. It can take on the values ``t`` for top, ``b`` for bottom, or ``c`` for center.
+
+
+The ``col fmt`` argument specifies the formatting of the columns of the table. You need to explicitly specify the formatting for each of the columns in the table. The ``col fmt`` argument can take on the following values.
+
++---------------+------------------------------------+
+| ``l`` | left justified column content |
++---------------+------------------------------------+
+| ``r`` | right justified column content |
++---------------+------------------------------------+
+| ``c`` | centered column content |
++---------------+------------------------------------+
+| ``*{n}{col}`` | produces ``n`` columns with the |
+| | ``col`` type of formatting |
+| | ``*{3}{c}`` is the same as {c c c} |
++---------------+------------------------------------+
+| ``|`` | produces a vertical line. |
++---------------+------------------------------------+
+
+Now we look at how to input the actual entries of the tables. Each horizontal row in a table is separated by ``\\``. Each column entry of a row is separated by ``&``.
+
+The ``\hline`` command allows you to draw horizontal lines between two rows of the table. But it does not allow you do draw partial lines. ``\cline{a-b}`` draws a horizontal line from column ``a`` to column ``b``.
::
- \begin{tabular}[pos]{table spec}
-
-The table spec argument defines the format of the table. Use an ``l`` for a column of left-aligned text, ``r`` for right-aligned text, and ``c`` for centred text; ``p{width}`` for a column containing justified text with line breaks, and ``|`` for a vertical line.
-
-If the text in a column is too wide for the page, LaTeX won’t automatically wrap it. Using ``p{width}`` you can define a special type of column which will wrap-around the text as in a normal paragraph.
-
-The pos argument specifies the vertical position of the table relative to the baseline of the surrounding text. Use either of the letters ``t`` , ``b`` and ``c`` to specify table alignment at the top, bottom or center.
-
-Within a tabular environment, ``&`` jumps to the next column, ``\\`` starts a new line and ``\hline`` inserts a horizontal line. You can add partial lines by using the ``\cline{i-j}``, where ``i`` and ``j`` are the column numbers the line should extend over.
-
-::
-
- \begin{tabular}{|r|l|}
- \hline
- 7C0 & hexadecimal \\
- 3700 & octal \\ \cline{2-2}
- 11111000000 & binary \\
- \hline \hline
- 1984 & decimal \\
- \hline
+ \begin{tabular}{|c|c|}
+ \hline
+ \verb+l+ & left justified column content\\
+ \hline
+ \verb+r+ & right justified column content\\
+ \hline
+ \verb+c+ & centered column content\\
+ \hline
+ \verb+*{n}{col}+ & produces \verb+n+ columns with the\\
+ & \verb+col+ type of formatting\\
+ \cline{2-2}
+ &\verb+*{3}{c}+ is the same as \verb+{c c c}+ \\
+ \hline
+ \verb+|+ & produces a vertical line\\
+ \hline
\end{tabular}
-[include an image of a table, as example]
-
Importing Graphics
~~~~~~~~~~~~~~~~~~
-Strictly speaking, LaTeX cannot manage pictures directly: in order to introduce graphics within documents, LaTeX just creates a box with the same size of the image you want to include and embeds the picture, without any other processing. This means you will have to take care that the images you want to include are in the right format to be included. This is not such a hard task because LaTeX supports the most common picture formats around.
-
-We need to load the ``graphicx`` package in the preamble of the document to be able to include images.
+To include images in LaTeX, we require to use an additional package known as ``graphicx``. To load a package, we use the ``\usepackage`` directive in the preamble of the document.
::
\usepackage{graphicx}
-When compiling with ``pdflatex`` command, (which we assume is being used all through this course) you can insert **jpg**, **png** and **pdf** files.
+When compiling with ``pdflatex`` command, **jpg**, **png**, **gif** and **pdf** images can be inserted.
::
@@ -622,219 +472,111 @@
A few ``optional arguments``:
- ``width=xx``
- specify the width of the imported image to ``xx``.
-
- ``height=xx``
- specify the height of the imported image to ``xx``.
- Specifying only the width or height of the image will scale the image whilst maintaining the aspect ratio.
+ ``width=x``, ``height=x``
+ If only the height or width is specified, the image is scaled, maintaining the aspect ratio.
``keepaspectratio``
- This can be either set to true or false. When set to true, it will scale the image according to both width and height, without distorting the image so that it does not exceed both the width and the height dimensions.
+ This parameter can either be set to true or false. When set to true, the image is scaled according to both width and height, without changing the aspect ratio, so that it does not exceed both the width and the height dimensions.
+
+ ``scale=x``
+ Scale the image by a factor of ``x``. For eg. ``scale=2``, will double the image size.
- ``scale=xx``
- Scale the image by a factor of ``xx``. For eg. ``scale=2``, will double the image size.
+ ``angle=x``
+ This option can be used to rotate the image by ``x`` degrees, counter-clockwise.
- ``angle=xx``
- This option can be used to rotate the image by ``xx`` degrees, anti-clockwise.
+::
+ \includegraphics[scale=0.8, angle=30]{lion_orig.png}
Floats
~~~~~~
-Figures and Tables need special treatment, because they cannot be broken across pages. One method would be to start a new page every time a figure or a table is too large to fit on the present page. This approach would leave pages partially empty, which looks very bad.
+Tables and Figures need to be treated in a special manner, since they cannot be split over pages, and they are referred to as floats in LaTeX.
-The solution to this problem is to ‘float’ any figure or table that does not fit on the current page to a later page, while filling the current page with body text. LaTeX offers two environments for floating bodies; one for tables and one for figures. To take full advantage of these two environments it is important to understand approximately how LaTeX handles floats internally.
+When there is not enough space on a page, to fit in a table or figure, it is floated over to the next page filling up the current page with text. LaTeX has float environments called table and figure for tables and images, respectively.
-Any material enclosed in a figure or table environment will be treated as floating matter.
+Anything enclosed within the table or figure environments will be treated as floats.
::
- \begin{figure}[placement specifier] or
- \begin{table}[placement specifier]
+ \begin{figure}[pos] or
+ \begin{table}[pos]
-Both float environments support an optional parameter called the placement specifier. This parameter is used to tell LaTeX about the locations to which the float is allowed to be moved. A placement specifier is constructed by building a string of float-placing permissions.
+The ``pos`` parameter specifies the placement of the float. The possible values it can take are as follows.
+-----------+-------------------------------------------------------------------+
| Specifier | Permission |
+===========+===================================================================+
-| h | Place the float here |
-| | (approximately at the same point it occurs in the source text) |
+| h | at approximately the same place where it occurs in the source |
+-----------+-------------------------------------------------------------------+
-| t | Position at the top of the page. |
+| t | at the top of the page. |
+-----------+-------------------------------------------------------------------+
-| b | Position at the bottom of the page. |
+| b | at the bottom of the page. |
+-----------+-------------------------------------------------------------------+
-| p | Put on a special page for floats only. |
+| p | on a special page for floats only. |
+-----------+-------------------------------------------------------------------+
-| ! | Override internal parameters Latex uses for determining “good” |
-| | float positions. |
+| ! | Override LaTeX's internal parameters for good positions |
+-----------+-------------------------------------------------------------------+
-| H | Places the float at precisely the location in the LaTeX code. |
-| | Requires the float package. ``\usepackage{float}``. |
-| | This is somewhat equivalent to h! |
+| H | nearly equivalent to h! |
+-----------+-------------------------------------------------------------------+
Examples::
- \begin{table}[!hbp]
- \begin{tabular}{...}
- ... table data ...
- \end{tabular}
- \end{table}
-
- \begin{figure}[b]
- \includegraphics[scale=0.5]{image1.jpg}
+ \begin{figure}[h]
+ \centering
+ \includegraphics[scale=0.8, angle=30]{lion_orig.png}
\end{figure}
Captions
~~~~~~~~
-It is always good practice to add a caption to any figure or table. All you need to do is use the ``\caption{text}`` command within the float environment. LaTeX will automatically keep track of the numbering of figures, so you do not need to include this within the caption text.
+The ``\caption{text}`` command allows you to add captions to images or tables. LaTeX automatically numbers your tables and figures and you need not include numbers in the captions that you write. The caption appears below or on top of the image (or table), depending on whether you place it after or before the ``importgraphics`` (or ``tabular``) command.
-The location of the caption is traditionally underneath the float. However, it is up to you to therefore insert the caption command after the actual contents of the float (but still within the environment). If you place it before, then the caption will appear above the float.
::
-
- \begin{figure}[b]
- \caption{This is a caption at the top of the image}
- \includegraphics[scale=0.5]{image1.jpg}
+ \begin{figure}[h]
+ \centering
+ \includegraphics[scale=0.8]{lion_orig.png}
+ \caption{CTAN lion drawing by Duane Bibby; thanks to www.ctan.org}
\end{figure}
- \begin{figure}[b]
- \includegraphics[scale=0.5]{image1.jpg}
- \caption{This is a caption at the bottom of the image}
- \end{figure}
-
+The caption command also, like the section command, has the short caption optional parameter. The short caption will appear in the list of tables or figures.
List of Figures, Tables
~~~~~~~~~~~~~~~~~~~~~~~
-Captions can be listed in a “List of Tables” or a “List of Figures” section by using the ``\listoftables`` or ``\listoffigures`` commands, respectively. The caption used for each table or figure will appear in these lists, along with the table or figure numbers, and page numbers that they appear on.
-
-The ``\caption`` command also has an optional parameter, ``\caption[short]{long}`` which is used for the List of Tables or List of Figures. Typically the short description is for the caption listing, and the long description will be placed beside the figure or table. This is particularly useful if the caption is long, and only a “one-liner” is desired in the figure/table listing.
-
-Typesetting Math
-----------------
-
-If you wish to typset advanced mathematics, it is best to use the AMS-LaTeX bundle, which is a collection of packages and classes for mathematical typsetting. Note that LaTeX does, provide some basic features and environments for mathematical typsetting, but they are limited and in some cases even inconsistent. We shall stick to using the ``amsmath`` package from the AMS-LaTeX bundle, throughout this course.
-
-We load ``amsmath`` by issuing the ``\usepackage{amsmath}`` in the preamble. Through out this section, it is assumed that the ``amsmath`` package has been loaded.
+LaTeX can automatically generate a List of Tables or Figures, with the table or figure numbers, the captions and page numbers on which they appear. This can be done using the ``\listoftables`` or ``listoffigures`` commands.
-Math Mode
-~~~~~~~~~
-
-There are a few differences between the *math mode* and the *text mode*:
+Note: Just like table of contents, these lists also require an extra compilation.
-1. Most spaces and line breaks do not have any significance, as all spaces are either derived logically from the mathematical expressions, or have to be specified with special commands such as ``\,``, ``\quad`` or ``\qquad``
-
-2. Empty lines are not allowed.
-
-3. Each letter is considered to be the name of a variable and will be typeset as such. If you want to typeset normal text within a formula, then you have to enter the text using the \text{...} command
-
-Single Equations
+Cross References
~~~~~~~~~~~~~~~~
-There are two ways to typeset mathematical equations in LaTeX - inline within a paragraph (*text style*), or the paragraph can be broken to typeset it separately (*display style*).
-
-A mathematical equation within a paragraph is entered between ``$`` and ``$``.
-
-If you want the larger equations to be set apart from the paragraph, it is better to use the display style. To do this, you enclose the equations within ``\begin{equation}`` and ``\end{equation}``. You can then \label an equation number and refer to it somewhere else in the text by using the ``\eqref`` command. If you want to name the equation something specific, you ``\tag`` it instead. You can’t use ``\eqref`` with ``\tag``. If you donot want LaTeX to number a particular equation, use the starred version of equation using an ``\begin{equation*}`` and ``\end{equation*}``
-
-[need to include images as examples?]
-
-Building Blocks of a Mathematical Formula
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Greek Letters can are entered as ``\alpha, \beta, \gamma, \delta, ...`` for lowercase letters and ``\Alpha, \Beta, \Gamma, ...`` for uppercase ones.
-
-Exponents and Subscripts can be specified using the ^ and the _ character. Most math mode commands act only on the next character, so if you want a command to affect several characters, you have to group them together using curly braces: {...}.
-
-The square root is entered as ``\sqrt``; the nth root is generated with ``\sqrt[n]``. The size of the root sign is determined automatically by LaTeX. If just the sign is needed, use ``\surd``.
-
-To explicitly show a multiplication a dot may be shown. \cdot could be used, which typesets the dot to the centre. \cdots is three centered dots while \ldots sets the dots on the baseline. Besides that, there are \vdots for vertical and \ddots for diagonal dots.
-
-A fraction can be typeset with the command ``\frac{...}{...}``
-
-The integral operator is generated with ``\int``, the sum operator with ``\sum``, and the product operator with ``\prod``. The upper and lower limits are specified with ``^`` and ``_`` like subscripts and superscripts.
-
-If you put ``\left`` in front of an opening delimiter and ``\right`` in front of a closing delimiter, LaTeX will automatically determine the correct size of the delimiter. Note that you must close every ``\left`` with a corresponding ``\right``.
-
-
-
-Vertically Aligned Material
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Multiple Equations
-++++++++++++++++++
-
-For formulae running over several lines or for equation systems, you can use the environments ``align`` and ``align*`` instead of ``equation`` and ``equation*``. With ``align`` each line gets an equation number. The ``align*`` does not number anything.
-
-The ``align`` environments center the single equation around the ``&`` sign. The ``\\`` command breaks the lines. If you only want to enumerate some of equations, use ``\nonumber`` to remove the number. It has to be placed before the ``\\``.
-
-Arrays and Matrices
-+++++++++++++++++++
+LaTeX has a very efficient mechanism of inserting cross-references in documents.
-To typset arrays, use the ``array`` environment. It works similar to the ``tabular`` environment. The ``\\`` command is used to break the lines.
-::
-
- \begin{equation*}
- \mathbf{X} = \left(
- \begin{array}{ccc}
- x_1 & x_2 & \ldots \\
- x_3 & x_4 & \ldots \\
- \vdots & \vdots & \ddots
- \end{array} \right)
- \end{equation*}
-
-The ``array`` environment can also be used to typeset piecewise functions by using a “.” as an invisible ``\right`` delimiter
-::
+The command ``\label{name}`` is used to label figures, tables or segments of text. ``\ref{name}`` refers to the object marked by the ``name`` by it's numbering (figure, table, section etc.) ``\pageref{name}`` gives the page number of the object which has been labeled with ``name``.
- \begin{equation*}
- |x| = \left\{
- \begin{array}{rl}
- -x & \text{if } x < 0\\
- 0 & \text{if } x = 0\\
- x & \text{if } x > 0
- \end{array} \right.
- \end{equation*}
-
-The ``array`` environment can be used for typesetting matrices also, but ``amsmath`` provides a better solution using the different matrix environments. There are six versions with different delimiters: ``matrix`` (none), ``pmatrix`` (, ``bmatrix`` [, ``Bmatrix`` {, ``vmatrix`` | and ``Vmatrix`` ‖. The number of columns need not be specified, unlike the ``array`` environment.
-::
-
- \begin{equation*}
- \begin{matrix}
- 1 & 2 \\
- 3 & 4
- \end{matrix} \qquad
-
- \begin{bmatrix}
- 1 & 2 & 3 \\
- 4 & 5 & 6 \\
- 7 & 8 & 9
- \end{bmatrix}
- \end{equation*}
-
+Note: Cross referencing also requires an extra compilation, like table of contents.
Bibliography
------------
-As mentioned previously, you can either use the ``thebibliography`` environment to include your references in the main document file itself, or use BibTeX to generate a database of references and keep using them as and when required. We shall first look at how we can include the reference items within our document itself.
+Bibliography or references can be added to LaTeX documents in two ways - using the ``thebibliography`` environment, or using BibTeX. Let's first look at using the ``\thebibliography`` environment and then move on to BibTeX.
``thebibliography`` environment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-To use the thebibliography environment, you simply list down all the bibliography items within the bibliography environment as shown below.
+Writing bibliographies in LaTeX using the ``thebibliography`` environment is pretty easy. You simply have to list down all the bibliography items within the bibliography environment.
+
+Each entry of the bibliography begins with the command ``\bibitem[label]{name}``. The name is used to cite the bibliography item within the document using ``\cite{name}``. The label option replaces the numbers from the auto enumeration with the labels given.
+::
-Each item starts with ``\bibitem[label]{marker}``. The marker is then used to cite the bibliography item within the document, using ``\cite{marker}``. If the ``label`` option is not used, the bibliography items get enumerated automatically.
-::
+ He used this lion in the illustrations for D Knuth's original TeXbook\cite{DKnuth}, for L Lamport's LaTeX book\cite{LLamport}
+
+ \begin{thebibliography}{99}
+ \bibitem{DKnuth} Donald E. Knuth (1984). \emph{The TeXbook} (Computers and Typesetting, Volume A). Reading, Massachusetts: Addison-Wesley. ISBN 0-201-13448-9.
- Lamport's \cite{WBook} book is a good reference for LaTeX.
-
- \begin{thebibliography}{99}
-
- \bibitem{WBook} Lamport, Leslie (1994). \emph{LaTeX: A document preparation system: User's guide and reference}.
+ \bibitem{LLamport} Lamport, Leslie (1994). \emph{LaTeX: A document preparation system: User's guide and reference}.
illustrations by Duane Bibby (2nd ed.). Reading, Mass: Addison-Wesley Professional.
-
\end{thebibliography}
The ``99`` in the example above indicates the maximum width of the label that the references may get. We here assume that the number of Bibliography items will be less than 100. If your document has less than 10 references, you may want to replace ``99`` with ``9``.
@@ -842,9 +584,9 @@
BibTeX
~~~~~~
-The previous section detailed the process of embedding the references at the end of the document's source file and using the ``\cite`` command to cite them. In this section we shall use the BibTeX environment for references.
+The previous section explained the process of listing references at the end of a document and embedding cross references. In this section let us explore the BibTeX environment for keeping track of references.
-Using BibTeX you can create a database of all your references in a text file and cite the appropriate ones in each document. This method is much more convinient than writing down all the references for each document at the end of it, when you are writing multiple documents in a field.
+Using BibTeX is a very convenient method to use, when writing multiple documents in a single area or field. BibTeX allows you to create a database of all your references and use them as and when required.
The BibTeX database is stored in a ``.bib`` file. The structure of the file is quite simple and an example is shown below.
::
@@ -854,7 +596,7 @@
title = "A Document Preparation System: User's Guide and Reference",
publisher = "Addison-Wesley Professional",
year = "1994",
- edtion = "second",
+ edition = "second",
note = "illustrations by Duane Bibby"
}
@@ -877,13 +619,185 @@
Compiling
+++++++++
-Adding BibTeX based references, slightly complicates the process of coompiling the document to obtain the desired output. The exact workings of LaTeX and BibTeX will not be explained here. The procedure for obtaining the output (without any explanations) is as follows:
+Adding BibTeX based references, slightly complicates the process of compiling the document to obtain the desired output. The exact workings of LaTeX and BibTeX will not be explained here. The procedure for obtaining the output (without any explanations) is as follows:
1. Compile the ``.tex`` file using ``pdflatex`` - ``$pdflatex LaTeX(.tex)``
2. Compile the ``.bib`` file using ``bibtex`` - ``$bibtex LaTeX(.bib)``
3. Compile the ``.tex`` file again.
4. Compile the ``.tex`` file for one last time!
+Typesetting Math
+----------------
+
+It is advisable to use the AMS-LaTeX bundle to typeset mathematics in LaTeX. It is a collection of packages and classes for mathematical typesetting.
+
+We load ``amsmath`` by issuing the ``\usepackage{amsmath}`` in the preamble. Through out this section, it is assumed that the ``amsmath`` package has been loaded.
+
+
+Math Mode
+~~~~~~~~~
+
+There are a few differences between the *math mode* and the *text mode*:
+
+1. Most spaces and line breaks do not have any significance, as all spaces are either derived logically from the mathematical expressions, or have to be specified with special commands such as ``\``, ``\quad`` or ``\qquad``
+
+2. Empty lines are not allowed.
+
+3. Each letter is considered to be the name of a variable and will be typeset as such. If you want to typeset normal text within a formula, then you have to enter the text using the \text{...} command
+
+Single Equations
+~~~~~~~~~~~~~~~~
+
+Mathematical equations can be inserted in-line within a paragraph (*text style*), or the paragraph can be broken to typeset it separately (*display style*).
+
+A mathematical equation within a paragraph is entered between ``$`` and ``$``. Larger equations are set apart from the paragraph, by enclosing them within ``\begin{equation}`` and ``\end{equation}``. If you don't wish to number a particular equation, the starred version of equation can be used. ``\begin{equation*}`` and ``\end{equation*}``
+
+The equation can also be cross referenced using the ``\label`` and ``\eqref`` commands.
+
+Basic Elements
+~~~~~~~~~~~~~~
+
+Greek Letters can are entered as ``\alpha, \beta, \gamma, \delta, ...`` for lowercase letters and ``\Alpha, \Beta, \Gamma, ...`` for uppercase ones.
+
+Exponents and subscripts can be typeset using the carat ``^`` and the underscore ``_`` respectively. Most of the math mode commands act only on the next character. If you want a command to affect several characters, they need to be enclosed in curly braces.
+
+The ``\sqrt`` command is used to typeset the square root symbol. LaTeX of the root sign is determined automatically. The nth root is generated with ``\sqrt[n]``.
+
+To explicitly show a multiplication a dot may be shown. ``\cdot`` could be used, which typesets the dot to the centre. ``\cdots`` is three centered dots while ``\ldots`` sets the dots on the baseline. Besides that ``\vdots`` for vertical and ``\ddots`` can be used for diagonal dots.
+
+A fraction can be typeset with the command ``\frac{..}{..}``
+
+The integral operator is generated with ``\int``, the sum operator with ``\sum``, and the product operator with ``\prod``. The upper and lower limits are specified with ``^`` and ``_`` like subscripts and superscripts.
+
+LaTeX provides all kinds of braces as delimiters. The round and square brackets can be produces using the keys on the keyboard and appending a backslash. Other delimiters can be produced using special commands of LaTeX. Placing ``\left`` in front of an opening delimiter and ``\right`` in front of a closing delimiter, instructs LaTeX to automatically take care of the sizes of the delimiters.
+
+Multiple Equations
+~~~~~~~~~~~~~~~~~~
+
+Long formulae that run over several lines or equation systems, can be typeset using the ``align`` or ``align*`` environments. ``align`` numbers each of the lines in the environment, and ``align*`` as expected, does not number any of them.
+
+The ``&`` is used to align the equations vertically and the ``\\`` command is used to break the lines. Line numbering can be skipped for a particular line in the ``align`` environment by placing a ``\nonumber`` before the line break.
+
+::
+
+ \begin{align}
+ \alpha^2 + \beta^2 &= \gamma^2 \\
+ \sum_{i=1}^ni &= \frac{n(n+1)}{2}\\
+ \sqrt{-1} &= \pm1 \nonumber
+ \end{align}
+
+
+Arrays and Matrices
+~~~~~~~~~~~~~~~~~~~
+
+To typset arrays, use the ``array`` environment. It works similar to the ``tabular`` environment. The ``\\`` command is used to break the lines.
+::
+
+ \begin{equation*}
+ \mathbf{X} = \left(
+ \begin{array}{ccc}
+ a_1 & a_2 & \ldots \\
+ b_1 & b_2 & \ldots \\
+ \vdots & \vdots & \ddots
+ \end{array} \right)
+ \end{equation*}
+
+The ``array`` environment can also be used to typeset piecewise functions by using a “.” as an invisible ``\right`` delimiter
+::
+
+ \begin{equation*}
+ f(x) = \left\{
+ \begin{array}{rl}
+ 0 & \text{if } x \le 0\\
+ 1 & \text{if } x > 0
+ \end{array} \right.
+ \end{equation*}
+
+Six different types of matrix environments are available in the ``amsmath`` package for typesetting matrices. They essentially have different delimiters: ``matrix`` (none), ``pmatrix`` (, ``bmatrix`` [, ``Bmatrix`` {, ``vmatrix`` | and ``Vmatrix`` ‖. In these matrix environments, the number of columns need not be specified, unlike the ``array`` environment.
+::
+
+ \begin{equation*}
+ \begin{matrix}
+ 1 & 2 \\
+ 3 & 4
+ \end{matrix} \qquad
+
+ \begin{bmatrix}
+ 1 & 2 & 3 \\
+ 4 & 5 & 6 \\
+ 7 & 8 & 9
+ \end{bmatrix}
+ \end{equation*}
+
+Miscellaneous Stuff
+-------------------
+
+Presentations
+~~~~~~~~~~~~~
+
+LaTeX has quite a few options to produce presentation slides. We shall look at the ``beamer`` class, which is well developed and easy to use. We shall only briefly look at some of the features of beamer. For the best documentation, look at the beamer user guide.
+
+To write a ``beamer`` presentation, it is recommended that you use one of the templates that beamer provides. We shall use the ``speaker_introduction`` template to get started with beamer.
+
+As you can see, the document begins with the ``documentclass`` being set to beamer.
+
+The ``\setbeamertemplate`` command sets the template for various parameters. The ``background canvas``, ``headline`` and ``footline`` are being set using the command.
+
+``\usetheme`` command sets the theme to be used in the presentation.
+
+Notice that each slide is enclosed within ``\begin{frame}`` and ``\end{frame}`` commands. The ``\begin{frame}`` command can be passed the Title and Subtitle of the slide as parameters.
+
+To achieve more with beamer, it is highly recommended that you look at the ``beameruserguide``.
+
+Including Code
+~~~~~~~~~~~~~~
+
+The ``listings`` package can be used to embed source code into your LaTeX document. We shall briefly explore inserting python code into our document.
+
+Obviously, you first need to tell LaTeX that you want it to use the ``listings`` package, using the ``\usepackage`` command.
+::
+
+ \usepackage{listings}
+
+Then, we tell LaTeX that we are going to embed Python code into this document. A simple code highlighting for Python code can be achieved using this.
+::
+
+ \lstset{language=Python,
+ showstringspaces=false,
+ }
+
+You might want to customize the code highlighting further using other variables like ``basicstyle``, ``commentstyle``, ``stringstyle``, ``keywordstyle`` etc. For detailed information on all this, you should look at the ``listings`` package documentation.
+
+You include a block of code into your document by enclosing it within the ``lstlisting`` environment.
+::
+
+ \begin{lstlisting}
+ string="Hello, World! "
+ for i in range(10):
+ print string*i
+ \end{lstlisting}
+
+You can also include source code files directly into your latex document, using the ``lstinputlisting`` command.
+::
+
+ \lstinputlisting[lastline=20]{lstexample.py}
+
+This command includes the first 20 lines of the file ``lstexample.py`` into out LaTeX document.
+
+Including files
+~~~~~~~~~~~~~~~
+When working on a large document, it is convinient sometimes, to split the large file into smaller input files and club them together at the time of compiling.
+
+The ``\input`` or ``\include`` commands may be used to embed one LaTeX file into another. The ``\input`` command is equivalent to a copy and paste of the document, just before the compilation. The ``\include`` command is exactly similar, except for the fact that it creates a new page every time it is issued.
+
+``\input{file}`` or ``\include{file}`` commands will include the file ``file1.tex`` with in the file where the command has been issued. Note that you do not need to specify the ``.tex`` extension of the file.
+
+The ``\includeonly`` is useful for debugging or testing the LaTeX document that you are creating, since it restricts the ``\include`` command. Only the files which are given as arguments to the ``\includeonly`` command will be included in the document (wherever a ``\include`` command for those files, has been issued).
+
+A note on filenames
++++++++++++++++++++
+
+Never use filenames or directories that contain spaces. Make filenames as long or short as you would like, but strictly avoid spaces. Stick to upper or lower case letters (without accents), the digits, the hyphen and the full stop or period.
--------------------------------------------------------
@@ -892,5 +806,12 @@
1. *LaTeX Wikibook*
-2. *The Not So Short Introduction to LaTeX2e* by Tobias Oetikar et. al.
+2. *The Not So Short Introduction to LaTeX2e* by Tobias Oetikar et al..
+
+3. http://www.ctan.org/tex-archive/info/l2tabu/english/
+.. LocalWords: LaTeX WYSIWG WYSIWM pdf
+
+
+
+
