Synopsis, one of:
\chapter{title} \chapter*{title} \chapter[toc-title]{title}
Start a chapter. The standard LaTeX classes book
and report
have this command but article
does not.
This produces a chapter.
\chapter{Loomings} Call me Ishmael. Some years ago---never mind how long precisely---having little or no money in my purse, and nothing particular to interest me on shore, I thought I would sail about a little and see the watery part of the world.
The LaTeX default starts each chapter on a fresh page, an odd-numbered page if the document is two-sided. It produces a chapter number such as ‘Chapter 1’ in large boldface type (the size is \huge
). It then puts title on a fresh line, in boldface type that is still larger (size \Huge
). It also increments the chapter
counter, adds an entry to the table of contents (see Table of contents etc.), and sets the running header information (see Page styles).
The *
form shows title on a fresh line, in boldface. But it does not show the chapter number, does not increment the chapter
counter, produces no table of contents entry, and does not affect the running header. (If you use the page style headings
in a two-sided document then the header will be from the prior chapter.) This example illustrates.
\chapter*{Preamble}
The optional argument toc-title will appear as the chapter title in the table of contents (see Table of contents etc.) and in running headers (see Page styles). If it is not present then title will be there. This shows the full name in the chapter title,
\chapter[Weyl]{Hermann Klaus Hugo (Peter) Weyl (1885--1955)}
but only ‘Weyl’ on the contents page. This puts a line break in the title but that doesn’t work well with running headers so it omits the break in the contents
\chapter[Given it all; my story]{Given it all\\ my story}
For determining which sectional units are numbered and which appear in the table of contents, the level number of a chapter is 0 (see Sectioning/secnumdepth and see Sectioning/tocdepth).
The paragraph that follows the chapter title is not indented, as is a standard typographical practice. To get an indent use the package indentfirst.
You can change what is shown for the chapter number. To change it to something like ‘Lecture 1’, put in the preamble either \renewcommand{\chaptername}{Lecture}
or this (see \makeatletter & \makeatother).
\makeatletter \renewcommand{\@chapapp}{Lecture} \makeatother
To make this change because of the primary language for the document, see the package babel.
In a two-sided document LaTeX puts a chapter on odd-numbered page, if necessary leaving an even-numbered page that is blank except for any running headers. To make that page completely blank, see \clearpage & \cleardoublepage.
To change the behavior of the \chapter
command, you can copy its definition from the LaTeX format file and make adjustments. But there are also many packages on CTAN that address this. One is titlesec. See its documentation, but the example below gives a sense of what it can do.
\usepackage{titlesec} % in preamble \titleformat{\chapter} {\Huge\bfseries} % format of title {} % label, such as 1.2 for a subsection {0pt} % length of separation between label and title {} % before-code hook
This omits the chapter number ‘Chapter 1’ from the page but unlike \chapter*
it keeps the chapter in the table of contents and the running headers.
© 2007–2018 Karl Berry
Public Domain Software
http://latexref.xyz/_005cchapter.html