diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/textpos/textpos.html |
Initial commit
Diffstat (limited to 'macros/latex/contrib/textpos/textpos.html')
-rw-r--r-- | macros/latex/contrib/textpos/textpos.html | 254 |
1 files changed, 254 insertions, 0 deletions
diff --git a/macros/latex/contrib/textpos/textpos.html b/macros/latex/contrib/textpos/textpos.html new file mode 100644 index 0000000000..eec9629d6b --- /dev/null +++ b/macros/latex/contrib/textpos/textpos.html @@ -0,0 +1,254 @@ +<?xml version="1.0"?> +<html xmlns="http://www.w3.org/1999/xhtml"> +<head profile="http://dublincore.org/documents/dcq-html/"> +<title>Textpos</title> +<meta name="DC.subject" content="latex, textpos, absolute positioning"/> +<meta name="DC.title" content="Textpos"/> +<meta name="DC.date" content="2019-04-15"/> +<link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"/> +<link href="https://nxg.me.uk/norman" rev="author"/> +<link type="text/css" rel="stylesheet" href="style.css"/> +</head> + +<body> +<h1>Textpos</h1> +<div class="abstract"> +<p>Lay out text and graphics at arbitrary positions on the LaTeX page.</p> + +<p> + +<span class="distpage">The textpos home page is at +<a href="http://purl.org/nxg/dist/textpos"><code>http://purl.org/nxg/dist/textpos</code></a>;</span> +please quote this URL rather than the URL it resolves to.</p> +<p>Version 1.9.1, 2019 April 15.</p> +</div> + +<p>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 <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=abspos">TeX FAQ +entry on absolute positioning</a>.</p> + +<p>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 <a href="textpos.pdf">manual (pdf)</a>.</p> + +<p>An article describing Textpos appeared in TUGboat in 2002: +<a href="http://www.tug.org/TUGboat/tb23-3-4/tb75gray.pdf">Norman Gray, <em>Absolute Positioning with Textpos</em>, +TUGboat <strong>23</strong> (3/4), pp341–4, 2002.</a></p> + +<p>I have a collection of general advice about <a href="http://purl.org/nxg/note/posters">creating +conference posters with LaTeX</a>.</p> + +<p>Rolf Niepraschk provided me with a wonderful demo +(<a href="niepraschk-eso-pic.tex">tex</a>, +<a href="niepraschk-eso-pic.pdf">pdf</a>) +of using Textpos along with his <code>eso-pic</code> package, +and the <code>calc</code> package, to produce a grid which can help lay out +material on the page.</p> + +<p>The source is held at +<a href="https://bitbucket.org/nxg/textpos">bitbucket</a>, +and there is an issues list there, for bug reports.</p> + + +<div class="distpage"> + <h2>Installation and further information</h2> +</div> + +<ol> + + + +<li>Run LaTeX on the file <code>textpos.ins</code> – this will +unpack the style file <code>textpos.sty</code> amongst other files. +Place this somewhere where TeX can find it.</li> + +<li>Run LaTeX on the file <code>textpos.dtx</code> to obtain the +documentation.</li> +</ol> + +<p class="distpage">The <code>textpos</code> home page is at <a href="http://purl.org/nxg/dist/textpos"><code>http://purl.org/nxg/dist/textpos</code></a>, and there may be more up-to-date versions available there.</p> + +<p><code>Textpos</code> is also available on CTAN: +<a href="https://www.ctan.org/pkg/textpos">macros/latex/contrib/textpos/</a></p> + + + +<h2>History</h2> + +<dl> +<dt><strong>1.9.1, 2019 April 15</strong></dt> +<dd> +<ul> +<li>Added the <code>\TPReferencePosition</code> command, to change the +default reference position away from <code>[0,0]</code>.</li> +<li>Added the <em>experimental</em> +<code>\TPoptions{discardcontent=true}</code> option, to improve +compatibility with TikZ +(see <a href="https://bitbucket.org/nxg/textpos/issues/6/">issue 6 in the repository</a>). +Note: <em>This option may change or disappear in future versions</em>, and the author would be +particular interested to get feedback regarding it.</li> +<li>Documentation: added discussion of the implementation difference +between relative and absolute mode, and when one is preferable to the other.</li> +<li>Documentation: note that the showboxes option is intended only as +a basic aid to layout.</li> +<li>(Version 1.9 was partially released, but it contained an +attribution error which could be most easily fixed by a minor version bump).</li> +</ul> +</dd> + +<dt>1.8, 2016 June 5</dt> +<dd><ul> +<li>Added the <code>\TPoptions</code> command, to switch modes on and +off within the document. Various documentation tweaks.</li> +<li>The behaviour of <code>\TPMargin</code> and +<code>\TPMargin*</code> were somewhat underspecified in versions of +Textpos before v1.8, and in consequence inconsistently implemented. +This has now been rationalised, but the change <em>may</em> change +documents which relied on the previous behaviour. +Thanks to Richard Schreiber for the detailed bug report.</li> +<li>In this release, I switched to more conventional dotted-integer, n.m.r, +version numbers, from the LaTeX-style model with intermediate releases denoted by letters.</li> +</ul></dd> + +<dt>1.7j, 2014 January 3</dt> +<dd>Re-released under the LPPL.</dd> + +<dt>1.7i, 2012 November 10</dt> +<dd>Bugfix: further change to the way the {color} package is loaded +(fixes issue 2); now finally fixed?</dd> + +<dt>1.7h, 2012 June 1</dt> +<dd>Bugfix: further change to the way the {color} package is loaded. +Some documentation tweaks. +Pointers to bitbucket repository.</dd> + +<dt>1.7g, 2010 September 30</dt> +<dd>Bugfix: change the way we handle the {color} package not being +loaded – replacement <code>\color</code> command is now robust. +Thanks to Joseph Wright for the bugreport. +Also adjusted documentation of reference points.</dd> + +<dt>1.7f, 2009 May 28</dt> +<dd>The change in behaviour introduced in v1.7e is now documented (it +was unspecified before, and 1.7e didn't commit itself one way or the +other).</dd> + +<dt>1.7e, 2009 March 29</dt> +<dd>Daniel Richard G noted that the order in which textblock contents +was laid down on the page was counter-intuitive, since one would +expect that later environments go 'on top of' earlier ones. This +order was unspecified before this version, but I've changed this, +satisfying a principle of least surprise (later ones now go 'on +top').</dd> + +<dt>1.7d, 2007 March 30</dt> +<dd>Axel Sommerfeldt suggested a further alternative approach, even more +lightweight, and I incorporated a version of that.</dd> + +<dt>1.7c, 2007 March 29</dt> +<dd>Giovanni Radilla reported a problem with captions, which meant that the +captions weren't appearing properly in the list of figures. Dan +Luecking and Axel Sommerfeldt analysed the problem precisely, and the +latter provided code which I've incorporated in this fix.</dd> + +<dt>1.7b, 2007 March 21</dt> +<dd>Robert Whittaker reported a problem with <code>\TPmargin</code>, +which meant that lists and quotations (and other things which +manipulated <code>\leftskip</code> and <code>\rightskip</code>) were +not decreasing in size when you set <code>\TPmargin</code> non-zero. +Fixed.</dd> + +<dt>1.7a, 2006 September 2</dt> +<dd>Version 1.7 created an inadvertant dependency on the +<code>{color}</code> package. Now, if you do not load that package, +<code>\textblockrulecolour</code> will have no effect, rather than +failing. Textpos will give you a warning in this case, reminding you +to load the <code>{color}</code> package.</dd> + +<dt><strong>1.7, 2006 August 24</strong></dt> +<dd>Added the <code>\textblockrulecolour</code> and +<code>\TPshowboxes{true,false}</code> commands, to further control the +display of the rules around the text blocks.</dd> + +<dt>1.6b, 2006 August 10</dt> +<dd>Minor documentation fixes</dd> + +<dt>1.6a, 2005 October 13</dt> +<dd>The overriding of the figure and table environments now also works +when there is no previous environment to override.</dd> + +<dt><strong>1.6, 2005 August 30</strong></dt> +<dd>Made <code>{calc}</code>-style dimensions to the +<code>{textblock*}</code> argument work again (so <em>that's</em> what +regression tests are for...). Override the <code>figure</code> and +<code>table</code> environments within <code>textblock</code> +environments, to avoid their surprising and undesirable interaction +with <code>textblock</code>.</dd> + +<dt>1.5b, 2005 June 13</dt> +<dd>The 1.5 release broke the textblock environment's optional +argument, controlling the position of the reference point within the +block. Fixed.</dd> + +<dt>1.5a, 2005 March 26</dt> +<dd>Documentation fixes: added a section on the +interaction between absolute mode and LaTeX's <code>\newpage</code> +command.</dd> + +<dt><strong>1.5, 2005 March 23</strong></dt> +<dd>Implement <code>\TPMargin</code> 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 <code>showboxes</code> package option.</dd> + +<dt><strong>1.4, 2003 September 7</strong></dt> +<dd>Changes in the handling of vertical spacing; inconsistent in some +circumstances before. Slight (consequent) change to the algorithm +which ensures that material is output in absolute mode even when the +page is otherwise empty. See README for details. Version 1.3a will +remain available for some time in case these fixes break things.</dd> + +<dt>1.3a, 2003 June 24</dt> +<dd>Added the <code>\textblockcolour</code> command, to set +the background colour of text blocks</dd> + +<dt><strong>1.3, 2003 June 24</strong></dt> +<dd>(there was a release 1.3, but it was broken, and immediately +replaced by 1.3a)</dd> + +<dt>1.2b, 2002 July 1</dt> +<dd>Works around a bug present in at least one package, +which leaves box255 holding an hbox at the wrong moment</dd> + +<dt>1.2a, 2002 April 28</dt> +<dd>Version 1.2 had an error, which caused a confusing error +if you gave any fractional part in the arguments to the +<code>{textblock}</code> environment. This was fixed in version 1.2a, +which adds a <code>{textblock*}</code> environment (fully compatible +with <code>calc</code>), and does not attempt to support calc-style +expressions in the parameters to the unstarred +<code>{textblock}</code> environment.</dd> + +<dt><strong>1.2, 2002 April 21</strong></dt> +<dd>Rolf Niepraschk <code>niepraschk@ptb.de</code> provided code to +make textpos compatible with the <code>calc</code> package</dd> + +<dt>Version 1.1</dt> +<dd>Released in 1999</dd> + +</dl> + + +<div class="signature"> +<a href="http://nxg.me.uk">Norman Gray</a><br/> +2019 April 15 +</div> + +</body> +</html> |