summaryrefslogtreecommitdiff
path: root/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2020-08-03 12:20:29 +0900
committerNorbert Preining <norbert@preining.info>2020-08-03 12:20:29 +0900
commit4bcfa3eaae54bdcda7561a5464a22f731a3509ed (patch)
tree4d00a777096855e7405dfbef8ea181863d674dd4 /texmf-dist/doc/latex
parent6702092fd01de6e5cb8bf4eddb1a76cb00669c8d (diff)
aeb-mlink update
Diffstat (limited to 'texmf-dist/doc/latex')
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/README.md22
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/aeb_mlink.pdfbin160605 -> 4241282 bytes
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/aebmlink_man.pdfbin335247 -> 336663 bytes
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/aebmlink_man.tex99
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdfbin66970 -> 83880 bytes
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.tex5
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.pdfbin35662 -> 36137 bytes
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.tex3
8 files changed, 74 insertions, 55 deletions
diff --git a/texmf-dist/doc/latex/aeb-mlink/README.md b/texmf-dist/doc/latex/aeb-mlink/README.md
index 47fdf787..f9717bf8 100644
--- a/texmf-dist/doc/latex/aeb-mlink/README.md
+++ b/texmf-dist/doc/latex/aeb-mlink/README.md
@@ -1,28 +1,30 @@
Package: aeb_mlink
Author: D. P. Story
-Dated: 2020-01-06
+Dated: 2020-07-12
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.
-PDF Creators: Adobe Distiller or ps2pdf
+PDF Creators: Adobe Distiller or ps2pdf.
-What's New (2020-01-06) This package reads web.cfg (web package,
-if available). The web.cfg has changed format slightly, this
-update now conforms to that format. Defined new option urlOpts to
-pass options to the url package.
+What's New (2020-07-12): An aeb_mlink document can now be compiled with
+pdflatex, lualatex, or xelatex. In this case, no links are created and
+only the link text is typeset. In this way, in theory, document authors
+can use their favorite PDF creator and view the document in their favorite
+PDF previewer (SumatraPDF). To create multi-line links, compile with a
+dvips->(distiller|ps2pdf) workflow.
-What's New (2018/08/18): Created \turnSyllbCntOn (\turnSyllbCntOff) to turn
+What's New (2018-08-18): Created \turnSyllbCntOn (\turnSyllbCntOff) to turn
on (resp., off) the viewing of syllable numbers. Reorganize core program to
accommodate the use of \mlhypertext command within the program code of
annot_pro. (This is to implement text markup annotations in that package.)
-What's New (2018/04/26): Included a 'dummy' package named aeb-mlink. The
+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.
-What's New (2018/04/20): Previously, the links created by aeb_mlink consisted
+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
@@ -35,7 +37,7 @@ a link apart, breaking it into two links. The second link is free to move to
the next page.
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.
+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:
diff --git a/texmf-dist/doc/latex/aeb-mlink/aeb_mlink.pdf b/texmf-dist/doc/latex/aeb-mlink/aeb_mlink.pdf
index 755abb2e..378738d3 100644
--- a/texmf-dist/doc/latex/aeb-mlink/aeb_mlink.pdf
+++ b/texmf-dist/doc/latex/aeb-mlink/aeb_mlink.pdf
Binary files differ
diff --git a/texmf-dist/doc/latex/aeb-mlink/aebmlink_man.pdf b/texmf-dist/doc/latex/aeb-mlink/aebmlink_man.pdf
index 94c613d8..069d9bb6 100644
--- a/texmf-dist/doc/latex/aeb-mlink/aebmlink_man.pdf
+++ b/texmf-dist/doc/latex/aeb-mlink/aebmlink_man.pdf
Binary files differ
diff --git a/texmf-dist/doc/latex/aeb-mlink/aebmlink_man.tex b/texmf-dist/doc/latex/aeb-mlink/aebmlink_man.tex
index db47d32e..eab753c4 100644
--- a/texmf-dist/doc/latex/aeb-mlink/aebmlink_man.tex
+++ b/texmf-dist/doc/latex/aeb-mlink/aebmlink_man.tex
@@ -20,7 +20,7 @@
\usepackage{acroman}
%\def\amtIndent{15pt}
-\edef\amtIndent{\the\leftmargini}
+\edef\amtIndent{\the\parindent}
\usepackage[active]{srcltx}
@@ -33,7 +33,7 @@
subject={Wrapping links around to the next line},
keywords={multi-line links, quad points, latex, pdf, aeb},
talksite={\url{www.acrotex.net}},
- version={2.3.5, 2020/01/06},
+ version={2.3.6, 2020/07/12},
copyrightStatus={True},
copyrightNotice={Copyright (C) 2006-\the\year, D. P. Story},
copyrightInfoURL={http://www.acrotex.net}
@@ -179,13 +179,24 @@ does me little good.
This package uses the \texttt{QuadPoints} entry of the link annotation
dictionary to create a bounding region; consequently, this package
requires\marginpar{\small\raggedright\flushright \app{Distiller} or
-\app{ps2pdf} required} \app{Acrobat Distiller} or the \app{ps2pdf.exe}
+\app{ps2pdf} required} \app{Acrobat Distiller} or the \app{ps2pdf}
converter to create a PDF. The \texttt{QuadPoints} entry in the link
annotation is a PDF 1.6 feature, so these multi-line links will work in
\app{Adobe Reader} 7.0 or later. If viewed in a version of \app{Adobe Reader}
previous to 7.0, the viewer will use the underlying bounding box, which is the
smallest rectangle containing the link text.
+\newtopic\noindent
+Version 2.3.6 (dated 2020/07/12 or later) now allows an \pkg{aeb\_mlink}
+document to be compiled by \app{pdflatex}, \app{lualatex}, and \app{xelatex}
+without errors; however, all commands defined in the package do nothing other
+then to display their \ameta{text} with no links created. This makes it nice
+for the lovers of these drivers to compile the document with their favorite
+driver and view the PDF in their favorite PDF previewer, such as
+\app{SumatraPDF}. Later, the document author can switch over to a
+\app{latex\,->\,dvips\,->\ameta{\upshape{distiler\string|ps2pdf}}} workflow
+to acquire the multi-line link version.
+
\section{Alternate package name: \texorpdfstring{\protect\pkg{aeb-mlink}}{aeb-mlink}}
This package is known on CTAN as \pkg{aeb-mlink}
@@ -244,17 +255,14 @@ of the Y\&Y {\TeX} System, no longer available, but is used by this author.} The
comes last.
\end{itemize}
-\paragraph*{Options of \pkg{aeb\_mlinks}.} The following are the options of this package.
+\paragraph*{Options of \pkg{aeb\_mlinks}.} These are,
\begin{description}
\item[\normalfont\texttt{dvips}] Use this option when the \textsf{dvips} application is used
to create the Postscript file.
\item[\normalfont\texttt{dvipsone}] Use this option when the \textsf{dvipsone} application is used
- to create the Post\-script file. (Only a few people worldwide use this option.)
+ to create the Post\-script file. (Only a few people worldwide use this option, it could be as small as two.)
\item[\normalfont\texttt{dblevel=\ameta{\upshape{0|1|2}}}] To obtain information on the multi-line links being
created. Each value gives more information about what is going on. Used for development.
- \item[\normalfont\texttt{urlOpts=\ameta{url-options}}] Use the key \opt{urlOpts} to pass options to the
- \pkg{url} package; for example \opt{urlOpts=hyphens} enables URLs to be broken at hyphens. See the
- \pkg{url} documentation for a list of options.
\item[\normalfont\ameta{eforms-options}] Any options other than the ones listed above are passed to the
\pkg{eforms} package.
\end{description}
@@ -276,23 +284,24 @@ the other six.
%constructed, it is best that the bounding rectangle is set on invisible, that
%is, the line width of the boundary line is zero. The \opt{colorlinks} option
%of \app{hyperref} should be taken.
+%\exSrc{mlink_tst}
-\exSrc{mlink_tst}The demo file is \texttt{mlink\_tst.tex}, it illustrates all
+The demo file is \texttt{mlink\_tst.tex}, it illustrates all
the commands -- with the exception of \cs{mlurl} -- of this package. The
demo file for \cs{mlurl} is a separate file and is mentioned in
\hyperref[ss:mlrul]{Section~\ref*{ss:mlrul}}.
\subsection{\cmdtitle{mlhypertext} (\cmdtitle{mlsetLink})} A general purpose multi-line link command.
-\bVerb[\aebdimen=8pt]\takeMeasure{\string\mlhypertext[\#1]\darg{\#2}}%
+\bVerb[\aebdimen=8pt]\takeMeasure{\string\mlhypertext[\ameta{opts}]\darg{\ameta{text}}}%
\begin{minipage}{\bxSize}
-\begin{Verbatim}[frame=single,rulecolor=\color{webblue}]
-\mlhypertext[#1]{#2}
+\begin{Verbatim}[frame=single,rulecolor=\color{webblue},commandchars=!()]
+\mlhypertext[!ameta(opts)]{!ameta(text)}
\end{Verbatim}
-\end{minipage}\quad\takeMeasure{\string\mlsetLink[\#1]\darg{\#2}}%
+\end{minipage}\quad\takeMeasure{\string\mlsetLink[\ameta{opts}]\darg{\ameta{text}}}%
\begin{minipage}{\bxSize}
-\begin{Verbatim}[frame=single,rulecolor=\color{webblue}]
-\mlsetLink[#1]{#2}
+\begin{Verbatim}[frame=single,rulecolor=\color{webblue},commandchars=!()]
+\mlsetLink[!ameta(opts)]{!ameta(text)}
\end{Verbatim}
\end{minipage}
\endgroup
@@ -329,12 +338,15 @@ used to create an alert box that appears when the link is clicked.
\subsection{\cmdtitle{mlhyperlink}} A multi-line version of the \cs{hyperlink} command.
-\bVerb\takeMeasure{\string\mlhyperlink[\#1]\darg{\#2}\darg{\#3}}%
-\begin{dCmd}{\bxSize}
-\mlhyperlink[#1]{#2}{#3}
+\bVerb\takeMeasure{\string\mlhyperlink[\ameta{opts}]\darg{\ameta{named-dest}}\darg{\ameta{text}}}%
+\begin{dCmd}[commandchars=!()]{\bxSize}
+\mlhyperlink[!ameta(opts)]{!ameta(named-dest)}{!ameta(text)}
\end{dCmd}
\endgroup
+%[\ameta{opts}]\darg{\ameta{named-dest}}\darg{\ameta{text}
+%[!ameta(opts)]{!ameta(text)}[\ameta{opts}]\darg{\ameta{text}}
+
\PD The first parameter is optional, and is used to set the appearance, but \textit{not the actions} of the link.
The second parameter is a named destination, perhaps created by the \cs{hypertarget} command of
\pkg{hyperref}. The third parameter is the text around which the link is constructed.
@@ -362,9 +374,9 @@ creating the named destination of \texttt{retire}.
\subsection{\cmdtitle{mlhyperref}}\label{ss:mlhyperref}
A multi-line version of the \cs{hyperref} command.
-\bVerb\takeMeasure{\string\mlhyperref[\#1]\darg{\#2}\darg{\#3}}%
-\begin{dCmd}{\bxSize}
-\mlhyperref[#1]{#2}{#3}
+\bVerb\takeMeasure{\string\mlhyperref[\ameta{opts}]\darg{\ameta{label}}\darg{\ameta{text}}}%
+\begin{dCmd}[commandchars=!()]{\bxSize}
+\mlhyperref[!ameta(opts)]{!ameta(label)}{!ameta(text)}
\end{dCmd}
\endgroup
\PD The first parameter is optional, and is used to set the
@@ -402,9 +414,9 @@ See \mlNameref{retirement}.
\subsection{\cmdtitle{mlnameref}} A multi-line version of the \cs{nameref} command.
-\bVerb\takeMeasure{\string\mlnameref[\#1]\darg{\#2}}%
-\begin{dCmd}{\bxSize}
-\mlnameref[#1]{#2}
+\bVerb\takeMeasure{\string\mlnameref[\ameta{opts}]\darg{\ameta{label}}}%
+\begin{dCmd}[commandchars=!()]{\bxSize}
+\mlnameref[!ameta(opts)]{!ameta(label)}
\end{dCmd}
\endgroup
@@ -431,9 +443,9 @@ The code for this link is seen below:
\subsection{\cmdtitle{mlNameref}} A multi-line version of the
\pkg{hyperref} command, \cs{Nameref}.
-\bVerb\takeMeasure{\string\mlNameref[\#1]\darg{\#2}}%
-\begin{dCmd}{\bxSize}
-\mlNameref[#1]{#2}
+\bVerb\takeMeasure{\string\mlNameref[\ameta{opts}]\darg{\ameta{label}}}%
+\begin{dCmd}[commandchars=!()]{\bxSize}
+\mlNameref[!ameta(opts)]{!ameta(label)}
\end{dCmd}
\endgroup
\PD The first parameter is optional, and is used to set the
@@ -457,15 +469,15 @@ the page, \mlNameref{retirement}. The code for the link is seen below:
\subsection{\cmdtitle{mlhref}} A multi-line version of the
\pkg{hyperref} command, \cs{href}.
-\bVerb\takeMeasure{\string\mlhref[\#1]\darg{\#2}\darg{\#3}}%
-\begin{dCmd}{\bxSize}
-\mlhref[#1]{#2}{#3}
+\bVerb\takeMeasure{\string\mlhref[\ameta{opts}]\darg{\ameta{url}}\darg{\ameta{text}}}%
+\begin{dCmd}[commandchars=!()]{\bxSize}
+\mlhref[!ameta(opts)]{!ameta(url)}{!ameta(text)}
\end{dCmd}
\endgroup
\PD The first parameter is optional, and is used to set the
appearance, but \textit{not the actions} of the link. The
- second parameter is a URL, while the third parameter is the link text.
+ second parameter is an URL, while the third parameter is the link text.
\CmdDescription This is the multi-line version of the
\pkg{hyperref} command, \cs{href}. The default appearance is
@@ -488,13 +500,13 @@ defining a different action through the first parameter.
The next link uses the \cs{mlhref} command with URL: \mlhref{%
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}
+Site at the University of Akron}.
\bVerb\takeMeasure{\{See the educational offerings of the \darg{Acro\string\negthinspace\darg{\string\TeX}} Web}%
\begin{dCmd*}{\bxSize}
\mlhref{%
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}
+Site at the University of Akron}.
\end{dCmd*}
\eVerb
Use the \cs{mlhref} command with mailto URL: My email address at Acro\negthinspace\TeX.Net,
@@ -525,9 +537,9 @@ application associated with the extension of the file provided.
A multi-line version of the \cs{url} command of the \pkg{url} package.
The \pkg{hyperref} modifies this command to make it into an unbreakable link (at least for those
using \app{Distiller}).
-\bVerb\takeMeasure{\string\mlurl[\#1]\darg{\#2}}%
-\begin{dCmd}{\bxSize}
-\mlurl[#1]{#2}
+\bVerb\takeMeasure{\string\mlurl[\ameta{opts}]\darg{\ameta{url}}}%
+\begin{dCmd}[commandchars=!()]{\bxSize}
+\mlurl[!ameta(opts)]{!ameta(url)}
\end{dCmd}
\endgroup
@@ -554,8 +566,9 @@ See the Internet reference
\mlurl{http://www.w3schools.com/tags/ref_urlencode.asp} for a discussion of
the \textbf{\caps{HTML URL Encoding Reference}}.
+% \exSrc{mlink_tst_url}
-\exSrc{mlink_tst_url}The demo file that illustrate all the commands to
+The demo file that illustrate all the commands to
follow is \texttt{mlink\_tst\_url.tex}. Additional details and examples are found in this
example file.
@@ -605,13 +618,13 @@ two styles of key-values:
js={app.alert("AcroTeX rocks!")}}]{AcroTeX
can be found at \texttt{www.acrotex.net}, as
close as your nearest web browser.}
-\begin{Verbatim}[xleftmargin=\amtIndent,fontsize=\small]
+\begin{Verbatim}[xleftmargin=\amtIndent,fontsize=\small,commandchars={!@^}]
\mlsetLink[\ui{%
- border=visible,
- linestyle=underlined,
- bordercolor={0 0.6 0},
- linktxtcolor=webgreen,
- js={app.alert("AcroTeX rocks!")}}]{AcroTeX...browser.}
+!quad@border=visible,^
+!quad@linestyle=underlined,^
+!quad@bordercolor={0 0.6 0},^
+!quad@linktxtcolor=webgreen,^
+!quad@js={app.alert("AcroTeX rocks!")}}]{AcroTeX...browser.}^
\end{Verbatim}
\item[] The \pkg{xkeyval} KVP system is described in the document
\textsl{\mlhref{http://www.math.uakron.edu/~dpstory/acrotex/eformman.pdf}{Support for AcroForms and Links, and for Document JavaScript and Open Page Events}}.\footnote
diff --git a/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdf b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdf
index cafe43e4..ebe8e0a4 100644
--- a/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdf
+++ b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.pdf
Binary files differ
diff --git a/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.tex b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.tex
index e2a2a4ec..9f87286c 100644
--- a/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.tex
+++ b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst.tex
@@ -9,6 +9,7 @@
\renewcommand{\titleauthorproportion}{.5}
+
\title{Demonstrating the \textsf{aeb\_mlink} Package\texorpdfstring{\\[3pt]}{: }A member of AeB Pro}
\author{D. P. Story}
\subject{Multi-line links using the AcroTeX eDucation Bundle}
@@ -26,8 +27,8 @@
\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
-
+\mlMarksOn
+\turnSyllbCntOn
\begin{document}
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
index b8467599..069ba1d4 100644
--- 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 differ
diff --git a/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.tex b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.tex
index 926dda1b..b5d566f9 100644
--- a/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.tex
+++ b/texmf-dist/doc/latex/aeb-mlink/examples/mlink_tst_url.tex
@@ -4,6 +4,8 @@
\usepackage[colorlinks]{hyperref}
\usepackage{aeb_mlink}
+\hypersetup{pdfpagemode=UseNone}
+
\definePath{\urlAcroTeXBlog}{http://www.acrotex.net/blog}
\definecolor{webgreen}{rgb}{0,.6,0}
@@ -11,6 +13,7 @@
\begin{document}
+
In this demo file we test the \verb~\mlurl~ command.
OK, let's see if we still wrap around the line