Paragraph highlights before each section

Question

In front of each section in my book I want to have a list of highlights for some paragraph, just like in this Darwin's book:

I don't know what is the right name for this feature, that's why can't find the right LaTeX package. What is it? Which package do I need to use?

PS. I guess, I need something similar to this. Here is the document structure I'm looking for:

\documentclass{book}
\begin{document}
\tableofcontents
\chapter{Insects}
\section{Order Lepidoptera}
\paragraph{Courtship of butterflies}
In this great Order the most interesting point for us is the difference
in colour between the sexes of the same species, and between 
the distinct species of the same genus. Nearly the whole of 
the following chapter will be devoted to this subject.
\paragraph{Battles}
Every one has admired the extreme beauty of many butterflies and 
of some moths; and we are led to ask, how has this beauty 
been acquired?
\end{document}

First, I want to see this in the ToC:

1 Insects
1.1 Order Lepidoptera
Courtship of butterflies - Battles

And then, in the body of the document:

Chapter 1: "Insects"

Section 1.1: Order Lepidoptera

Courtship of butterflies - Battles

Courtship of butterflies.
In this great Order the most interesting point for us is the difference
in colour between the sexes of the same species, and between 
the distinct species of the same genus. Nearly the whole of 
the following chapter will be devoted to this subject.

Battles. 
Every one has admired the extreme beauty of many butterflies and 
of some moths; and we are led to ask, how has this beauty 
been acquired?

This looks like a table of contents by chapter. It's very easy to obtain with the tiitlesec/titletoc packages. — Bernard, Jan 05 '18 at 22:57
Do you want this feature automated? One would assume you're referring to using \sections and \subsections in your document, correct? Does 386-423 represent the span of the entire \section within your document? Should this also be automated? Should the \subsections highlighted in this "mini ToC" be hyperlinks? — Werner, Jan 05 '18 at 23:48
Are you able to provide a document template from which one can build upon? — Werner, Jan 05 '18 at 23:49

Paul Gaborit · Accepted Answer · 2018-01-06T14:58:59.660

Here is a solution (with pages range) using the etoc package (it needs two compilations to get correct tables of contents) :

\documentclass{book}
\usepackage{hyperref}
\usepackage{etoc}

\newcommand\listofparagraphsincurrentsection{%
  \begingroup%
  \etocsetlevel{subsection}{6}%
  \etocsetlevel{subsubsection}{6}%
  \etocsetlevel{subparagraph}{6}%
  \etocsetstyle{paragraph}{}%
  {\etociffirst{\edef\myfirstpage{\etocpage}}{ -- }\edef\mylastpage{\etocpage}}%
  {\etocname}{\dotfill \myfirstpage{}-\mylastpage{}}%
  \etocsettocstyle{}{}%
  \etocsettocdepth{5}%
  \localtableofcontents%
  \endgroup%
}

\begin{document}
\tableofcontents

\chapter{Insects}

\section{Order Lepidoptera}

\listofparagraphsincurrentsection

\paragraph{Courtship of butterflies} In this great Order the most
interesting point for us is the difference in colour between the sexes
of the same species, and between the distinct species of the same
genus. Nearly the whole of the following chapter will be devoted to this
subject.

\subsection{Test with a subsection}

\paragraph{Battles} Every one has admired the extreme beauty of many
butterflies and of some moths; and we are led to ask, how has this
beauty been acquired?

\end{document}

Many thanks, but why \tableofcontents doesn't render anything? — yegor256, Jan 06 '18 at 12:28

Paragraph highlights before each section

1 Answers1