summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/titlesec/titlesec.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-10 03:00:50 +0000
committerNorbert Preining <norbert@preining.info>2019-09-10 03:00:50 +0000
commita1c3d5afa1daf60d772eb18931e05c5397e7404c (patch)
tree2a4223ec285ae7993f47d69600480c0ded8c9922 /macros/latex/contrib/titlesec/titlesec.tex
parentcb5ec966f1a3e9b26dcd7fc1b13998e03581b8fd (diff)
CTAN sync 201909100300
Diffstat (limited to 'macros/latex/contrib/titlesec/titlesec.tex')
-rw-r--r--macros/latex/contrib/titlesec/titlesec.tex66
1 files changed, 43 insertions, 23 deletions
diff --git a/macros/latex/contrib/titlesec/titlesec.tex b/macros/latex/contrib/titlesec/titlesec.tex
index d10da1e040..619e043700 100644
--- a/macros/latex/contrib/titlesec/titlesec.tex
+++ b/macros/latex/contrib/titlesec/titlesec.tex
@@ -7,14 +7,15 @@
% Repository: https://github.com/jbezos/titlesec
%
-\def\fileversion{2.11}
-\def\docdate{2019/07/16}
+\def\fileversion{2.12}
+\def\docdate{2019/09/09}
\documentclass[a4paper]{ltxguide}
\usepackage[sf,bf,compact,topmarks,calcwidth,pagestyles]{titlesec}
-\usepackage{titletoc}
+\usepackage{titletoc,color}
\def\gobble#1{}
\def\cs#1{\expandafter\gobble\string\\#1}
+\definecolor{notes}{rgb}{.75, .3, .3}%
\makeatletter
\newenvironment{desc}
{\if@nobreak
@@ -23,18 +24,21 @@
\fi
\decl}
{\enddecl}
+\def\@begintheorem#1#2{%
+ \list{}{}%
+ \global\advance\@listdepth\m@ne
+ \item[{\sffamily\bfseries\color{notes}\MakeUppercase{#1}}]}%
+\newtheorem{warning}{Warning}
+\newtheorem{note}{Note}
+\newtheorem{example}{Example}
\makeatother
-\usepackage{textcomp,pslatex}
+\usepackage{textcomp}
\usepackage[linktocpage]{hyperref}
\title{The \textsf{titlesec}, \textsf{titleps} and \textsf{titletoc}
Packages\footnote{The \textsf{titlesec} package is currently at
-version 2.10.2. \copyright{} 1998--2016 Javier Bezos.
-The \textsf{titletoc} package is currently at
-version 1.6. The \textsf{titleps} package is currently at version
-1.1.1 \copyright{} 1999--2016 Javier Bezos. All Rights
-Reserved.}}
+version 2.12. \copyright{} 1998--2019 Javier Bezos.}}
\author{Javier Bezos\footnote{For bug reports, comments and
suggestions go to \href{http://www.tex-tipografia.com/contact.html}%
@@ -91,6 +95,14 @@ dotlessi, babeltools}.}}
\maketitle
\tableofcontents
+
+\begin{note}
+ Please, report any issues you find on
+ \texttt{https://github.com/jbezos/titlesec/issues}, which is better
+ than just complaining on an e-mail list or a web forum. Forking
+ and pull requests are welcome.
+\end{note}
+
\section{Introduction}
This package is essentially a replacement---partial or total---for the
@@ -835,17 +847,24 @@ While the shapes and the like modify the behaviour of titles related
to the surrounding text, title classes allow to change the generic
behaviour of them. With the help of classes you may insert, say, a
new |subchapter| level between |chapter| and |section|, or creating a
-scheme of your own. \emph{Making a consistent scheme and defining all
-of related stuff like counters, macros, format, spacing and, if there
-is a TOC, TOC format is left to the responsibility of the user.} There
-are three classes: |page| is like the book |\part|, in a single page,
-|top| is like |\chapter|, which begins a page and places the title at
-the top, and |straight| is intended for titles in the middle of
-text.\footnote{There is an further class named |part| to emulate the
-article |\cs{part}|, but you should not use it at all. Use the
-|straight| class instead. Remember some features rely in these
-classes and \textsf{titlesec} does not change by default the
-definition of \texttt{\string\part} and \texttt{\string\chapter}.}
+scheme of your own.
+
+There are three classes: |page| is like the book |\part|, in a single
+page, |top| is like |\chapter|, which begins a page and places the
+title at the top, and |straight| is intended for titles in the middle
+of text.\footnote{There is an further class named |part| to emulate the
+article |\cs{part}|, but you should not use it at all. Use the
+|straight| class instead. Remember some features rely in these classes
+and \textsf{titlesec} does not change by default the definition of
+\texttt{\string\part} and \texttt{\string\chapter}.}
+
+\begin{warning}
+ Making a consistent scheme and defining all of
+ related stuff like counters, macros, format, and spacing is left to the
+ responsibility of the user. If there is a TOC, also the TOC format,
+ which might require redefining the corresponding macros to change the
+ hardcoded value (either by hand or with \textsf{titletoc}).
+\end{warning}
\begin{desc}
|\titleclass{<name>}{<class>}|\\
@@ -1518,16 +1537,17 @@ A simple usage might look like (provided you are using
\begin{verbatim}
\titleformat{\chapter}[display]
{...}{...}{...} % Your definitions come here
- [\vspace*{4pc}%
+ [{\vspace*{4pc}%
\startcontents
- \printcontents{l}{1}[2]{}]
+ \printcontents{l}{1}[2]{}}]
\titlecontents*{lsection}[0pt]
{\small\itshape}{}{}
{}[ \textbullet\ ][.]
\end{verbatim}
The included entries are those in levels 1 to 2 inclusive (i.e., 1
-and 2).
+and 2). Note the whole optional argument is enclosed in braces, because
+there is an internal \texttt{[]}.
\subsection[Partial lists]{Partial lists \normalfont\normalsize\fbox{2.6}}