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 '14 at 18:34