diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/textpos/textpos.dtx')
| -rw-r--r-- | Master/texmf-dist/source/latex/textpos/textpos.dtx | 97 |
1 files changed, 70 insertions, 27 deletions
diff --git a/Master/texmf-dist/source/latex/textpos/textpos.dtx b/Master/texmf-dist/source/latex/textpos/textpos.dtx index 44a2141c1f4..9e29d4df826 100644 --- a/Master/texmf-dist/source/latex/textpos/textpos.dtx +++ b/Master/texmf-dist/source/latex/textpos/textpos.dtx @@ -2,7 +2,7 @@ % This is textpos.dtx, which allows you to place text (and graphics) % anywhere on the LaTeX page. It's useful for posters. % -%% This software is copyright, 1999, 2001--2003, 2005 Norman Gray. +%% This software is copyright, 1999, 2001--2003, 2005, 2006 Norman Gray. %% %% This program is free software; you can redistribute it and/or %% modify it under the terms of the GNU General Public License @@ -24,15 +24,15 @@ %% See the file LICENCE for a copy of the GPL. %% You can also find an online copy at http://www.gnu.org/copyleft/gpl.html . %% -%<+package|driver|example>%%% Source: $Id: textpos.dtx.in,v 1.8 2006/08/10 21:40:56 norman Exp $ +%<+package|driver|example>%%% Source: $Id: textpos.dtx.in,v 1.9 2006/08/24 13:59:21 norman Exp $ %% %<*package|driver> %%\def\ParseRCSDate$#1: #2 #3 ${\def\TP@Date{#2}} -%%\ParseRCSDate$Date: 2006/08/10 21:40:56 $ +%%\ParseRCSDate$Date: 2006/08/24 13:59:21 $ \def\filename{textpos} -\def\fileversion{1.6b} -\def\filedate{2006/08/10} -\def\docdate{2006 August 10} +\def\fileversion{1.7} +\def\filedate{2006/08/24} +\def\docdate{2006 August 24} %</package|driver> %<+package>\NeedsTeXFormat{LaTeX2e} %<+package>\ProvidesPackage{textpos}[\filedate\space v\fileversion] @@ -351,7 +351,8 @@ % |\textblockcolour{|\meta{colour}|}| % \end{quote} % all text blocks following will have their background filled with the -% specified colour, which has to be declared, as usual, in a +% specified colour, which must be one of the standard colours or have +% been declared in a % |\definecolor| declaration in the document preamble. This colour % may be overridden for individual text blocks by giving this command % within the \Lenv{textblock} environment. If you wish a block not to @@ -359,12 +360,26 @@ % at a time, with the command |\textblockcolour{}| inside the % \Lenv{textblock} environment. % +% \DescribeMacro{\textblockrulecolour} +% You can similarly change the colour of the borders around the text +% block. If you give the command +% \begin{quote} +% |\textblockrulecolour{|\meta{colour}|}| +% \end{quote} +% then following text blocks will have their border in the given +% colour, which must again be either one of the standard ones of +% declared in the document preamble. +% % \DescribeMacro{\textblockcolor} % For the benefit of those who observe Webster's spelling % reforms, |\textblockcolor| is defined as a synonym for % |\textblockcolour|, but those who would condemn such anaemic half measures % \DescribeMacro{\tekstblokkulur} % can use |\tekstblokkulur| instead. +% \DescribeMacro{\textblockrulecolor} +% \DescribeMacro{\tekstblokroolkulur} +% There are also the corresponding spelling-reform variants of +% |\textblockrulecolour|. % % \subsection{Package options} % \label{packopts} @@ -373,7 +388,9 @@ % \begin{description} % \item[\Lopt{showboxes}]When you are laying things out, it can be % useful to have the boxes drawn in for you. This option draws a box -% fitting closely round the set text. +% fitting closely round the set text. You can turn this on and off +% within the file using the |\TPshowboxestrue| and |\TPshowboxesfalse| +% commands. % \item[\Lopt{noshowtext}]This suppresses the display of the text in % each block (so it's not really usable without the \Lopt{showboxes} % option). The resulting box will be the correct size, but empty, @@ -416,6 +433,10 @@ % size parameters of the \Lenv{textblock} environment. Set it using % the command \cmd|\setlength{\TPVertModule}{<dimen>}| (or |\addtolength|). % The default is one sixteenth of the paper height. +% \item[\texttt{\bslash TPshowboxestrue} and \texttt{\bslash TPshowboxesfalse}] +% You can control whether text blocks have the rule around them by +% using the |\TPshowboxestrue| and |\TPshowboxesfalse| commands. The +% \Lopt{showboxes} option simply sets the initial value of this switch. % \item[\texttt{\bslash TPboxrulesize}] % \DescribeMacro{\TPboxrulesize} % When you use the \Lopt{showboxes} option, @@ -423,7 +444,7 @@ % when you are previewing your document, or if you simply like bold % frames and wish to make them a feature of your poster's design, you % may adjust the size using |\setlength| or |\addtolength|. The -% default is 0.4pt. +% default is 0.4pt. See also the |\textblockrulecolour| command. % \item[\texttt{\bslash textblocklabel}] % \DescribeMacro{\textblocklabel} % This may be used within any \Lenv{textblock} @@ -529,10 +550,13 @@ % box~255 was (erroneously) not a vbox, and passed on a fix from Hans % Hagen. % -% Jenny Maresh and Matthias Jerg independenty suggested that it would +% Jenny Maresh and Matthias Jerg independently suggested that it would % be useful to specify a margin around the block of text in a % \Lenv{textblock} environment. That resulted in the |\TPMargin| -% command (after an unconscionably long gestation period). +% command (after an unconscionably long gestation period). Rusen Lu +% suggested that one should be able to specify the colours of the box +% borders, and that it would be useful to turn the bordering feature +% on and off within the file. % % Thanks also for bugreports to Jozef Bednarcik and Wolfgang Fleischer. % @@ -585,9 +609,9 @@ located at that point, rather than the top-left corner. % Allow the user to switch on display of boxes round the text. % \begin{macrocode} %<*package> -\newif\ifTP@showboxes -\TP@showboxesfalse -\DeclareOption{showboxes}{\TP@showboxestrue} +\newif\ifTPshowboxes +\TPshowboxesfalse +\DeclareOption{showboxes}{\TPshowboxestrue} % \end{macrocode} % \dots and switch off printing of text. % \begin{macrocode} @@ -782,7 +806,8 @@ located at that point, rather than the top-left corner. % \end{macrocode} % % The rules round the boxes are of width |\TPboxrulesize|, and the -% label text within them is |\normalsize|. +% label text within them is |\normalsize|. For the colour, see +% |\textblockrulecolour|. % \begin{macrocode} \newdimen\TPboxrulesize \setlength{\TPboxrulesize}{0.4pt} @@ -866,6 +891,24 @@ located at that point, rather than the top-left corner. % \end{macrocode} % \end{macro} % +% \begin{macro}{\textblockrulecolour} +% \changes{v1.7}{2006/08/24}{Add textblockrulecolour} +% \begin{macrocode} +\def\textblockrulecolour#1{% + \@ifundefined{color}% + {\gdef\TP@rulecolour{}}% ignore argument, switch off colour blocking below + {% + \def\@tempa{#1} + \gdef\TP@rulecolour{#1}% + }} +\def\TP@rulecolour{black} +% \end{macrocode} +% Plus spelling-reform variants: +% \begin{macrocode} +\let\textblockrulecolor\textblockrulecolour +\let\tekstblokroolkulur\textblockrulecolour +% \end{macrocode} +% % \begin{macro}{\textblock} % Now define the start of the textblock environment. Read the first % argument, and save it for the moment as |\@tempdima|. If we are @@ -947,8 +990,8 @@ located at that point, rather than the top-left corner. % \end{macrocode} % If we're showing boxes, then draw a rule here % \begin{macrocode} - \ifTP@showboxes - \hrule height0pt depth \TPboxrulesize + \ifTPshowboxes + {\color{\TP@rulecolour} \hrule height0pt depth \TPboxrulesize }% \vskip-\TPboxrulesize \fi % \end{macrocode} @@ -1007,9 +1050,9 @@ located at that point, rather than the top-left corner. % \begin{macrocode} \def\TP@commonendtextblock{% \vskip \TP@absmargin - \ifTP@showboxes + \ifTPshowboxes \vskip-\TPboxrulesize - \hrule depth 0pt height \TPboxrulesize + {\color{\TP@rulecolour}\hrule depth 0pt height \TPboxrulesize}% \fi \egroup % end of \TP@textbox % \end{macrocode} @@ -1112,16 +1155,16 @@ located at that point, rather than the top-left corner. \ifx\TP@defaultblockcolour\@undefined \else \global\let\TP@blockcolour\TP@defaultblockcolour \fi - \ifTP@showboxes - \vrule width \TPboxrulesize + \ifTPshowboxes + {\color{\TP@rulecolour}\vrule width \TPboxrulesize}% \hskip -\TPboxrulesize \fi \ifTP@showtext \box\TP@textbox \else \vbox to\ht\TP@textbox{% - \ifTP@showboxes - \hrule depth 0pt height \TPboxrulesize \vskip-\TPboxrulesize + \ifTPshowboxes + {\color{\TP@rulecolour}\hrule depth 0pt height \TPboxrulesize \vskip-\TPboxrulesize}% \fi \vskip\smallskipamount \hbox to\wd\TP@textbox{% @@ -1135,15 +1178,15 @@ located at that point, rather than the top-left corner. \hss }% \vss - \ifTP@showboxes + \ifTPshowboxes \vskip -\TPboxrulesize - \hrule depth 0pt height \TPboxrulesize + {\color{\TP@rulecolour}\hrule depth 0pt height \TPboxrulesize}% \fi }% \fi - \ifTP@showboxes + \ifTPshowboxes \hskip -\TPboxrulesize - \vrule width \TPboxrulesize + {\color{\TP@rulecolour}\vrule width \TPboxrulesize}% \fi \hss}% \vss |