summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tableof/README.md
blob: 59068fe241cb5908474487f855ba6a2ca2c8ef50 (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
Abstract
========

- Package: tableof (Tables of tagged contents)
- Version: 1.3 (2015/02/11)
- License: LPPL 1.3c
- Copyright (C) 2012-2015 Jean-Francois Burnol <jfbu at free dot fr>

The commands `\toftagstart`, `\toftagstop`, `\toftagthis`,
`\tofuntagthis` are used to tag chapters or sections. Then:

    \nexttocwithtags{required1, requ.2, ...}{excluded1, excl.2, ...}
    \tableofcontents % or equivalent command
	  
specifies which tags are to be required and which ones are to be
excluded from the typeset TOC.

For document with classes where `\tableofcontents` is only single-use,
the package provides:

    \tableoftaggedcontents{required1, requ.2, ...}{excluded1, excl.2, ...}

which does not have this restriction.


Installation
============

    latex tableof.dtx or pdflatex tableof.dtx

Run twice to get the bookmarks right. `tableof.sty`, `tableof.ins` and
`tableoftest.tex` are generated on the first latex run. Move `tableof.sty` to
a suitable location within the TeX installation:

    tableof.sty -> <TDS>/tex/latex/tableof/

`tableof.ins` is for TeX distributions expecting it.

`tableoftest.tex` is an example of use of the package commands. Run
latex twice on it to see examples of tagged tables of contents.


Change History
==============

* v1.3 (2015/02/11) spaces now allowed in tags.

* v1.2 (2013/03/04) added command `\tableoftaggedcontents`.

* v1.1 (2012/12/13) added command `\nexttocwithtags`.

* v1.0 (2012/12/06)


License
=======

    This Work may be distributed and/or modified under the
    conditions of the LaTeX Project Public License, either
    version 1.3c of this license or (at your option) any later
    version. 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>