summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/centeredline/README.md
blob: 90bcac8676488b86dd8e91381342d166f1059318 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<!-- -->

    Author:  Jean-Francois Burnol
    Package: centeredline
    Version: 1.0 (2019/04/27)
    License: LPPL 1.3c
    Copyright (C) 2019 Jean-Francois Burnol
    <jfbu at free dot fr>

# DESCRIPTION #

After `\usepackage{centeredline}` you can use

    \centeredline{....}

to get contents centered, in a better way than with `\centerline`:

1. `\verb` or other catcode changes are allowed,
2. the centering (with respect to the surrounding text paragraph) will
   be as expected if this all happens inside an item from a LaTeX list
   environment,
3. and material whose natural width exceeds the linewidth will get
   properly centered too.

The contents are executed in horizontal mode inside a group inside a
`\hbox`.

The macro itself maybe encountered in paragraph or in vertical mode. For
example in vertical mode

    \centeredline{\rule{\dimexpr-1cm+\paperwidth}{1pt}}
    \centeredline{\rule{\dimexpr-1cm+\paperwidth}{1pt}}
    \centeredline{\rule{\dimexpr-1cm+\paperwidth}{1pt}}

will create horizontally centered on the page horizontal rules
vertically separated by the baseline skip and ignoring the parskip.


# HISTORY #

I have used this macro since 2013 and it has served me well.

I am making it public as is, without any re-thinking about whether it may
have some limitations which I somehow did not encounter in my personal usage.
Suggestions for improvements are welcome, and will be recorded although I do
not expect to update the package anytime soon.


# CHANGE LOG #

- v1.0 (2019/04/27): First release.


# LICENSE #

This Work may be distributed and/or modified under the
conditions of the LaTeX Project Public License 1.3c.
This version of this license is in

> <http://www.latex-project.org/lppl/lppl-1-3c.txt>

and the latest version of this license is in

> <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.

The Author of this Work is:

> Jean-Francois Burnol `<jfbu at free dot fr>`

This Work consists of the file `centeredline.sty` and
accompanying `README.md`.