CTAN Comprehensive TeX Archive Network

Direc­tory macros/latex/contrib/sectionbreak

README.md

The sectionbreak pack­age

This pack­age pro­vides sup­port for sec­tion breaks, used mainly in fic­tion books to sig­nal changes in a story, like changes in time, lo­ca­tion, etc. (Source: Wikipedia)).

Pack­age op­tions

There are sev­eral pack­age op­tions:

disable

: dis­able sec­tion break print­ing.

mark

: char­ac­ters printed in the cen­ter of the sec­tion break. It is space by de­fault, com­mon value might be *** for ex­am­ple.

asterism

: re­quest as­ter­ism) as a sec­tion mark.

preskip

: Amount of space printed be­fore the sec­tion mark. It should be a di­men­sion unit sup­ported by .

postskip

: Sim­i­lar to preskip, but it is a space printed af­ter the sec­tion mark.

skip

: Set both preskip and postskip to the same value.

style

: com­mands for font style change, like \bfseries, for ex­am­ple.

Com­mands

\sectionbreak[<mark>]

: print the sec­tion break. Op­tional ar­gu­ment can con­tain con­tent which should be printed in the break cen­ter.

\sectionbreakmark{<mark>}

: set the con­tent printed in the fol­low­ing \sectionbreak com­mands.

\asterism

: print the as­ter­ism (as­ter­ism) sym­bol.

The tex4ht sup­port

The sectionbreak pack­age has sup­port for tex4ht, so it is pos­si­ble to use this pack­age in con­ver­sion to HTML or other for­mats sup­ported by this con­ver­sion sys­tem. It pro­vides the fol­low­ing con­fig­u­ra­tions:

\Configure{sectionbreak}{before section break }{after section}

: this con­fig­u­ra­tion can be used for in­ser­tion of a box around the sec­tion break mark, which can be styled us­ing CSS to print the blank space around the con­tent.

\Configure{asterism}{code which replaces the asterism symbol}

: the as­ter­ism sym­bol is con­fig­ured to use Uni­code for it's ren­der­ing by de­fault. This method might be un­sup­ported by some de­vices like e-Ink read­ers, so it is pos­si­ble to set a dif­fer­ent code us­ing this con­fig­u­ra­tion.

Ex­am­ple

\documentclass[12pt]{article}
\usepackage[asterism]{sectionbreak}
\begin{document}

Section separated by three exclamation 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}

% % # Li­cense This pack­age is copy­right 2017--2018 Michal Hoftich. It may be dis­tributed and/or mod­i­fied un­der the con­di­tions of the [LaTeX Project Public Li­cense](http://www.la­tex-project.org/lppl.txt), ei­ther ver­sion 1.3 of this li­cense or (at your op­tion) any later ver­sion. This work has the LPPL main­te­nance sta­tus `main­tained'.

Down­load the con­tents of this pack­age in one zip archive (50.9k).

sec­tion­break – sup­port for sec­tion breaks

This pack­age pro­vides sup­port for sec­tion breaks, used mainly in fic­tion books to sig­nal changes in a story, like changes in time, lo­ca­tion, etc. It sup­ports the as­ter­ism sym­bol, text con­tent, or cus­tom macros as the sec­tion break mark sym­bol.

Pack­agesec­tion­break
Bug trackerhttps://github.com/michal-h21/sec­tion­break/is­sues
Re­pos­i­toryhttps://github.com/michal-h21/sec­tion­break
Ver­sion0.1d 2019-03-11
Li­censesThe Project Public Li­cense 1.3
Copy­right2017–2018 Michal Hoftich
Main­tainerMichal Hoftich
Con­tained inTeX Live as sec­tion­break
MiKTeX as sec­tion­break
TopicsDec­o­ra­tion
Head­ings
...
Guest Book Sitemap Contact Contact Author