diff options
| -rw-r--r-- | Master/texmf-dist/doc/latex/sectionbreak/CHANGELOG.md | 5 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/sectionbreak/README.md | 102 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.pdf | bin | 0 -> 39595 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.tex | 37 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-example.tex | 23 | ||||
| -rw-r--r-- | Master/texmf-dist/tex/latex/sectionbreak/sectionbreak.sty | 44 | ||||
| -rwxr-xr-x | Master/tlpkg/bin/tlpkg-ctan-check | 2 | ||||
| -rw-r--r-- | Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc | 1 | ||||
| -rw-r--r-- | Master/tlpkg/tlpsrc/sectionbreak.tlpsrc | 0 |
9 files changed, 213 insertions, 1 deletions
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[<mark>]` + +: print the section break. Optional argument can contain content which should be printed in the break center. + +`\sectionbreakmark{<mark>}` + +: 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} + +% <img src="https://raw.githubusercontent.com/michal-h21/sectionbreak/master/sectionbreak-example.png" > + +% <!-- + +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 +% --> + +# 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 Binary files differnew file mode 100644 index 00000000000..b1dc915b5ba --- /dev/null +++ b/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.pdf 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 diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check index b191135faf4..668b8c5a4a6 100755 --- a/Master/tlpkg/bin/tlpkg-ctan-check +++ b/Master/tlpkg/bin/tlpkg-ctan-check @@ -553,7 +553,7 @@ my @TLP_working = qw( scratch scratchx screenplay screenplay-pkg scrjrnl scrlttr2copy scsnowman sdrt sduthesis - secdot section sectionbox sectsty seealso + secdot section sectionbox sectionbreak sectsty seealso selectp selnolig semantic semantic-markup semaphor seminar semioneside semproc sepfootnotes sepnum seqsplit serbian-apostrophe serbian-date-lat serbian-def-cyr serbian-lig diff --git a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc index 769a4ed9fd1..e0d027f51cb 100644 --- a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc +++ b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc @@ -923,6 +923,7 @@ depend scrlttr2copy depend sdrt depend secdot depend sectionbox +depend sectionbreak depend sectsty depend seealso depend selectp diff --git a/Master/tlpkg/tlpsrc/sectionbreak.tlpsrc b/Master/tlpkg/tlpsrc/sectionbreak.tlpsrc new file mode 100644 index 00000000000..e69de29bb2d --- /dev/null +++ b/Master/tlpkg/tlpsrc/sectionbreak.tlpsrc |