summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/textpos/README
blob: a7b0a50ec959a13f5e48e729da25ac5773c06bb3 (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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205

Textpos: absolute positioning of text on the LaTeX page
-------------------------------------------------------

Version 1.6a

This package facilitates placing boxes at absolute positions on the
LaTeX page.  There are several reasons why this might be useful, but
the main one (or at least my motivating one) is to help produce a
large-format conference poster.  

This package provides a single environment, plus a starred variant,
which contains the text (or graphics, or table, or whatever) which is
to be placed on the page, and which specifies where it is to be
placed.  The environment is accompanied by various configuration commands.

Changes in 1.6a, 2005 October 13
--------------------------------

The overriding of the figure and table environments now also works
when there is no previous environment to override (blush).


Changes in 1.6, 2005 August 30
------------------------------

* Made {calc}-style dimensions to the {textblock*}
  argument work again.
* Override the figure and table environments within textblock
  environments, to avoid their surprising and undesirable interaction
  with textblock.

Changes in 1.5a, 2005 March 26
------------------------------

Documentation fixes: added a section on the interaction between
absolute mode and LaTeX's \newpage command.
  
Changes in 1.5, 2005 March 23
-----------------------------

Implement \TPMargin command, which causes a margin
to appear round the blocks of text within textblock
environments.  This makes it easy to use blocks of colour which
are larger than the block of text by a decent margin, or to put a
border round textblocks by setting a suitably-sized margin and using
the showboxes package option.

Changes in v1.4, 7 September 2003
---------------------------------

* I made some changes in the handling of vertical spacing before and
after the {textblock} environment.  The environment claims not to affect
the vertical spacing (that is, to be `invisible'), and this was not
true in some circumstances.  There should be no difference in the
spacing which results in absolute mode, though there might be some
changes in relative mode _if_ the environment is surrounded by glue of
one type or another.

* Now {textblock} may be used in horizontal mode.  The behaviour
hasn't changed at all in fact (insert a \par), except that the
warning in this case has been removed, and the behaviour has been
documented.  It is this which prompted the reexamination of the
spacing around the environment, referred to above.

* Slight change to the technique which ensures that material is output
in absolute mode even when (as normal in that mode) there is no
non-{textblock} material on the page.  I believe this is perfectly
robust, but if you discover any error in this respect, it's probably
this version it was introduced.

Changes in v1.3a, 25 June 2003
------------------------------

Blush.  I was prompted to run the regression tests (so _that's_ what
they're for), and this fixes the error they expose.  You may now use
textpos _without_ loading the {color} package.

Changes in v1.3, 25 June 2003
-----------------------------

Added \textblockcolour command, to set the background colour of textblocks.

Changes in v1.2b, 1 July 2002
-----------------------------

Added code to cope with the case when box 255 isn't a vbox at shipout
(that's wrong, and not our fault, but we shouldn't collapse when it
happens!).  Thanks to Wybo Dekker and Hans Hagen for the report and
the fix.


Changes in v1.2a, 28 April 2002
-------------------------------

The way that I implemented the {calc} compatibility was wrong in v1.2
(Rolf's code was correct, but I `improved' it).  It meant that things
went badly wrong if you tried to give fractional sizes in the
dimensions arguments to the {textblock} environment (I choose the grid 
so that I only ever use whole numbers for these, so I hadn't had any
real numbers in my test cases).  There's now a {textblock*}
environment, which has absolute dimensions (that is, not in terms of
the module, though you can still use \TPHorizModule and \TPVertModule
as dimensions), to which you can give calc-compatible dimensions if
you wish.  You can't give expressions in the arguments to the
unstarred {textblock} environment.

Changes in  v1.2, 21 April 2002
-------------------------------

Rolf Niepraschk <niepraschk@ptb.de> provided code to make textpos
compatible with the {calc} package.

Added the [verbose] and [quiet] package options.

Changes in v1.1e, 19 April 2001
-------------------------------

Corrected a spacing misfeature, which caused extra space when
textblocks were interspersed with paragraphs.  Thanks to Peter
Muenster <peter@univ-rennes1.fr> for spotting and reporting this.

Changes in v1.1d, 6 June 1999
-----------------------------

Clarified the copyright and licence status, including a copy of the
GPL in the distribution.  The immediate motivation was the CTAN
campaign to do this for all the CTAN packages, but it should have been
done before.

Changes in v1.1c
----------------

Added an optional argument to \TPGrid, which controls a border round
the grid.  Made the checksum correct!

Added the `overlay' option.

Corrected a spacing bug, which made textblocks in the non-`absolute'
mode drift out of place.

Changes in v1.1b
----------------

Added a note to the effect that the required everyshi package can also
be found at CTAN

Changes in v1.1a
----------------

Blush!  The example file distributed with the package exposed a bug!
When there was no text on the page outside {textblock} blocks (the
usual case, if you're producing a poster), the TeX engine didn't know
there was anything on the page at all, and (sensibly) output nothing.
I made the obvious fix (thanks to Bjoern Pedersen for diagnosing the
problem, and to Wolfgang Erdmann <earthmen@mail1.cityweb.de> for
reporting it so promptly).


Changes in v1.1, and credits
----------------------------

The package now clearly distinguishes between a `relative' and an
`absolute' mode of positioning text (the distinction was largely
present before, but neither as clear nor as robust).  It also now
distinguishes the horizontal and vertical units used for positioning.

Olaf Maibaum (Olaf.Maibaum@informatik.uni-oldenburg.de)
produced the elegant code which I've incorporated here as the
`absolute mode'.

Bjoern Pedersen (bjoern@poseidon.org.chemie.tu-muenchen.de)
made the excellent suggestion (including code) that the horizontal and
vertical modules should be independent.


Installation
------------

Download the files textpos.dtx and textpos.ins.  Run LaTeX on the file
textpos.ins -- this will create the files

    textpos.sty
    textpos.drv

Install textpos.sty somewhere TeX will find it.  Run LaTeX on file
textpos.drv to produce instructions and documentation.

This package requires the services of Martin Schr\"oder's package
everyshi.  You will need to download this package from CTAN first.  See
\url{http://www.tex.ac.uk/tex-archive/macros/latex/contrib/supported/ms/} 
or one of the other CTAN hosts.

Licence
-------

This software is copyright, 1999, 2001--2003, 2005, Norman Gray.  It
is released under the terms of the GNU General Public Licence.  See
the copyright declaration at the top of file textpos.dtx, and the file
LICENCE for the licence conditions.



Norman Gray, (norman@astro.gla.ac.uk)
http://www.astro.gla.ac.uk/users/norman