From 29b2df230459512a0f73e5769a1cfc16e4125510 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 9 Jun 2016 22:53:55 +0000 Subject: textpos (8jun16) git-svn-id: svn://tug.org/texlive/trunk@41331 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/textpos/README | 6 +- Master/texmf-dist/doc/latex/textpos/VERSION-1.7j | 1 - Master/texmf-dist/doc/latex/textpos/VERSION-1.8 | 1 + .../doc/latex/textpos/examples/README-examples | 11 -- .../doc/latex/textpos/examples/README.examples | 11 ++ .../texmf-dist/doc/latex/textpos/examples/t10.tex | 46 ++++++++ .../texmf-dist/doc/latex/textpos/examples/t6.tex | 10 +- .../texmf-dist/doc/latex/textpos/examples/t9.tex | 67 ++++++++++++ .../doc/latex/textpos/textpos-example.tex | 4 +- Master/texmf-dist/doc/latex/textpos/textpos.html | 116 +++++++++++---------- Master/texmf-dist/doc/latex/textpos/textpos.pdf | Bin 239198 -> 255281 bytes 11 files changed, 200 insertions(+), 73 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/textpos/VERSION-1.7j create mode 100644 Master/texmf-dist/doc/latex/textpos/VERSION-1.8 delete mode 100644 Master/texmf-dist/doc/latex/textpos/examples/README-examples create mode 100644 Master/texmf-dist/doc/latex/textpos/examples/README.examples create mode 100644 Master/texmf-dist/doc/latex/textpos/examples/t10.tex create mode 100644 Master/texmf-dist/doc/latex/textpos/examples/t9.tex (limited to 'Master/texmf-dist/doc/latex/textpos') diff --git a/Master/texmf-dist/doc/latex/textpos/README b/Master/texmf-dist/doc/latex/textpos/README index b4ffc126aac..f5217dcc6f4 100644 --- a/Master/texmf-dist/doc/latex/textpos/README +++ b/Master/texmf-dist/doc/latex/textpos/README @@ -2,12 +2,12 @@ Textpos: absolute positioning of text on the LaTeX page ------------------------------------------------------- -Version 1.7j, 2014 January 3 +Version 1.8, 2016 June 7 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. +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 @@ -36,7 +36,7 @@ or one of the other CTAN hosts. Licence ------- -This software is copyright, 1999, 2001--2003, 2005-7, 2009-12, 2014, Norman Gray. +This software is copyright, 1999, 2001-03, 2005-7, 2009-12, 2014-16., Norman Gray. It is released under the terms of the [LaTeX Project Public License][lppl], which is included in the file LICENCE. diff --git a/Master/texmf-dist/doc/latex/textpos/VERSION-1.7j b/Master/texmf-dist/doc/latex/textpos/VERSION-1.7j deleted file mode 100644 index 5dfd917b354..00000000000 --- a/Master/texmf-dist/doc/latex/textpos/VERSION-1.7j +++ /dev/null @@ -1 +0,0 @@ -textpos-1.7j, released 2014 January 3 diff --git a/Master/texmf-dist/doc/latex/textpos/VERSION-1.8 b/Master/texmf-dist/doc/latex/textpos/VERSION-1.8 new file mode 100644 index 00000000000..c152fe5986f --- /dev/null +++ b/Master/texmf-dist/doc/latex/textpos/VERSION-1.8 @@ -0,0 +1 @@ +textpos-1.8, released 2016 June 7 diff --git a/Master/texmf-dist/doc/latex/textpos/examples/README-examples b/Master/texmf-dist/doc/latex/textpos/examples/README-examples deleted file mode 100644 index 16b23fb6977..00000000000 --- a/Master/texmf-dist/doc/latex/textpos/examples/README-examples +++ /dev/null @@ -1,11 +0,0 @@ -The t?.tex files in this directory are intended as regression tests, -rather than strictly as examples. They nonetheless serve to illustrate -some of what textpos can do. - -Not all of them actually work, as regression tests, right now, but -this is because when comparing binary formats such as .dvi files, -it's not always completely obvious what counts as a significant -change. Any comments and suggestions would be welcome. - -Norman -2006 September 2 diff --git a/Master/texmf-dist/doc/latex/textpos/examples/README.examples b/Master/texmf-dist/doc/latex/textpos/examples/README.examples new file mode 100644 index 00000000000..16b23fb6977 --- /dev/null +++ b/Master/texmf-dist/doc/latex/textpos/examples/README.examples @@ -0,0 +1,11 @@ +The t?.tex files in this directory are intended as regression tests, +rather than strictly as examples. They nonetheless serve to illustrate +some of what textpos can do. + +Not all of them actually work, as regression tests, right now, but +this is because when comparing binary formats such as .dvi files, +it's not always completely obvious what counts as a significant +change. Any comments and suggestions would be welcome. + +Norman +2006 September 2 diff --git a/Master/texmf-dist/doc/latex/textpos/examples/t10.tex b/Master/texmf-dist/doc/latex/textpos/examples/t10.tex new file mode 100644 index 00000000000..3c8677353d8 --- /dev/null +++ b/Master/texmf-dist/doc/latex/textpos/examples/t10.tex @@ -0,0 +1,46 @@ +%%% Testing:interactions between (x,y)-positioning and \TPMargin +% See https://bitbucket.org/nxg/textpos/issues/3/ +% Thanks to Richard Schreiber for the report and initial test code. + +\documentclass{minimal} +\usepackage[top=0mm,bottom=0mm,left=0mm,right=0mm,a5paper]{geometry} +\usepackage{color} +\usepackage[absolute,showboxes]{textpos} + +\parindent0mm +\begin{document} + +\textblockrulecolour{magenta} +\TPGrid[0mm,0mm]{6}{9}% +\TPMargin{5mm}% + +\null\vskip 4cm +\noindent \hrule width 2\TPHorizModule +\smallskip +\hbox to 2\TPHorizModule{$\leftarrow$\hfil two units wide\hfil $\rightarrow$} + +\begin{textblock}{2}(0,0) + This box is top-left. + The top and left margin lines touch the edge of the page. +\end{textblock} + +\begin{textblock}{2}[0,1](0,9) + This box should sit at the bottom left. + The box should be two units wide, and the text correspondingly narrower. + The bottom and left margin lines should touch the edge of the page. +\end{textblock} + +\TPMargin*{5mm} +\begin{textblock}{2}[1,0](6,0) + This box should sit at the top right of the page, and the text + should be two units wide. The top and right margin lines should be + off the page. +\end{textblock} + +\TPMargin{0mm}% +\begin{textblock}{2}[1,1](6,9) + This box sits at the bottom right edge. + The text and box are two units wide. + The bottom and right margin lines touch the edge of the page. +\end{textblock} +\end{document} diff --git a/Master/texmf-dist/doc/latex/textpos/examples/t6.tex b/Master/texmf-dist/doc/latex/textpos/examples/t6.tex index 93e3cefaeb9..5c479987b65 100644 --- a/Master/texmf-dist/doc/latex/textpos/examples/t6.tex +++ b/Master/texmf-dist/doc/latex/textpos/examples/t6.tex @@ -20,15 +20,21 @@ Blue \end{textblock} -\begin{textblock}{8}(14,0) +\begin{textblock}{12}(4,-1) + \hrule width 12\TPHorizModule + \vbox to 0pt{\hbox{12 units}\vss} + \vskip1\TPVertModule \hrule width 8\TPHorizModule + \vbox to 0pt{\hbox{8 units}\vss} \vskip1\TPVertModule \hrule width 4\TPHorizModule + \vbox to 0pt{\hbox{4 units}\vss} \vskip1\TPVertModule \hrule width 2\TPHorizModule + \vbox to 0pt{\hbox{2 units}\vss} \vskip1\TPVertModule \hrule width 1\TPHorizModule -\end{textblock} +\end{textblock} \begin{textblock}{12}(4,4) This text is inside a box with a blue background. The text is flush diff --git a/Master/texmf-dist/doc/latex/textpos/examples/t9.tex b/Master/texmf-dist/doc/latex/textpos/examples/t9.tex new file mode 100644 index 00000000000..b86cf388929 --- /dev/null +++ b/Master/texmf-dist/doc/latex/textpos/examples/t9.tex @@ -0,0 +1,67 @@ +%%% Testing: switching between absolute and relative mode + +\documentclass{article} + +\usepackage[absolute,showboxes]{textpos} +\setlength{\parindent}{0pt} +\TPHorizModule=1cm +\TPVertModule=1cm + +\begin{document} + +Here is some text, which appears in the body of the page. +\begin{textblock}{5}(0,0) +This text is at (0,0), and should appear at the very top-left corner. +\end{textblock} + +Here is more text, which also appears in the body. +\begin{textblock}{5}(1,1) +This text is at (1,1), and should appear near the top-left corner, 1cm +in and down. +\end{textblock} + +\newpage +\TPoptions{ absolute=false, + showboxes = false} + +Here is some text, which appears in the body of page two. +\begin{textblock}{5}(0,0) +This text is at (0,0), and appears at the top-left of the text block, +just under `Here is some text'. +It should not have a box around it. +\end{textblock} + +\vskip4cm +Here is more text, which also appears in the body of p.2. +\begin{textblock}{5}(1,1) +This text is at (1,1), and also appears in the text block 1cm along +and down from the `Here is more text', and without a surrounding box. +\end{textblock} + +\TPoptions{absolute=true, showboxes=true, showtext=false} + +\vskip4cm +Text. The corresponding text block should appear only as a box, with +no text inside it. It appears in the top-left corner of the page. +\begin{textblock}{5}(0,0) +This text should not appear (just the box, positioned 2cm along and +down from `Text.' +\end{textblock} + +\TPoptions{absolute=false, showboxes=true, showtext=true} + +\vskip4cm +Text 2. +\begin{textblock}{5}(6,0) +This text should appear surrounded by a box, level with, but along from, `Text 2'. +\end{textblock} + +\newpage +\TPoptions{absolute=true} + +Page 3. +\begin{textblock}{5}(0,0) +This text appears at the extreme top-left of page three. +\end{textblock} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/textpos/textpos-example.tex b/Master/texmf-dist/doc/latex/textpos/textpos-example.tex index 0b7ab253308..1f8f44f7997 100644 --- a/Master/texmf-dist/doc/latex/textpos/textpos-example.tex +++ b/Master/texmf-dist/doc/latex/textpos/textpos-example.tex @@ -7,7 +7,7 @@ %% textpos.dtx (with options: `example') %% Textpos: absolute positioning of text on the page %%%% File: textpos.dtx -%%%% Copyright 1999, 2001--2003, 2005-7, 2009-12, 2014, Norman Gray +%%%% Copyright 1999, 2001-03, 2005-7, 2009-12, 2014-16., Norman Gray %% %% This work may be distributed and/or modified under the %% conditions of the LaTeX Project Public License, either version 1.3 @@ -29,7 +29,7 @@ %% %% See the file LICENCE for a copy of the LPPL. %% -%% Mercurial ident: 41b12ce5565c, 2014-01-03 19:15 +0000 +%% Mercurial ident: 8aa202e2b283, 2016-06-07 23:52 +0100 %% \documentclass{article} diff --git a/Master/texmf-dist/doc/latex/textpos/textpos.html b/Master/texmf-dist/doc/latex/textpos/textpos.html index 8ef009c7242..ebc494edc96 100644 --- a/Master/texmf-dist/doc/latex/textpos/textpos.html +++ b/Master/texmf-dist/doc/latex/textpos/textpos.html @@ -1,65 +1,97 @@ - Textpos - - - - - - - + + + + + +

Textpos

Lay out text and graphics at arbitrary positions on the LaTeX page.

-

The textpos home page is at http://purl.org/nxg/dist/textpos; + +

+ +The textpos home page is at +http://purl.org/nxg/dist/textpos; please quote this URL rather than the URL it resolves to.

-

Version 1.7j, 2014 January 3.

+

Version 1.8, 2016 June 7.

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. Other applications include placing -material within, say, figures. Textpos is also discussed in the TeX FAQ +material within, say, figures. Textpos is also discussed in the TeX FAQ entry on absolute positioning.

This package provides a single environment, 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. See the manual (pdf).

+is accompanied by various configuration commands. See the manual (pdf).

An article describing Textpos appeared in TUGboat in 2002: -Norman Gray, Absolute Positioning with Textpos, +Norman Gray, Absolute Positioning with Textpos, TUGboat 23 (3/4), pp341–4, 2002.

-

I have a collection of general advice about creating +

I have a collection of general advice about creating conference posters with LaTeX.

Rolf Niepraschk provided me with a wonderful demo -(tex, -pdf) +(tex, +pdf) of using Textpos along with his eso-pic package, and the calc package, to produce a grid which can help lay out material on the page.

The source is held at -bitbucket, +bitbucket, and there is an issues list there, for bug reports.

-

History

+ +
+

Installation and further information

+
+ +
    + + + +
  1. Run LaTeX on the file textpos.ins – this will +unpack the style file textpos.sty amongst other files. +Place this somewhere where TeX can find it.
  2. + +
  3. Run LaTeX on the file textpos.dtx to obtain the +documentation.
  4. +
+ +

The textpos home page is at http://purl.org/nxg/dist/textpos, and there may be more up-to-date versions available there.

+ +

Textpos is also available on CTAN: +/tex-archive/macros/latex/contrib/textpos/

+ + + +

History

+
1.8, 2016 June 5
+
    +
  • Added the \TPoptions command, to switch modes on and +off within the document. Various documentation tweaks.
  • +
  • The behaviour of \TPMargin and +\TPMargin* were somewhat underspecified in versions of +Textpos before v1.8, and in consequence inconsistently implemented. +This has now been rationalised, but the change may change +documents which relied on the previous behaviour. +Thanks to Richard Schreiber for the detailed bug report.
  • +
+
1.7j, 2014 January 3
Re-released under the LPPL.
@@ -74,7 +106,7 @@ Pointers to bitbucket repository.
1.7g, 2010 September 30
Bugfix: change the way we handle the {color} package not being -loaded -- replacement \color command is now robust. +loaded – replacement \color command is now robust. Thanks to Joseph Wright for the bugreport. Also adjusted documentation of reference points.
@@ -175,7 +207,7 @@ which leaves box255 holding an hbox at the wrong moment
1.2a, 2002 April 28
Version 1.2 had an error, which caused a confusing error if you gave any fractional part in the arguments to the -{textblock} environment. This was fixed in version 1.2a, +{textblock} environment. This was fixed in version 1.2a, which adds a {textblock*} environment (fully compatible with calc), and does not attempt to support calc-style expressions in the parameters to the unstarred @@ -185,40 +217,16 @@ expressions in the parameters to the unstarred
Rolf Niepraschk niepraschk@ptb.de provided code to make textpos compatible with the calc package
-
Version 1.1 was released in 1999
+
Version 1.1
+
Released in 1999
-

Installation and further information

- -
    - -
  1. Run LaTeX on the file textpos.ins -- this will -unpack the style file textpos.sty amongst other files. -Place this somewhere where TeX can find it.
  2. - -
  3. Run LaTeX on the file textpos.dtx to obtain the -documentation.
  4. -
- -

The textpos home page is at http://purl.org/nxg/dist/textpos, and there may be more -up-to-date versions available there.

- -

Textpos is also available on CTAN: -/tex-archive/macros/latex/contrib/textpos/

-
-Norman Gray
-2014 January 3 +Norman Gray
+2016 June 7
- - - - - diff --git a/Master/texmf-dist/doc/latex/textpos/textpos.pdf b/Master/texmf-dist/doc/latex/textpos/textpos.pdf index 285d5746816..12c9d0ca19a 100644 Binary files a/Master/texmf-dist/doc/latex/textpos/textpos.pdf and b/Master/texmf-dist/doc/latex/textpos/textpos.pdf differ -- cgit v1.2.3