sectioningspacingtext manipulation
I'd like to do this for some of my sections but not all. I'd also like to maintain the current spacing; for example, if the vspacing is 1cm from section title to body text (at 100% zoom), then I'd like it to be 1cm from the subtitle to body text.
Thanks.
If the "subtitle" attributes are to be the same from those of the title, and you want the information to appear right after the title, you can use the optional argument of the sectional units:
\documentclass{article}
\begin{document}
\tableofcontents
\section[Layout -- This section describes the layout]{Layout}
\subsection{Main Window}
\subsection{Footer}
\section[Navigation -- Here you will get information on foobar]{Navigation}
\subsection{Basic structure}
\subsection{Overview page}
\end{document}
As tohecz mentions in a comment this will also add this subtitle to the header marks.
Another sometimes used format is to write this "subtitle" right below the title for the sectional unit. The following code shows one way to achieve this; the idea is to define a new command \sectionsubtitle which writes the information to the ToC, immitating the way section entries are typeset, but suppressing the sectional and page numbering, and the leading dots; additionally, with this approach the subtitles won't be added to the head marks:
\documentclass{article}
\usepackage{etoolbox}
\makeatletter
\let\@nodottedtocline\@dottedtocline
\patchcmd{\@nodottedtocline}{\hbox{.}}{\hbox{}}{}{}
\patchcmd{\@nodottedtocline}{\normalcolor #5}{\normalcolor}{}{}
\newcommand*\l@sectionsubtitle{\@nodottedtocline{1}{0em}{1.5em}}
\makeatother
\def\sectionsubtitle#1{%
\addcontentsline{toc}{sectionsubtitle}{\protect\numberline{}#1}%
}
\begin{document}
\tableofcontents
\section{Layout}
\sectionsubtitle{This section describes the layout}
\subsection{Main Window}
\subsection{Footer}
\section{Navigation}
\sectionsubtitle{Here you will get information on foobar}
\subsection{Basic structure}
\subsection{Overview page}
\end{document}
Here's one possibility, using the titlesec package; before each \section, some commands can be used: \undefds suppresses previous dates and subtitles; \sectiondate{<text>} assigns <text> as the date for the following \section, and \sectionsubtitle{<text>} assigns <text> as the subtitle for the following \section.
Since titlesec was used, somre restrictions apply (See About memoir and titlesec incompatibility). The code:
\documentclass[article]{memoir}
\usepackage[margin=3cm]{geometry}% just for the example
\usepackage[T1]{fontenc}
\usepackage[explicit]{titlesec}
\usepackage{xcolor}
\usepackage{textcase}
\usepackage{lmodern}
\usepackage{lipsum}
\makeatletter
\newcommand*\nameundef[1]{%
\expandafter\let\csname #1\endcsname\@undefined}
\newcommand\sectiondatefont{\normalfont\sffamily\itshape\bfseries\Large}
\newcommand\sectionsubtitlefont{\normalfont\sffamily\LARGE}
\newcommand\sectiondate[1]{\def\@sectiondate{#1}}
\newcommand\sectionsubtitle[1]{\def\@sectionsubtitle{#1}}
\titleformat{\section}
{\normalfont\bfseries\huge\sffamily}{}{0em}
{\colorbox{gray}{%
\parbox[t]{\dimexpr\textwidth-2\fboxsep-2\fboxrule\relax}{%
\vspace*{1ex}%
\@ifundefined{@sectiondate}
{}{{\sectiondatefont\@sectiondate}\\*}%
\raggedright%
\textcolor{white}{\huge\MakeTextUppercase{#1}}%
\@ifundefined{@sectionsubtitle}
{}{\\*{\sectionsubtitlefont\@sectionsubtitle}}%
\vspace*{1ex}
}%
}%
}
\newcommand\undefds{%
\nameundef{@sectiondate}\nameundef{@sectionsubtitle}}
\makeatother
\begin{document}
\sectiondate{March 15, 2013}
\sectionsubtitle{Test Subtitle}
\section{Test Section With a Title Spanning Two Lines}
\lipsum[4]
\undefds
\section{Test Section}
\lipsum[4]
\undefds
\sectiondate{April 23, 2009}
\section{Another Test Section}
\lipsum[4]
\undefds
\sectionsubtitle{Another Test Subtitle}
\section{Test Section}
\lipsum[4]
\end{document}
An image of the result:
Best Answer
If the section's subtitle has to show up in the TOC, then use: