summaryrefslogtreecommitdiff
path: root/texmf-dist/doc
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2018-06-11 12:25:50 +0900
committerNorbert Preining <norbert@preining.info>2018-06-11 12:25:50 +0900
commit7e4d939488c15290b3df52942833411d669c44d7 (patch)
tree8df9abc80b9b2ce51e6af2dac34bf91803553427 /texmf-dist/doc
parent69aed6c627813afde6fb1983e8b673ed5b8ec0d5 (diff)
aeb-mlink update
Diffstat (limited to 'texmf-dist/doc')
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/README.md57
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/aebmlink_man.pdfbin0 -> 328132 bytes
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdfbin0 -> 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.pdfbin0 -> 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)bin40725 -> 40725 bytes
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/mlink_tst.pdfbin57009 -> 0 bytes
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.pdfbin29460 -> 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
new file mode 100644
index 00000000..2cd55b33
--- /dev/null
+++ b/texmf-dist/doc/latex/aeb-mlink/aebmlink_man.pdf
Binary files differ
diff --git a/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdf b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdf
new file mode 100644
index 00000000..5f2e7d64
--- /dev/null
+++ b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdf
Binary files differ
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
new file mode 100644
index 00000000..17e2a612
--- /dev/null
+++ b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.pdf
Binary files differ
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
index 69a04440..69a04440 100644
--- a/texmf-dist/doc/latex/aeb-mlink/shameless_ad.pdf
+++ b/texmf-dist/doc/latex/aeb-mlink/examples/shameless_ad.pdf
Binary files differ
diff --git a/texmf-dist/doc/latex/aeb-mlink/mlink_tst.pdf b/texmf-dist/doc/latex/aeb-mlink/mlink_tst.pdf
deleted file mode 100644
index 56009cc3..00000000
--- a/texmf-dist/doc/latex/aeb-mlink/mlink_tst.pdf
+++ /dev/null
Binary files differ
diff --git a/texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.pdf b/texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.pdf
deleted file mode 100644
index bf10f2a1..00000000
--- a/texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.pdf
+++ /dev/null
Binary files differ