summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/froufrou
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-12-28 22:33:38 +0000
committerKarl Berry <karl@freefriends.org>2020-12-28 22:33:38 +0000
commitde0cbc8d3bebf0f11675f434a42c3d39ae26273b (patch)
tree6a20f3efbda7349f4eafbfcdda1cdc0d75fe3f09 /Master/texmf-dist/source/latex/froufrou
parent1933be51c625ec25039db7f381bd84abdeeadee5 (diff)
froufrou (28dec20)
git-svn-id: svn://tug.org/texlive/trunk@57248 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/froufrou')
-rw-r--r--Master/texmf-dist/source/latex/froufrou/froufrou.dtx316
-rw-r--r--Master/texmf-dist/source/latex/froufrou/froufrou.ins50
2 files changed, 366 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/froufrou/froufrou.dtx b/Master/texmf-dist/source/latex/froufrou/froufrou.dtx
new file mode 100644
index 00000000000..bce65ae0760
--- /dev/null
+++ b/Master/texmf-dist/source/latex/froufrou/froufrou.dtx
@@ -0,0 +1,316 @@
+% \iffalse meta-comment
+% Copyright 2020 Nelson Lago <lago@ime.usp.br>
+%
+% This work may be distributed and/or modified under the conditions of the
+% LaTeX Project Public License, either version 1.3 of this license or (at
+% your option) any later version. The latest version of this license can be
+% found at http://www.latex-project.org/lppl.txt and version 1.3 or later
+% is part of all distributions of LaTeX version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status `maintained'.
+%
+% The Current Maintainer of this work is Nelson Lago <lago@ime.usp.br>.
+%
+% \fi
+% \iffalse
+%
+%<package>\NeedsTeXFormat{LaTeX2e}[2015/01/01]
+%<package>\ProvidesPackage{froufrou}[2020/12/22 1.2 Visual section separator]
+%
+%<*driver>
+
+\documentclass{ltxdoc}
+
+\usepackage[hyperref,svgnames,x11names,table]{xcolor}
+\usepackage{url}
+\urlstyle{sf}
+\usepackage{hyperref}
+\hypersetup{
+ pdfborder={0 0 .6},
+ pdfborderstyle={/S/U/W .6},
+ urlbordercolor=DodgerBlue,
+ citebordercolor=White,
+ linkbordercolor=White,
+ filebordercolor=White,
+}
+
+\usepackage{froufrou}
+
+\usepackage{libertinus}
+\usepackage[scale=.85]{sourcecodepro}
+
+%%\EnableCrossrefs
+%%\CodelineIndex
+\RecordChanges
+
+\OnlyDescription
+
+\begin{document}
+\DocInput{froufrou.dtx}
+\end{document}
+
+%</driver>
+%
+% \fi
+%
+% \CheckSum{0}
+%
+% \changes{v1.0}{2019/04/24}{Prerelease}
+% \changes{v1.1}{2020/02/03}{Prerelease}
+% \changes{v1.2}{2020/12/22}{First public version}
+%
+% \GetFileInfo{froufrou.sty}
+%
+% \title{The \textsf{froufrou} package\thanks{This document
+% corresponds to \textsf{froufrou}~\fileversion, dated~\filedate.}}
+%
+% \author{
+% Nelson Lago\\
+% \texttt{lago@ime.usp.br}\\
+% ~\\
+% \url{https://gitlab.com/lago/froufrou}
+% }
+%
+% \maketitle
+%
+% \begin{abstract}
+%
+% This package provides fancy separators, which are visual cues that
+% indicate a change of subject or context without actually starting
+% a new chapter or section.
+%
+% \end{abstract}
+%
+% \section{Introduction}
+%
+% This package allows the user to create fancy separators that visually
+% indicate text subdivisions without a title, i.e., they are similar to
+% \verb|\section| but do not provide a name to the new section. Apparently,
+% there is no definite name for such separators; they may be regarded as
+% thought breaks or anonymous sections, but often borrow their name from
+% the ornament that embodies them, such as asterism, fleuron, or dinkus.
+% An example:
+%
+% \froufrou
+%
+% Such separators never appear at the top of the page (that would be
+% confusing), but may appear at the bottom. They should work equally
+% well with one or two-column text and with single or doublespacing.
+% The package offers a few predefined ornaments to be used as separators,
+% but the user may create others.
+%
+% \section{Usage}
+%
+% After \verb|\usepackage{froufrou}|, just call \verb|\froufrou| to create
+% a subdivision. By default, the separator behaves like \verb|\section|,
+% suppressing indentation in the following paragraph. With \verb|\froufrou*|,
+% this feature is disabled and the following paragraph is indented normally.
+%
+% You may select a different separator appearance either by
+% supplying the name of a predefined ornament as a package
+% option (\verb|\usepackage[ornament]{froufrou}|) or by calling
+% \verb|\setfroufrou{ornament}| anywhere in the document. You may
+% also use \verb|\froufrou[ornament]| to only affect that specific
+% separator. \verb|ornament| is one of:
+%
+% \makeatletter
+% \begin{description}
+%
+% \item[fleuron,] the default\footnote{From the \verb|fancyhdr| docs.}: \quad\@froufrouFleuron
+%
+% \item[simplefleuron,] similar to the default, but without the side lines: \quad\@froufrouSimpleFleuron
+%
+% \item[asterism,] three asterisks forming a triangle\footnote{
+% From \verb|symbols-a4| (search for ``asterism'').}: \quad\@froufrouAsterism
+%
+% \item[tightasterism,] similar, but with tighter spacing: \quad\@froufrouTightAsterism
+%
+% \item[trueasterism,] also similar, but using unicode character
+% U+2042\footnote{This only works with a unicode engine
+% (luatex, xetex) and with a font that actually provides the
+% glyph (such as libertinus or libertine).}: \quad\@froufrouTrueAsterism
+%
+% \item[dinkus,] three asterisks forming a line: \quad\@froufrouDinkus
+%
+% \end{description}
+% \makeatother
+%
+% Beyond the predefined ornaments, you may also use
+% \verb|\setfroufrou{SOMETHING}| or \verb|\froufrou[SOMETHING]|
+% to make \verb|SOMETHING| be the separator. However, please note
+% that \verb|\usepackage[SOMETHING]{froufrou}| does \emph{not} work!
+%
+% \section{See also}
+%
+% \begin{itemize}
+% \item \url{http://tug.org/TUGboat/tb32-2/tb101glister.pdf} ;
+% \item The \verb|pgfornament| package, which may aid in creating separators;
+% \item The \verb|novel| class, which offers the somewhat similar \verb|\ChapterDeco| command;
+% \item The \verb|memoir| class, which offers the somewhat similar \verb|\fancybreak| command;
+% \end{itemize}
+%
+% \StopEventually{\PrintChanges}
+%
+% \section{The implementation}
+%
+% \begin{macrocode}
+
+\RequirePackage{etoolbox}
+\RequirePackage{expl3}
+
+% .1\textwidth works well for one and two-column text.
+\RequirePackage{fourier-orns}
+\newcommand\@froufrouFleuron{%
+ \bgroup
+ \footnotesize
+ \rule[.7mm]{.1\textwidth}{0.5pt}%
+ \enspace\,%
+ \decofourleft\decotwo\decofourright
+ \enspace\,%
+ \rule[.7mm]{.1\textwidth}{0.5pt}%
+ \egroup
+}
+
+\newcommand\@froufrouSimpleFleuron{%
+ \bgroup
+ \footnotesize
+ \decofourleft\decotwo\decofourright
+ \egroup
+}
+
+\newcommand{\@froufrouTightAsterism}{%
+ \bgroup
+ \smash{%
+ \raisebox{-.5ex}{%
+ \setlength{\tabcolsep}{-.5pt}%
+ \begin{tabular}{@{}cc@{}}%
+ \multicolumn2c*\\[-2ex]*&*%
+ \end{tabular}%
+ }%
+ }%
+ \egroup
+}
+
+\newcommand{\@froufrouAsterism}{%
+ \bgroup
+ \smash{%
+ \raisebox{-.5ex}{%
+ \setlength{\tabcolsep}{0pt}%
+ \begin{tabular}{@{}cc@{}}%
+ \multicolumn2c*\\[-1.8ex]*&*%
+ \end{tabular}%
+ }%
+ }%
+ \egroup
+}
+
+% Unicode character U+2042 (\char"2042), only with a unicode engine
+% (luatex/xetex) and a font that has this glyph (such as libertinus
+% or libertine)
+\newcommand\@froufrouTrueAsterism{⁂}
+
+\newcommand{\@froufrouDinkus}{\relax*\quad*\quad*}
+
+\ExplSyntaxOn
+\newcommand\setfroufrou[1]{%
+ \str_case:nnF{#1}{
+ {}{\relax}
+ {fleuron}{\def\@froufrouOrnament{\@froufrouFleuron}}
+ {simplefleuron}{\def\@froufrouOrnament{\@froufrouSimpleFleuron}}
+ {asterism}{\def\@froufrouOrnament{\@froufrouAsterism}}
+ {tightasterism}{\def\@froufrouOrnament{\@froufrouTightAsterism}}
+ {trueasterism}{\def\@froufrouOrnament{\@froufrouTrueAsterism}}
+ {dinkus}{\def\@froufrouOrnament{\@froufrouDinkus}}%
+ }{\def\@froufrouOrnament{#1}}%
+}
+\ExplSyntaxOff
+
+% I see no reason to make these different, but feel free to change this :)
+\def\@froufrouspacebefore{\vskip 22pt plus 7pt minus 5pt}
+\def\@froufrouspaceafter{\@froufrouspacebefore}
+
+% The starred form means "indent the first line of the next paragraph"
+% (\if@afterindent is read by \@afterheading)
+\newcommand{\froufrou}{%
+ \@ifstar{\@afterindenttrue\@realfroufrou}{\@afterindentfalse\@realfroufrou}%
+}
+
+% For compatibility with older versions of this package
+\newcommand\frufru{\froufrou}
+
+\newcommand{\@realfroufrou}[1][]{%
+ % Make sure we left horizontal mode.
+ \nopagebreak[4]\par
+
+ \nopagebreak[4]\@froufrouspacebefore\nopagebreak[4]
+
+ % Start a new group to (1) reset \doublespacing, \parskip, and
+ % \baselineskip, so spacing is independent from the previous text
+ % settings and (2) so that using #1 to change the ornament only
+ % affects the current call. Then, start yet another group only
+ % for the ornament because font size changes in it should not
+ % affect spacing either.
+ \bgroup
+ \setfroufrou{#1}%
+ \normalsize
+ \ifdefvoid{\setstretch}{}{\setstretch{\setspace@singlespace}}% normally 1
+ \setlength{\parskip}{0pt}
+ \noindent\centering\bgroup\@froufrouOrnament\egroup\par
+ \egroup
+
+ \nopagebreak[4]\@froufrouspaceafter\nopagebreak[4]
+
+ % Next paragraph's \doublespacing, \baselineskip, and \parskip
+ % should not affect spacing.
+ \@froufrouFixSpacingAfter
+
+ % Breaking after the separator is acceptable as a last resort. Since
+ % we use a lot of vertical space before/after it, not allowing this
+ % break might lead to poor results in some cases.
+ \nopagebreak[3]
+
+ % Emulate the behavior of \section, \subsection etc: prevent
+ % the first line of the next paragraph from being indented
+ % and absolutely forbid a club line in the next paragraph.
+ \@afterheading
+}
+
+\newcommand\@froufrouFixSpacingAfter{
+ % The next \par will add \parskip and \baselineskip. We want to
+ % (1) eliminate \parskip so that spacing does not change if it
+ % is nonzero and (2) add the "normal" \baselineskip, even if the
+ % text is set using \doublespacing. These adjustments may be off
+ % if font size, \parskip or \baselineskip are changed before the
+ % next paragraph.
+
+ \nopagebreak[4]\vskip -\parskip
+
+ \ifdefvoid{\setstretch}
+ {}
+ {
+ \bgroup
+ % \singlespacing may add an extra \baselineskip; let's
+ % avoid surprises and use \setstrech instead.
+ \setstretch {\setspace@singlespace}% normally 1
+ \nopagebreak[4]\vskip \baselineskip
+ \egroup
+
+ \nopagebreak[4]\vskip -\baselineskip
+ }
+}
+
+% Trying to accept a custom ornament as a package option is not such a
+% great idea: first, it has to be expandable; second, this may become
+% a problem if we want to add more options to the class in the future.
+\DeclareOption{fleuron}{\setfroufrou{fleuron}}
+\DeclareOption{simplefleuron}{\setfroufrou{simplefleuron}}
+\DeclareOption{asterism}{\setfroufrou{asterism}}
+\DeclareOption{tightasterism}{\setfroufrou{tightasterism}}
+\DeclareOption{trueasterism}{\setfroufrou{trueasterism}}
+\DeclareOption{dinkus}{\setfroufrou{dinkus}}
+\DeclareOption*{\PackageWarning{froufrou}{Unknown option `\CurrentOption'}}
+\ExecuteOptions{fleuron}
+\ProcessOptions\relax
+
+% \end{macrocode}
+% \Finale
diff --git a/Master/texmf-dist/source/latex/froufrou/froufrou.ins b/Master/texmf-dist/source/latex/froufrou/froufrou.ins
new file mode 100644
index 00000000000..153a5a04fc1
--- /dev/null
+++ b/Master/texmf-dist/source/latex/froufrou/froufrou.ins
@@ -0,0 +1,50 @@
+%% Copyright 2020 Nelson Lago <lago@ime.usp.br>
+%%
+%% This work may be distributed and/or modified under the conditions of the
+%% LaTeX Project Public License, either version 1.3 of this license or (at
+%% your option) any later version. The latest version of this license can be
+%% found at http://www.latex-project.org/lppl.txt and version 1.3 or later
+%% is part of all distributions of LaTeX version 2005/12/01 or later.
+%%
+%% This work has the LPPL maintenance status `maintained'.
+%%
+%% The Current Maintainer of this work is Nelson Lago <lago@ime.usp.br>.
+
+\input docstrip.tex
+\keepsilent
+\askforoverwritefalse
+\usedir{tex/latex/froufrou}
+
+\preamble
+Copyright 2020 Nelson Lago <lago@ime.usp.br>
+
+This work may be distributed and/or modified under the conditions of the
+LaTeX Project Public License, either version 1.3 of this license or (at
+your option) any later version. The latest version of this license can be
+found at http://www.latex-project.org/lppl.txt and version 1.3 or later
+is part of all distributions of LaTeX version 2005/12/01 or later.
+
+This work has the LPPL maintenance status `maintained'.
+
+The Current Maintainer of this work is Nelson Lago <lago@ime.usp.br>.
+
+\endpreamble
+
+\generate{\file{froufrou.sty}{\from{froufrou.dtx}{package}}}
+
+\obeyspaces
+\Msg{****************************************************}
+\Msg{* *}
+\Msg{* To finish the installation you have to move the *}
+\Msg{* following file into a directory searched by TeX: *}
+\Msg{* *}
+\Msg{* froufrou.sty *}
+\Msg{* *}
+\Msg{* To produce the documentation run the file *}
+\Msg{* froufrou.dtx through LaTeX. *}
+\Msg{* *}
+\Msg{* Happy TeXing! *}
+\Msg{* *}
+\Msg{****************************************************}
+
+\endbatchfile