How to prevent page break between two section headings

I have a custom document class, based on book.cls, for which the following code sometimes produces page breaks between two subsequent sections:

  \section{Introduction}
% page break may occur here
\subsection{Getting started}


I am completely puzzled, because my definitions for the sectioning commands are almost identical to those in book.cls:

\newcommand \headingfont {\fontfamily{phv}\fontseries{bc}\fontshape{n}\selectfont}
{-3.5ex \@plus -1ex \@minus -.2ex}%
{2ex \@plus.2ex}%
{-3.25ex\@plus -1ex \@minus -.2ex}%
{2ex \@plus .2ex}%
{-3.25ex\@plus -1ex \@minus -.2ex}%
{2ex \@plus .2ex}%
% etc.


Any ideas what might cause LaTeX to allow a page break?

-

migrated from stackoverflow.comMar 8 '13 at 23:44

This question came from our site for professional and enthusiast programmers.

\@startsection initiates itself with \par and therefore allows for a page break before the sectional header. Specific to your code snippet, \section attempts to avoid a page break after it, but \subsection allows a page break before it. –  Werner Mar 8 '13 at 19:52
@Hendrik, I would suggest reverting back to the original definitions and changing bit by bit to what you want it to look like, with incremental compilation. You should be able to find your error that way (unless it is actually rooted somewhere else in your custom class). –  Sean Allred Mar 9 '13 at 0:19

The problem is that \color{MMIblue} inserts a whatsit that disrupts the mechanism for disallowing page breaks after sectional titles.

Use

\newcommand\section{%
\@startsection{section}{1}
{-3.5ex \@plus -1ex \@minus -.2ex}%
{2ex \@plus.2ex}%


which works because the last instruction in the sixth argument to \@startsection reads the section title (with the number) as a braced group, which can then be interpreted by \textcolor as its second argument.

-

If you want to prevent a page break put your text, section headings, etc. into a samepage area.

\begin{samepage}
\section{Introduction}
% page break may occur here
\subsection{Getting started}
\end{samepage}


Now section and subsection should always be on the same page.

However, if you place a \label in the section/subsection, but outside the samepage environment, references to the label will show the number of the previous section!

-
Do NOT do this if you have labels in the section. If you put a label into the subsection whose heading is in the samepage environment, without including the label itself in the samepage environment, references to the label will bear the number of the previous section! –  Jan Schejbal Jun 29 at 18:34

Not sure you want to hear this:

From a typographical view of point I would never write two headings directly following each other. Usual is that a normal paragraph follows an heading. If you write two headings one of them is not nessessary.

Let's look us at two examples, the first one (in my opinion wrong):

1. Chapterheading


Much better is:

1. Chapterheading
Explanation, why two following sections are nessessary for this chapter.
Please keep in mind, that you have to write 2 or more sections. Only one
is a very bad typographic and if you rethink your text you will be able to

In general I agree with you, but for some technical documentation your arguments wouldn't apply. (Then one could argue that one shouldn't start from the book class :-)) –  Hendrik Vogt Mar 9 '13 at 8:06