Addcontentsline Toc Chapter Number Line Bibliography Page

The main point of writing a text is to convey ideas, information, or knowledge to the reader. The reader will understand the text better if these ideas are well-structured, and will see and feel this structure much better if the typographical form reflects the logical and semantic structure of the content.

LaTeX is different from other typesetting systems in that you just have to tell it the logical and semantical structure of a text. It then derives the typographical form of the text according to the “rules” given in the document class file and in various style files. LaTeX allows users to structure their documents with a variety of hierarchical constructs, including chapters, sections, subsections and paragraphs.

Global structure[edit]

When LaTeX processes an input file, it expects it to follow a certain structure. Thus every input file must contain the commands

\documentclass{...}\begin{document} ... \end{document}

The area between and is called the preamble. It normally contains commands that affect the entire document.

After the preamble, the text of your document is enclosed between two commands which identify the beginning and end of the actual document:

\begin{document} ... \end{document}

You would put your text where the dots are. The reason for marking off the beginning of your text is that LaTeX allows you to insert extra setup specifications before it (where the blank line is in the example above: we'll be using this soon). 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 in the knowledge that LaTeX will never try to typeset them:

Preamble[edit]

Document classes[edit]

When processing an input file, LaTeX needs to know which layout standard to use. Layouts standards are contained within 'class files' which have .cls as their filename extension.

\documentclass[options]{class}

Here, the parameter for the command specifies the .cls file to use for the document. It is recommended to put this declaration at the very beginning. The LaTeX distribution provides additional classes for other layouts, including letters and slides. It is also possible to create your own, as is often done by journal publishers, who simply provide you with their own class file, which tells LaTeX how to format your content. But we'll be happy with the standard article class for now. The parameter customizes the behavior of the document class. The options have to be separated by commas.

Example: an input file for a LaTeX document could start with the line

\documentclass[11pt,twoside,a4paper]{article}

which instructs LaTeX to typeset the document as an article with a base font size of 11 points, and to produce a layout suitable for double sided printing on A4 paper.

Here are some document classes that can be used with LaTeX:

articleFor articles in scientific journals, presentations, short reports, program documentation, invitations, ...
IEEEtranFor articles with the IEEE Transactions format.
procA class for proceedings based on the article class.
reportFor longer reports containing several chapters, small books, thesis, ...
bookFor real books.
slidesFor slides. The class uses big sans serif letters.
memoirFor changing sensibly the output of the document. It is based on the book class, but you can create any kind of document with it [1]
letterFor writing letters.
beamerFor writing presentations (see LaTeX/Presentations).

The generic document classes that come with LaTeX offer some layout flexibility, which is why they have a lot of options in common. Non-generic classes (those provided by university departments or publication houses) may have different options than those shown below or no options at all. Normally, third-party classes come with their own documentation. The most common options for the generic document classes are listed in the following table:

10pt, 11pt, 12ptSets 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; However, many European distributions of TeX now come pre-set for A4, not Letter, and this is also true of all distributions of pdfLaTeX. Besides that, a5paper, b5paper, executivepaper, and legalpaper can be specified.
fleqnTypesets displayed formulas left-aligned instead of centered.
leqnoPlaces the numbering of formulas on the left hand side instead of the right.
titlepage, notitlepageSpecifies 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.
twocolumnInstructs LaTeX to typeset the document in two columns instead of one.
twoside, onesideSpecifies whether double or single sided output should be generated. The classes article and report are single sided and the book class is double sided by default. Note that this option concerns the style of the document only. The option twoside does not tell the printer you use that it should actually make a two-sided printout.
landscapeChanges the layout of the document to print in landscape mode.
openright, openanyMakes 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.
draftmakes LaTeX indicate hyphenation and justification problems with a small square in the right-hand margin of the problem line so they can be located quickly by a human. It also suppresses the inclusion of images and shows only a frame where they would normally occur.

For example, if you want a report to be in 12pt type on A4, but printed one-sided in draft mode, you would use:

\documentclass[12pt,a4paper,oneside,draft]{report}

Packages[edit]

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, colored text or source code from a file into your document, you need to enhance the capabilities of LaTeX. Such enhancements are called packages. Some packages come with the LaTeX base distribution. Others are provided separately. Modern TeX distributions come with a large number of packages pre-installed. The command to use a package is pretty simple: :

\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. For example, to use the color package, which lets you typeset in colors, you would type:

\documentclass{report}\usepackage{color}\begin{document} ... \end{document}

You can pass several options to a package, each separated by a comma.

\usepackage[option1,option2,option3]{''package_name''}

The document environment[edit]

Top matter[edit]

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 command) you are likely to encounter the term within LaTeX documentation.

A simple example:

\documentclass[11pt,a4paper]{report}\begin{document}\title{How to Structure a LaTeX Document}\author{Andrew Roberts}\date{December 2004}\maketitle\end{document}

The , , and commands are self-explanatory. You put the title, author name, and date in curly braces after the relevant command. The title and author are usually compulsory (at least if you want LaTeX to write the title automatically); if you omit the command, LaTeX uses today's date by default. You always finish the top matter with the command, which tells LaTeX that it's complete and it can typeset the title according to the information you have provided and the class (style) you are using. If you omit , the title will never be typeset.


Using this approach, you can only create a title with a fixed layout. If you want to create your title freely, see the Title Creation section. You should remember, however, that the goal of LaTeX is to leave formatting to the documentclass designer, and if you wish to submit your work to multiple publishers then you should avoid designing a custom title.

Abstract[edit]

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 classes article and report, but not book.

\documentclass{article}\begin{document}\begin{abstract} Your abstract goes here... ... \end{abstract} ... \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 before you begin the abstract environment:

\renewcommand{\abstractname}{Executive Summary}

Sectioning commands[edit]

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. Here are some of the structure commands found in simple.tex.

\chapter{Introduction} This chapter's content... \section{Structure} This section's content... \subsection{Top Matter} This subsection's content... \subsubsection{Article Information} This subsubsection's content...

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 use and commands to indicate which content belongs to a given block.

LaTeX provides 7 levels of depth for defining sections (see table below). Each section in this table is a subsection of the one above it.

CommandLevelComment
-1not in letters
0only books and reports
1not in letters
2not in letters
3not in letters
4not in letters
5not in letters

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[Effect on staff turnover]{An analysis of the effect of the revised recruitment policies on staff turnover at divisional headquarters}

Section numbering[edit]

Numbering of the sections is performed automatically by LaTeX, so don't bother adding them explicitly, just insert the heading you want between the curly braces. Parts get roman numerals (Part I, Part II, etc.); chapters and sections get decimal numbering like this document, and appendices (which are just a special case of chapters, and share the same structure) are lettered (A, B, C, etc.).

You can change the depth to which section numbering occurs, so you can turn it off selectively. By default it is set to 3. If you only want parts, chapters, and sections numbered, not subsections or subsubsections etc., you can change the value of the secnumdepthcounter using the command, giving the depth level you wish. For example, if you want to change it to "1":

\setcounter{secnumdepth}{1}

A related counter is tocdepth, which specifies what depth to take the Table of Contents to. It can be reset in exactly the same way as secnumdepth. For example:

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 to 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.

If you want the unnumbered section to be in the table of contents anyway, use package unnumberedtotoc[1]. It provides the command

which will take care of a proper header as well. and are also available. KOMA classes provide those commands by default.

If you don't want to use package unnumberedtotoc, you have to do everything by hand using and (or even ).

\section*{Introduction}\markright{}\addcontentsline{toc}{section}{Introduction}

Note that if you use PDF bookmarks you will need to add a phantom section so that hyperlinks will lead to the correct place in the document. The command is defined in the hyperref package, and is Commonly used like this:

\phantomsection\addcontentsline{toc}{section}{Introduction}\section*{Introduction}

For chapters you will also need to clear the page (this will also correct page numbering in the ToC):

\clearpage%or \cleardoublepage\phantomsection\addcontentsline{toc}{chapter}{List of Figures}\listoffigures

Section number style[edit]

See Counters.

Ordinary paragraphs[edit]

Paragraphs of text come after section headings. Simply type the text and leave a blank line between paragraphs. The blank line means "start a new paragraph here": it does not mean you get a blank line in the typeset output. For formatting paragraph indents and spacing between paragraphs, refer to the Paragraph Formatting section.

Table of contents[edit]

All auto-numbered headings get entered in the Table of Contents (ToC) automatically. You don't have to print a ToC, but if you want to, just add the command at the point where you want it printed (usually after the Abstract or Summary).

Entries for the ToC are recorded each time you process your document, and reproduced 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.

The commands and work in exactly the same way as to automatically list all your tables and figures. If you use them, they normally go after the command. The command normally shows only numbered section headings, and only down to the level defined by the tocdepth counter, but you can add extra entries with the command. For example if you use an unnumbered section heading command to start a preliminary piece of text like a Foreword or Preface, you can write:

\subsection*{Preface}\addcontentsline{toc}{subsection}{Preface}

This will format an unnumbered ToC entry for "Preface" in the "subsection" style. You can use the same mechanism to add lines to the List of Figures or List of Tables by substituting lof or lot for toc. If the hyperref package is used and the link does not point to the correct chapter, the command in combination with or can be used (see also Labels and Cross-referencing):

\cleardoublepage\phantomsection\addcontentsline{toc}{chapter}{List of Figures}\listoffigures

To change the title of the ToC, you have to paste this command in your document preamble. The List of Figures (LoF) and List of Tables (LoT) names can be changed by replacing the with for LoF and for LoT.

Depth[edit]

The default ToC will list headings of level 3 and above. To change how deep the table of contents displays automatically the following command can be used in the preamble:

This will make the table of contents include everything down to paragraphs. The levels are defined above on this page. Note that this solution does not permit changing the depth dynamically.

You can change the depth of specific section type, which could be useful for PDF bookmarks (if you are using the hyperref package) :

\makeatletter\renewcommand*{\toclevel@chapter}{-1}% Put chapter depth at the same level as \part.\chapter{Epilogue}\renewcommand*{\toclevel@chapter}{0}% Put chapter depth back to its default value.\makeatother

In order to further tune the display or the numbering of the table of contents, for instance if the appendix should be less detailed, you can make use of the tocvsec2 package (CTAN, doc).

Book structure[edit]

The standard LaTeX book class follows the same layout described above with some additions. By default a book will be two-sided, i.e. left and right margins will change according to the page number parity. Furthermore current chapter and section will be printed in the header.

If you do not make use of chapters, it is barely useful to use the book class.

Additionally the class provides macros to change the formatting of some places of the document. We will give you some advice on how to use them properly.[2]

\begin{document}\frontmatter\maketitle% Introductory chapters\chapter{Preface}% ...\mainmatter\chapter{First chapter}% ...\appendix\chapter{First Appendix}\backmatter\chapter{Last note}
  • The frontmatter chapters will not be numbered. Page numbers will be printed in roman numerals. Frontmatter is not supposed to have sections, so they will be numbered because there is no chapter numbering. Check the Counters chapter for a fix.
  • The mainmatter chapters works as usual. The command resets the page numbering. Page numbers will be printed in arabic numerals.
  • The macro can be used to indicate that following sections or chapters are to be numbered as appendices. Appendices can be used for the article class too:
\appendix\section{First Appendix}

Only use the macro once for all appendices.

  • The backmatter behaves like the frontmatter. It has the same issue with section numbering.

As a general rule you should avoid mixing the command order. Nonetheless all commands are optional, so you might consider using only a few.

Note that the special content like the table of contents is considered as an unnumbered chapter.

Page order[edit]

This is one traditional page order for books.

Frontmatter
  1. Half-title
  2. Empty
  3. Title page
  4. Information (copyright notice, ISBN, etc.)
  5. Dedication if any, else empty
  6. Table of contents
  7. List of figures (can be in the backmatter too)
  8. Preface chapter
Mainmatter
  1. Main topic
Appendix
  1. Some subordinate chapters
Backmatter
  1. Bibliography
  2. Glossary / Index

Special pages[edit]

Comprehensive papers often feature special pages at the end, like indices, glossaries and bibliographies. Since this is quite a complex topic, we will give you details in the dedicated part Special Pages.

Bibliography[edit]

Any good research paper will have a complete list of references. LaTeX has two ways of inserting your references into a document:

  • you can embed them within the document 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 books.
  • you can store them in an external BibTeX file and then link them via a command to your current document and use a Bibtex style to define how they appear. This way you can create a small database of the references you might use and simply link them, letting LaTeX work for you.

To learn how to add a bibliography to your document, see the Bibliography Management section.

Notes and references[edit]

LaTeX supports bibliographies out of the box, either embedding the references in your document or storing them in an external file. This article explains how to manage bibliography with the environment and the BibTeX system.

Note: If you are starting from scratch it's recommended to use biblatex since that package provides localization in several languages, it's actively developed and makes bibliography management easier and more flexible.

[edit]Introduction

Standard bibliography commands in LaTeX have a similar syntax to that of lists and items.

\begin{thebibliography}{9}\bibitem{latexcompanion} Michel Goossens, Frank Mittelbach, and Alexander Samarin. \textit{The \LaTeX\ Companion}. Addison-Wesley, Reading, Massachusetts, 1993.   \bibitem{einstein} Albert Einstein. \textit{Zur Elektrodynamik bewegter K{\"o}rper}. (German) [\textit{On the electrodynamics of moving bodies}]. Annalen der Physik, 322(10):891–921, 1905.   \bibitem{knuthwebsite} Knuth: Computers and Typesetting, \\\texttt{http://www-cs-faculty.stanford.edu/\~{}uno/abcde.html}\end{thebibliography}

The environment produces a list of references; such list will be titled "References" in a article document class, and "Bibliography" in book and report document classes. A parameter inside braces, in the example, indicates the number of entries to be added; this parameter can not be greater than 99.

To create a bibliography entry the command is used. A parameter inside braces is set to label this entry and can later be used as identifier for this reference. After the closing brace the text with the name of the author, the book title, publisher and so on is entered.

ShareLaTeX provides several templates with pre-defined styles to manage bibliography. See this link

  Open an example in ShareLaTeX

[edit]Embedded system

The example presented in the introduction only contains list of references, the next example shows how to cite the entries of that list within the document.

\begin{document}   \section{First section}   This document is an example of \texttt{thebibliography} environment using in bibliography management. Three items are cited: \textit{The \LaTeX\ Companion} book \cite{latexcompanion}, the Einstein journal paper \cite{einstein}, and the Donald Knuth's website \cite{knuthwebsite}. The \LaTeX\ related items are \cite{latexcompanion,knuthwebsite}.   \medskip   \begin{thebibliography}{9}\bibitem{latexcompanion} Michel Goossens, Frank Mittelbach, and Alexander Samarin. \textit{The \LaTeX\ Companion}. Addison-Wesley, Reading, Massachusetts, 1993.   \bibitem{einstein} Albert Einstein. \textit{Zur Elektrodynamik bewegter K{\"o}rper}. (German) [\textit{On the electrodynamics of moving bodies}]. Annalen der Physik, 322(10):891–921, 1905.   \bibitem{knuthwebsite} Knuth: Computers and Typesetting, \\\texttt{http://www-cs-faculty.stanford.edu/\~{}uno/abcde.html}\end{thebibliography}   \end{document}

The command insert the number corresponding to the bibliography entry whose label is passed inside braces. For example, the output of is [2].

The information printed by the command depends on the bibliography style used. See Bibtex bibliography styles.

  Open an example in ShareLaTeX

[edit]Bibliography management with Bibtex

BibTeX is a widely used bibliography management tool in LaTeX, with BibTeX the bibliography entries are kept in a separate file and then imported into the main document.

Once the external bibliography file is imported, the command is used just as in the introductory example.

Ths document is an example of BibTeX using in bibliography management. Three items are cited: \textit{The \LaTeX\ Companion} book \cite{latexcompanion}, the Einstein journal paper \cite{einstein}, and the Donald Knuth's website \cite{knuthwebsite}. The \LaTeX\ related items are \cite{latexcompanion,knuthwebsite}.   \medskip   \bibliographystyle{unsrt}\bibliography{sample}

This uses the following commands:

Imports the BibTeX file "sample.bib" to display the bibliography. To import several .bib files just write them comma-separated inside the braces, the file extension is not necessary.
Sets the bibliography style to be used in this document. The information displayed depends on the bibliography style used, even if the entry contains information about the date, author, title, publisher, and abstract, the style used might only print the title and the author. See Bibtex bibliography styles which contains examples of the default bibliography styles in LaTeX.
This will print a number of text, depending on the bibliography style, to reference the bibliography entry whose label is passed to the command. In this case, the label produces [2].

When the main document is compiled, a .bbl file is generated from the .bib file. This is simply a .tex file reorganising the information in the .bib file in a environment, as above. On ShareLaTeX the .bbl file is stored in the cache, and you can download it from the list of other logs and files.

Note: Unicode characters are not supported on BibTeX. Also, if there are too many bibliography entries (+100) it may not work properly. See the further reading section for links to other bibliography management tools.

  Open an example of the bibtex package in ShareLaTeX

[edit]The bibliography file

Bibliographic references are usually kept in a bibliography file whose extension is .bib, this file consists of a list of records and fields. Each bibliography record holds relevant information for a single entry.

This file contains records in a special format, for instance, the first bibliographic reference is defined by:

This is the first line of a record entry, denotes the entry type and tells BibTeX that the information stored here is about an article. Besides the entry types shown in the example (, and ) there are a lot more, see the reference guide.
The label is assigned to this entry, is an identifier that can be used to refer this article within the document.
This is the first field in the bibliography entry, indicates that the author of this article is Albert Einstein. Several comma-separated fields can be added using the same syntax , for instance: title, pages, year, URL, etc. See the reference guide for a list of possible fields.

The information in this file can later be used within a LaTeX document to include these references, as shown in the next subsection.

  Open an example of the bibtex package in ShareLaTeX

[edit]Adding the bibliography in the table of contents

There are two ways of including the bibliography in the table of contents, either manually adding it or using the package tocbibind (recommended).

To add it manually just insert the next line right before the command or


for books and reports or


for articles. If you prefer to use tocbibind see the next example.

\documentclass[a4paper,10pt]{article}\usepackage[utf8]{inputenc}\usepackage[english]{babel}   \usepackage[nottoc]{tocbibind}   \begin{document}   \tableofcontents   \section{First Section} This document ...   \bibliographystyle{unsrt}\bibliography{sample}   \end{document}

Adding the line


to the preamble will print the "References" or "Bibliography" in the table of contents, depending on the document type. Be careful, it will also add other elements like the Index, Glossary and list of Listings to the table of contents. For more information see [the tocbibind package documentation].

  Open an example of the bibtex package in ShareLaTeX

[edit]Reference guide

Standard entry types

Article from a magazine or journal
A published book
A work that is printed but have no publisher or sponsoring institution
An article in a conference proceedings
A part of a book (section, chapter and so on)
A part of a book having its own title
An article in a conference proceedings
Technical documentation
A Master's thesis
Something that doesn't fit in any other type
A PhD thesis
The same as
Report published by an institution
Document not formally published, with author and title


Most common fields used in BibTeX

address annote author
booktitle chapter crossref
edition editor institution
journal key month
note number organization
pages publisher school
series title type
volume year URL
ISBN ISSN LCCN
abstract keywords price
copyright language contents

[edit]Further reading

For more information see:

@article{einstein, author = "Albert Einstein", title = "{Zur Elektrodynamik bewegter K{\"o}rper}. ({German}) [{On} the electrodynamics of moving bodies]", journal = "Annalen der Physik", volume = "322", number = "10", pages = "891--921", year = "1905", DOI = "http://dx.doi.org/10.1002/andp.19053221004" }   @book{latexcompanion, author = "Michel Goossens and Frank Mittelbach and Alexander Samarin", title = "The \LaTeX\ Companion", year = "1993", publisher = "Addison-Wesley", address = "Reading, Massachusetts" }   @misc{knuthwebsite, author = "Donald Knuth", title = "Knuth: Computers and Typesetting", url = "http://www-cs-faculty.stanford.edu/\~{}uno/abcde.html" }
\addcontentsline{toc}{chapter}{Bibliography}
\addcontentsline{toc}{section}{References}
\usepackage[nottoc]{tocbibind}

0 thoughts on “Addcontentsline Toc Chapter Number Line Bibliography Page”

    -->

Leave a Comment

Your email address will not be published. Required fields are marked *