From 2971839f7d790de0480bc759e75c5ceeb87eff08 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 3 Jan 2018 21:59:18 +0000 Subject: sectionbreak (3jan18) git-svn-id: svn://tug.org/texlive/trunk@46200 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/sectionbreak/CHANGELOG.md | 5 + Master/texmf-dist/doc/latex/sectionbreak/README.md | 102 +++++++++++++++++++++ .../doc/latex/sectionbreak/sectionbreak-doc.pdf | Bin 0 -> 39595 bytes .../doc/latex/sectionbreak/sectionbreak-doc.tex | 37 ++++++++ .../latex/sectionbreak/sectionbreak-example.tex | 23 +++++ .../tex/latex/sectionbreak/sectionbreak.sty | 44 +++++++++ 6 files changed, 211 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/sectionbreak/CHANGELOG.md create mode 100644 Master/texmf-dist/doc/latex/sectionbreak/README.md create mode 100644 Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.pdf create mode 100644 Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.tex create mode 100644 Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-example.tex create mode 100644 Master/texmf-dist/tex/latex/sectionbreak/sectionbreak.sty (limited to 'Master/texmf-dist') diff --git a/Master/texmf-dist/doc/latex/sectionbreak/CHANGELOG.md b/Master/texmf-dist/doc/latex/sectionbreak/CHANGELOG.md new file mode 100644 index 00000000000..5415f6d8cd9 --- /dev/null +++ b/Master/texmf-dist/doc/latex/sectionbreak/CHANGELOG.md @@ -0,0 +1,5 @@ +- 2018/01/03 Version 0.1b + - Fixed vertical position of the `\asterism` symbol + - Small fixes in the documentation +- 2018/01/03 Version 0.1a + - Initial version diff --git a/Master/texmf-dist/doc/latex/sectionbreak/README.md b/Master/texmf-dist/doc/latex/sectionbreak/README.md new file mode 100644 index 00000000000..684e6b557f9 --- /dev/null +++ b/Master/texmf-dist/doc/latex/sectionbreak/README.md @@ -0,0 +1,102 @@ +# The `sectionbreak` package + +This package provides LaTeX support for section breaks, used mainly in fiction +books to signal changes in a story, like changes in time, location, etc. +(Source: [Wikipedia](https://en.wikipedia.org/wiki/Section_(typography))). + + +## Package options + +There are several package options: + +`mark` + +: characters printed in the center of the section break. It is space by default, common value might be `***` for example. + +`asterism` + +: request [asterism](https://en.wikipedia.org/wiki/Asterism_(typography)) as a section mark. + +`preskip` + +: Amount of space printed before the section mark. It should be a dimension unit supported by TeX. + +`postskip` + +: Similar to `preskip`, but it is a space printed after the section mark. + +`style` + +: LaTeX commands for font style change, like `\bfseries`, for example. + +## Commands + +`\sectionbreak[]` + +: print the section break. Optional argument can contain content which should be printed in the break center. + +`\sectionbreakmark{}` + +: set the content printed in the following `\sectionbreak` commands. + +`\asterism` + +: print the asterism (\asterism) symbol. + +## The `tex4ht` support + +The `sectionbreak` package has support for `tex4ht`, so it is possible to use +this package in conversion to `HTML` or other formats supported by this +conversion system. It provides the following configurations: + +`\Configure{sectionbreak}{before section break }{after section}` + +: this configuration can be used for insertion of a box around the section break mark, which can be styled using CSS to print the blank space around the content. + +`\Configure{asterism}{code which replaces the asterism symbol}` + +: the asterism symbol is configured to use Unicode for it's rendering by default. This method might be unsupported by some devices like e-Ink readers, so it is possible to set a different code using this configuration. + +# Example + + + \documentclass[12pt]{article} + \usepackage[asterism]{sectionbreak} + \begin{document} + + Section separated by three asterisk marks + \sectionbreak[!!!] + + Section separated by asterism section mark requested in \texttt{\textbackslash usepackage}. + \sectionbreak + + Section separated by a rule. + \sectionbreakmark{\rule{10em}{3pt}} + \sectionbreak + + + \end{document} + +% + +% + +# License + +This package is copyright 2017--2018 Michal Hoftich. +It may be distributed and/or modified under the +conditions of the [LaTeX Project Public License](http://www.latex-project.org/lppl.txt), either version 1.3 +of this license or (at your option) any later version. +This work has the LPPL maintenance status `maintained'. + diff --git a/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.pdf b/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.pdf new file mode 100644 index 00000000000..b1dc915b5ba Binary files /dev/null and b/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.pdf differ diff --git a/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.tex b/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.tex new file mode 100644 index 00000000000..fced44203f0 --- /dev/null +++ b/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.tex @@ -0,0 +1,37 @@ +% přesunout do ~/texexamples/packages +\documentclass[a4page]{ltxdoc} +\usepackage{luatex85} +\usepackage[top=2cm, left=2.5cm, right=2.5cm,bottom=3cm]{geometry} +\usepackage[english]{babel} +\usepackage[asterism]{sectionbreak} +\usepackage[definitionLists=true,hybrid=true]{markdown} +\usepackage{fontspec} +\usepackage{microtype} +\usepackage{hyperref} +\setmainfont{TeX Gyre Schola} +\setmonofont{Inconsolata}[Scale=MatchLowercase] +\ifdefined\version\else\def\version{undefined}\fi +\ifdefined\gitdate\else\def\gitdate{undefined}\fi +\begin{document} +\title{The \texttt{sectionbreak} package\footnote{Version \version}} +\author{Michal Hoftich} +\date{\gitdate} +\maketitle +\tableofcontents +\markdownInput{README.md} +\section{Changelog} +\markdownInput{CHANGELOG.md} +% \lipsum[1-3] + +% \sectionbreak[!!!] + +% \lipsum[5-7] + +% \sectionbreak + +% \lipsum[1-2] +% \sectionbreakmark{\rule{10em}{3pt}} +% \sectionbreak + +% \lipsum[6-8] +\end{document} diff --git a/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-example.tex b/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-example.tex new file mode 100644 index 00000000000..cdc79053491 --- /dev/null +++ b/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-example.tex @@ -0,0 +1,23 @@ +% přesunout do ~/texexamples/packages +\documentclass[12pt]{article} +\usepackage{luatex85} +\usepackage[paperwidth=30em, paperheight=26em,margin=2em]{geometry} +\parindent=0pt +% \usepackage[***,postskip=1em,preskip=1em]{sectionbreak} +\usepackage[asterism]{sectionbreak} +\pagestyle{empty} + +\begin{document} + +Section separated by three asterisk marks +\sectionbreak[!!!] + +Section separated by asterism section mark requested in\\ \texttt{\textbackslash usepackage}. +\sectionbreak + +Section separated by a rule. +\sectionbreakmark{\rule{10em}{3pt}} +\sectionbreak + + +\end{document} diff --git a/Master/texmf-dist/tex/latex/sectionbreak/sectionbreak.sty b/Master/texmf-dist/tex/latex/sectionbreak/sectionbreak.sty new file mode 100644 index 00000000000..b8f306519ee --- /dev/null +++ b/Master/texmf-dist/tex/latex/sectionbreak/sectionbreak.sty @@ -0,0 +1,44 @@ +\ProvidesPackage{sectionbreak} +\usepackage{kvoptions} +\DeclareStringOption[2em]{preskip} +\DeclareStringOption[2em]{postskip} +\DeclareStringOption[\relax]{style} +\DeclareStringOption[~]{mark} +\DeclareBoolOption{asterism} + +\ProcessKeyvalOptions* + +\newdimen\asterism@width +% asterism is character which consists of three asterisks layed out as a triangel +\newcommand\asterism{% + \settowidth{\asterism@width}{*}% + % these values were found by trial and error + \raise-0.6\asterism@width\hbox{*\kern-.6\asterism@width\raise.7\asterism@width\hbox{*}\kern-.6\asterism@width*}% +} + +\newcommand\pre@sectionbreak{\par\vskip\sectionbreak@preskip\relax} +\newcommand\post@sectionbreak{\par\vskip\sectionbreak@postskip\relax} +% print centered section break mark +\newcommand\print@sectionbreak[1]{% + \bgroup% + \noindent\null\hfill\sectionbreak@style\hbox{#1}\hfill\null\par% + \egroup% +} +% default section break mark is an unbreakable space + +\newcommand\sectionbreak[1][\sectionbreak@mark]{% + \pre@sectionbreak% + \print@sectionbreak{#1}% + \post@sectionbreak% +} + +\newcommand\sectionbreakmark[1]{% + \gdef\sectionbreak@mark{#1}% +} + +% test the asterism option and set the section mark accordingly +\ifsectionbreak@asterism + \sectionbreakmark{\asterism} +\fi + +\endinput -- cgit v1.2.3