texlive[46200] Master: sectionbreak (3jan18)
commits+karl at tug.org
commits+karl at tug.org
Wed Jan 3 22:59:18 CET 2018
Revision: 46200
http://tug.org/svn/texlive?view=revision&revision=46200
Author: karl
Date: 2018-01-03 22:59:18 +0100 (Wed, 03 Jan 2018)
Log Message:
-----------
sectionbreak (3jan18)
Modified Paths:
--------------
trunk/Master/tlpkg/bin/tlpkg-ctan-check
trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
Added Paths:
-----------
trunk/Master/texmf-dist/doc/latex/sectionbreak/
trunk/Master/texmf-dist/doc/latex/sectionbreak/CHANGELOG.md
trunk/Master/texmf-dist/doc/latex/sectionbreak/README.md
trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.pdf
trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.tex
trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-example.tex
trunk/Master/texmf-dist/tex/latex/sectionbreak/
trunk/Master/texmf-dist/tex/latex/sectionbreak/sectionbreak.sty
trunk/Master/tlpkg/tlpsrc/sectionbreak.tlpsrc
Added: trunk/Master/texmf-dist/doc/latex/sectionbreak/CHANGELOG.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/sectionbreak/CHANGELOG.md (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/sectionbreak/CHANGELOG.md 2018-01-03 21:59:18 UTC (rev 46200)
@@ -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
Property changes on: trunk/Master/texmf-dist/doc/latex/sectionbreak/CHANGELOG.md
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/sectionbreak/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/sectionbreak/README.md (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/sectionbreak/README.md 2018-01-03 21:59:18 UTC (rev 46200)
@@ -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'.
+
Property changes on: trunk/Master/texmf-dist/doc/latex/sectionbreak/README.md
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.pdf 2018-01-03 21:58:43 UTC (rev 46199)
+++ trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.pdf 2018-01-03 21:59:18 UTC (rev 46200)
Property changes on: trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.tex (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.tex 2018-01-03 21:59:18 UTC (rev 46200)
@@ -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}
Property changes on: trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-doc.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-example.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-example.tex (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-example.tex 2018-01-03 21:59:18 UTC (rev 46200)
@@ -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}
Property changes on: trunk/Master/texmf-dist/doc/latex/sectionbreak/sectionbreak-example.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/tex/latex/sectionbreak/sectionbreak.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/sectionbreak/sectionbreak.sty (rev 0)
+++ trunk/Master/texmf-dist/tex/latex/sectionbreak/sectionbreak.sty 2018-01-03 21:59:18 UTC (rev 46200)
@@ -0,0 +1,44 @@
+\ProvidesPackage{sectionbreak}
+\usepackage{kvoptions}
+\DeclareStringOption[2em]{preskip}
+\DeclareStringOption[2em]{postskip}
+\DeclareStringOption[\relax]{style}
+\DeclareStringOption[~]{mark}
+\DeclareBoolOption{asterism}
+
+\ProcessKeyvalOptions*
+
+\newdimen\asterism at width
+% asterism is character which consists of three asterisks layed out as a triangel
+\newcommand\asterism{%
+ \settowidth{\asterism at width}{*}%
+ % these values were found by trial and error
+ \raise-0.6\asterism at width\hbox{*\kern-.6\asterism at width\raise.7\asterism at width\hbox{*}\kern-.6\asterism at width*}%
+}
+
+\newcommand\pre at sectionbreak{\par\vskip\sectionbreak at preskip\relax}
+\newcommand\post at sectionbreak{\par\vskip\sectionbreak at postskip\relax}
+% print centered section break mark
+\newcommand\print at sectionbreak[1]{%
+ \bgroup%
+ \noindent\null\hfill\sectionbreak at style\hbox{#1}\hfill\null\par%
+ \egroup%
+}
+% default section break mark is an unbreakable space
+
+\newcommand\sectionbreak[1][\sectionbreak at mark]{%
+ \pre at sectionbreak%
+ \print at sectionbreak{#1}%
+ \post at sectionbreak%
+}
+
+\newcommand\sectionbreakmark[1]{%
+ \gdef\sectionbreak at mark{#1}%
+}
+
+% test the asterism option and set the section mark accordingly
+\ifsectionbreak at asterism
+ \sectionbreakmark{\asterism}
+\fi
+
+\endinput
Property changes on: trunk/Master/texmf-dist/tex/latex/sectionbreak/sectionbreak.sty
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/tlpkg/bin/tlpkg-ctan-check
===================================================================
--- trunk/Master/tlpkg/bin/tlpkg-ctan-check 2018-01-03 21:58:43 UTC (rev 46199)
+++ trunk/Master/tlpkg/bin/tlpkg-ctan-check 2018-01-03 21:59:18 UTC (rev 46200)
@@ -553,7 +553,7 @@
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
Modified: trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
===================================================================
--- trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc 2018-01-03 21:58:43 UTC (rev 46199)
+++ trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc 2018-01-03 21:59:18 UTC (rev 46200)
@@ -923,6 +923,7 @@
depend sdrt
depend secdot
depend sectionbox
+depend sectionbreak
depend sectsty
depend seealso
depend selectp
Added: trunk/Master/tlpkg/tlpsrc/sectionbreak.tlpsrc
===================================================================
More information about the tex-live-commits
mailing list