summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tableof/README.md
blob: 99e7b661304e5cf6d4cd96dd9c3159b9f2e226b2 (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
75
76
77
78
79
80
81
82
83
84
Abstract
========

- Package: tableof (Tables of tagged contents)
- Version: 1.4 (2015/02/20)
- 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, sections or any other sectioning units destined
to end up in the table(s) of contents. Then:

    \nexttocwithtags{req. 1, req. 2, ... }{excl. 1, 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 documents with classes where `\tableofcontents` is only single-use,
the package provides:

    \tableoftaggedcontents{req. 1, req. 2, ... }{excl. 1, excl. 2, ... }

which does not have this restriction.


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

For extracting the style file:

    latex tableof.dtx

Files `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/

To produce the documentation:

    latex tableof.dtx (a second time)
    dvipdfmx tableof.dvi

`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.4 (2015/02/20) under the hood code improvements.

* v1.3 (2015/02/11) comma separated lists of tags now allow spaces.

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

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

* v1.0 (2012/12/06) first release.


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>