diff options
Diffstat (limited to 'texmf-dist/doc/latex')
-rw-r--r-- | texmf-dist/doc/latex/aeb-mlink/README.md | 57 | ||||
-rw-r--r-- | texmf-dist/doc/latex/aeb-mlink/aebmlink_man.pdf | bin | 0 -> 328132 bytes | |||
-rw-r--r-- | texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdf | bin | 0 -> 66094 bytes | |||
-rw-r--r-- | texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.tex (renamed from texmf-dist/doc/latex/aeb-mlink/mlink_tst.tex) | 30 | ||||
-rw-r--r-- | texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.pdf | bin | 0 -> 37152 bytes | |||
-rw-r--r-- | texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.tex (renamed from texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.tex) | 5 | ||||
-rw-r--r-- | texmf-dist/doc/latex/aeb-mlink/examples/np_test.txt (renamed from texmf-dist/doc/latex/aeb-mlink/np_test.txt) | 0 | ||||
-rw-r--r-- | texmf-dist/doc/latex/aeb-mlink/examples/shameless_ad.pdf (renamed from texmf-dist/doc/latex/aeb-mlink/shameless_ad.pdf) | bin | 40725 -> 40725 bytes | |||
-rw-r--r-- | texmf-dist/doc/latex/aeb-mlink/mlink_tst.pdf | bin | 57009 -> 0 bytes | |||
-rw-r--r-- | texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.pdf | bin | 29460 -> 0 bytes |
10 files changed, 55 insertions, 37 deletions
diff --git a/texmf-dist/doc/latex/aeb-mlink/README.md b/texmf-dist/doc/latex/aeb-mlink/README.md index a7c43656..58255db7 100644 --- a/texmf-dist/doc/latex/aeb-mlink/README.md +++ b/texmf-dist/doc/latex/aeb-mlink/README.md @@ -1,35 +1,44 @@ -Package: aeb_mlink -Author: D. P. Story -Dated: 2016/02/16 -Version: v2.0 +Package: aeb_mlink +Author: D. P. Story +Dated: 2018/04/26 -The aeb_mlink package implements new links capable of created multi-line -links. The new commands are \mlhypertext, \mlhyperlink, \mlhyperref, -\mlnameref, \mlNameref, \mlhref, and \mlurl. All but the first are multi-line -versions of hyperref commands with the same root name. +The aeb_mlink package defines new link commands to create multi-line links. +The new commands are \mlhypertext, \mlhyperlink, \mlhyperref, \mlnameref, +\mlNameref, \mlhref, and \mlurl. -What new in version 2.0, added the \mlurl command. +PDF Creators: Adobe Distiller or ps2pdf -Restriction: This package requires that the PDF be created by Adobe -Distiller, version 7.0 or later to create multi-line links, and requires -Adobe Reader 7.0 or later for the links to work correctly. +What's New (2018/04/26): Included a 'dummy' package named aeb-mlink. The +aeb_mlink package is listed on CTAN as aeb-mlink, though there is no such +package by that name. Well, now there is. -This package requires the latest version of AeB, in particular, the -eforms package required is dated 2008/03/14 or later. See -ctan.org/pkg/acrotex or -www.math.uakron.edu/~dpstory/webeq.html to retrieve acrotex.zip. +What's New (2018/04/20): Previously, the links created by aeb_mlink consisted +of a series of rectangles around each of the syllables of the hypertext or +url; the little rectangles responded in unison when any one of them were +clicked. In this version, Postscript procedures are used to combine the +little rectangles into one rectangle per line of hypertext. Also the Rect +entry has been changed to be the smallest rectange that encloses the +hypertext (or url). The Postscript tries to detect problems with the links, +and reports to the log (distiller or ps2pdf log). The PDF Specification does +not support cross-page links, to resolve this issued, a method of 'cracking' +a link apart, breaking it into two links. The second link is free to move to +the next page. -Installation Instructions: Place the zip file in your latex search -path and unzip. Refresh your file name database, and you are ready -to go. Start with documentation and the demo files contained in the -examples folder. +This package requires the latest version of AeB, in particular, the eforms +package required is dated 2018/03/22 or later. See ctan.org/pkg/acrotex. + +In addition to the demo files distributed with the package, there are two new +demo files available from the AcroTeX Blog webiste: + + aeb_mlink: Fixing multi-line link boxes + (http://www.acrotex.net/blog/?p=1377) + + aeb_mlink: Crossing page boundaries with multi-line links + (http://www.acrotex.net/blog/?p=1383) Let me know if there are problems or suggested features. e-mail me at dpstory@uakron.edu or dpstory@acrotex.net -The latest updates to the aeb_mlink package can be found at -www.math.uakron.edu/~dpstory/aeb_pro.html. - My other web site is http://blog.acrotex.net/ has the latest on my ruminations on LaTeX and PDF. @@ -37,4 +46,4 @@ Now, I simply must get back to my retirement. D. P. Story dpstory@uakron.edu -2016/02/16 + diff --git a/texmf-dist/doc/latex/aeb-mlink/aebmlink_man.pdf b/texmf-dist/doc/latex/aeb-mlink/aebmlink_man.pdf Binary files differnew file mode 100644 index 00000000..2cd55b33 --- /dev/null +++ b/texmf-dist/doc/latex/aeb-mlink/aebmlink_man.pdf diff --git a/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdf b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdf Binary files differnew file mode 100644 index 00000000..5f2e7d64 --- /dev/null +++ b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdf diff --git a/texmf-dist/doc/latex/aeb-mlink/mlink_tst.tex b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.tex index 3e1f2f54..4c74a11a 100644 --- a/texmf-dist/doc/latex/aeb-mlink/mlink_tst.tex +++ b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.tex @@ -17,11 +17,18 @@ \university{NORTHWEST FLORIDA STATE COLLEGE\\ Department of Mathematics} \email{storyd@nwfsc.edu} -\version{1.0} +\version{2.2} \revisionLabel{} \newcommand{\cs}[1]{\texttt{\char`\\#1}} +\flJSStr\Msgi{First Link\\n\\nLet's try another! J\\374rgen and with unicode J\\u00FCrgen} +\flJSStr\Msgii{Success! Multi-line links with hyphenation!\\n\\nCongrats, J\\u00FCrgen} +\flJSStr\Msgiii{I said, \\"No, they won't work.\\"...I'm wrong again.} + +% \mlMarksOn + + \begin{document} \maketitle @@ -34,9 +41,7 @@ links that wrap around a line. Most of the text is nonsense, and was created to fill the page, no offence taken I hope This paragraph contains two links that go beyond the -\mlhypertext[\S{U}\W{1}\Color{0 .6 0}\A{\JS{app.alert("First -Link\\n\\nLet's try another! J\\374rgen and with unicode J\\u00FCrgen")}} -]{margins of this text width} so it wraps around to the +\mlhypertext[\S{U}\W{1}\Color{0 .6 0}\A{\JS{app.alert(\Msgi);}}]{margins of this text width} so it wraps around to the next line. Now, I'll \mlhypertext[\A{\JS{app.alert("Second Link")}}]{insert a multi-line link.}\footnote{Techniques by D. P. Story} Can we continue with this? Yes, so says D. P. Story. @@ -58,8 +63,9 @@ this? Yes, so says D. P. Story. On the next page, we try multiple column format. -\mlhypertext[\S{U}\W{1}\Color{0 0.6 0}\A{\JS{app.alert("Success! Multi-line links with hyphenation!\\n\\nCongrats, -J\\u00FCrgen")}}]{Welcome my friends to my residence, humble as it is. The encyclopedia is a wonderful book.} +\goodbreak + +\mlhypertext[\S{U}\W{1}\Color{0 0.6 0}\A{\JS{app.alert(\Msgii)}}]{Welcome my friends to my residence, humble as it is. The encyclopedia is a wonderful book.} We shall study it closely during your visit. Try this great link: \mlhypertext[\A{\JS{app.alert("Yes, they do!");}}]{J\"{u}rgen, \LaTeX{} and @@ -94,7 +100,7 @@ this? Yes, so says D. P. Story. Let us begin by having page filling mindless text, then we'll force a page break, but before we break, a friend of mine, asked if multi-line links work with math formulas. A very strange request, -\mlhypertext[\A{\JS{app.alert("I said, \\"No, they won't work.\\"...I'm wrong again.")}}]{$ x= f(t)$, $ x= g(t)$, $h(x) = e^x$}, very strange +\mlhypertext[\A{\JS{app.alert(\Msgiii)}}]{$ x= f(t)$, $ x= g(t)$, $h(x) = e^x$}, very strange indeed. Let's try. Use \LaTeX/hyperref system of cross-referencing @@ -108,11 +114,12 @@ the \texttt{\string\nameref} command from hyperref.The \section{Third of Three Sections}\label{three} The second section, oops, I've lost count. I have nothing to say in -this section. I take that back, below are problem areas multi-line -linking: +this section. I take that back, below are notes and problem areas: \begin{enumerate} - \item This method cannot work across page boundaries + \item It is possible to break multi-line links across page boundaries, see + the \href{http://www.acrotex.net/blog/?p=1383}{{Acro\!\TeX} Blog} article + \textsl{\mlhref{http://www.acrotex.net/blog/?p=1383}{Crossing page boundaries with multi-line links}} for a demo file of this. \item See the \textsf{soul} package documentation for limitations on the arguments of the \cs{mlxx} commands. \item Works for footnotes @@ -127,7 +134,8 @@ Let us try a URL across lines: \mlhref[\S{U}\W{1}\Color{0.6 0 0}]{% http://www.math.uakron.edu/~dpstory/acrotex.html#educational} {See the educational offerings of the {Acro\negthinspace{\TeX}} Web Site at the University of Akron}. This link plays off the -\texttt{\string\href} \hypertarget{command}{command}. +\texttt{\string\href} \hypertarget{command}{command}. There is also the \cs{mlurl} +command, illustrated in the file \texttt{mlink\_tst\_url.tex}. We can also call a local file, let's try: \mlhref{shameless_ad.pdf}{Here is a shameless advertisement for Acro\!\TeX}. diff --git a/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.pdf b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.pdf Binary files differnew file mode 100644 index 00000000..17e2a612 --- /dev/null +++ b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.pdf diff --git a/texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.tex b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.tex index 2e966d63..ca8c7d8f 100644 --- a/texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.tex +++ b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.tex @@ -5,7 +5,7 @@ \usepackage{aeb_mlink} \definePath{\urlAcroTeXBlog}{http://www.acrotex.net/blog} -\definecolor{webgreen}{rgb}{0,.5,0} +\definecolor{webgreen}{rgb}{0,.6,0} \parindent0pt \parskip3pt @@ -15,7 +15,8 @@ In this demo file we test the \verb~\mlurl~ command. OK, let's see if we still wrap around the line \mlurl{http://www.math.uakron.edu/~dpstory}. Now let's try another link, the following URL -\mlurl[\S{U}\W{1}\Color{0 .6 0}\linktxtcolor{webgreen}]{http://www.acrotex.net}, does it wrap? +\mlurl[\S{U}\W{1}\Color{0 .6 0}\linktxtcolor{webgreen}]{http://www.acrotex.net}, does it wrap? Yes, +but did the change in color also change the color of the next link: \setLink[\A{\JS{app.alert("Splendid, you clicked a link, a link to nowhere. The color of the link is as it should be.")}}\Color{1 0 0}]{Go There!} Let's try a footnote.\footnote{OK, lets see if we still wrap around the line, does it work? \mlurl{http://www.math.uakron.edu/~dpstory}.} diff --git a/texmf-dist/doc/latex/aeb-mlink/np_test.txt b/texmf-dist/doc/latex/aeb-mlink/examples/np_test.txt index d9ea3996..d9ea3996 100644 --- a/texmf-dist/doc/latex/aeb-mlink/np_test.txt +++ b/texmf-dist/doc/latex/aeb-mlink/examples/np_test.txt diff --git a/texmf-dist/doc/latex/aeb-mlink/shameless_ad.pdf b/texmf-dist/doc/latex/aeb-mlink/examples/shameless_ad.pdf Binary files differindex 69a04440..69a04440 100644 --- a/texmf-dist/doc/latex/aeb-mlink/shameless_ad.pdf +++ b/texmf-dist/doc/latex/aeb-mlink/examples/shameless_ad.pdf diff --git a/texmf-dist/doc/latex/aeb-mlink/mlink_tst.pdf b/texmf-dist/doc/latex/aeb-mlink/mlink_tst.pdf Binary files differdeleted file mode 100644 index 56009cc3..00000000 --- a/texmf-dist/doc/latex/aeb-mlink/mlink_tst.pdf +++ /dev/null diff --git a/texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.pdf b/texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.pdf Binary files differdeleted file mode 100644 index bf10f2a1..00000000 --- a/texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.pdf +++ /dev/null |