summaryrefslogtreecommitdiff
path: root/texmf-dist/doc/latex/aeb-mlink
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2017-07-13 10:25:48 +0900
committerNorbert Preining <norbert@preining.info>2017-07-13 10:25:48 +0900
commitcfe306ba1b7ec40855a300580b7981845d56edeb (patch)
treee2feaf2adf8a8afe43a995528097913793874d01 /texmf-dist/doc/latex/aeb-mlink
parent32d0671418a3cc6ad0465b06539ed54d96f77784 (diff)
add aeb-mlink aeb-pro aebxmp graphicxsp annot-pro
Diffstat (limited to 'texmf-dist/doc/latex/aeb-mlink')
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/README.md40
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/mlink_tst.pdfbin0 -> 57009 bytes
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/mlink_tst.tex145
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.pdfbin0 -> 29460 bytes
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.tex36
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/np_test.txt1
-rw-r--r--texmf-dist/doc/latex/aeb-mlink/shameless_ad.pdfbin0 -> 40725 bytes
7 files changed, 222 insertions, 0 deletions
diff --git a/texmf-dist/doc/latex/aeb-mlink/README.md b/texmf-dist/doc/latex/aeb-mlink/README.md
new file mode 100644
index 00000000..a7c43656
--- /dev/null
+++ b/texmf-dist/doc/latex/aeb-mlink/README.md
@@ -0,0 +1,40 @@
+Package: aeb_mlink
+Author: D. P. Story
+Dated: 2016/02/16
+Version: v2.0
+
+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.
+
+What new in version 2.0, added the \mlurl command.
+
+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.
+
+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.
+
+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.
+
+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.
+
+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/mlink_tst.pdf b/texmf-dist/doc/latex/aeb-mlink/mlink_tst.pdf
new file mode 100644
index 00000000..56009cc3
--- /dev/null
+++ b/texmf-dist/doc/latex/aeb-mlink/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/mlink_tst.tex
new file mode 100644
index 00000000..3e1f2f54
--- /dev/null
+++ b/texmf-dist/doc/latex/aeb-mlink/mlink_tst.tex
@@ -0,0 +1,145 @@
+\documentclass{article}
+\usepackage[fleqn]{amsmath}
+\usepackage[designi]{web}
+\usepackage{eforms}
+\usepackage{aeb_mlink}
+\usepackage{multicol}
+
+\renewcommand\hproportionwebtitle{.75}
+\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}
+\keywords{AeB, multi-line links}
+
+\university{NORTHWEST FLORIDA STATE COLLEGE\\
+ Department of Mathematics}
+\email{storyd@nwfsc.edu}
+\version{1.0}
+\revisionLabel{}
+
+\newcommand{\cs}[1]{\texttt{\char`\\#1}}
+
+\begin{document}
+
+\maketitle
+
+\section{Introduction}
+
+
+This file tests and demonstrates new macros for creating hypertext
+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
+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.
+
+
+This paragraph contains two links that go beyond the
+\mlhypertext[\A{\JS{app.alert("Third Link")}}]{margins of this text width},
+so it wraps around to the next line. Let's try a numbered equation:
+\begin{equation}
+ \boxed{x + y = 1}
+\end{equation}
+Now, with your permission, I'll insert another one of these
+\mlhypertext[\A{\JS{app.alert("Fourth Link")}}]{links of the
+multiline type.}\footnote{D.P. Story is very nice fellow, but he has a rather
+\mlhypertext[\A{\JS{app.alert("Footnote!")}}]{grand head; we must watch the
+compliments} so we don't inflate his ego more.} Can we continue with
+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.}
+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
+math \mbox{\smash[b]{$\displaystyle\int_0^1 f(x)\,dx$}} work admirably.}
+
+
+\parskip0pt
+
+\begin{multicols}{2}
+\noindent Being able to create multi-line links becomes important when the
+\texttt{\string\linewidth} is narrow. On this page we create some
+mindless text that will fill up all or part of the page, then create
+some multi-line links.
+
+Without a doubt, \textsl{this method will fail if the paragraph contains
+multi-line links that crosses a \emph{page boundary} or a \emph{\mlhypertext[\A{\JS{app.alert("Wrong again! However, there are problems
+with page boundaries.");}}]{column boundary}}}.
+
+This paragraph contains two links that extend beyond the
+\mlhypertext[\A{\JS{app.alert("Fifth Link")}}]{margins of this text
+width} which causes it to wrap around to the next line. Note the
+hyphenation of the link, this is due to the \textsf{soul} package.
+As a further test, I'll \mlhypertext[\A{\JS{app.alert("Sixth
+Link")}}]{insert a multi-line link} again. Can we continue with
+this? Yes, so says D. P. Story.
+
+\end{multicols}
+
+
+\section{Second of Three Sections}\label{second}
+
+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
+indeed. Let's try.
+
+Use \LaTeX/hyperref system of cross-referencing
+\mlnameref{three}. The last link is a modification of
+the \texttt{\string\nameref} command from hyperref.The
+\texttt{\string\Nameref} command can be duplicated
+\mlNameref{three} as well.
+
+\newpage
+
+\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:
+
+\begin{enumerate}
+ \item This method cannot work across page boundaries
+ \item See the \textsf{soul} package documentation for limitations on the arguments
+ of the \cs{mlxx} commands.
+ \item Works for footnotes
+ \item Can use verbatim text in a paragraph, \verb!$#}^!,
+ but cannot include verbatim in a multi-line link. Is
+ there any real need to do so?
+\end{enumerate}
+
+\section{URLs}
+
+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}.
+
+We can also call a local file, let's try: \mlhref{shameless_ad.pdf}{Here
+is a shameless advertisement for Acro\!\TeX}.
+
+Try launching a file now, let's try a \LaTeX{} file:
+\mlhref[\S{U}\W{1}\Color{.6 0 0}]{run:\jobname.tex}{This is the
+source file of this document}.\footnote{Source document needs to be in the folder
+containing this PDF file.}
+
+Finally, let's try my own email address at Acro\!\TeX.Net,
+\mlhref{mailto:dpstory@acrotex.net}{dpstory at acrotex dot net}.
+
+\href{run:np_test.txt}{Launch Notepad}\footnote{Windows system required.}
+
+\end{document}
diff --git a/texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.pdf b/texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.pdf
new file mode 100644
index 00000000..bf10f2a1
--- /dev/null
+++ b/texmf-dist/doc/latex/aeb-mlink/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/mlink_tst_url.tex
new file mode 100644
index 00000000..2e966d63
--- /dev/null
+++ b/texmf-dist/doc/latex/aeb-mlink/mlink_tst_url.tex
@@ -0,0 +1,36 @@
+\documentclass{article}
+% compile with or without the colorlinks option
+\usepackage{xcolor}
+\usepackage[colorlinks]{hyperref}
+\usepackage{aeb_mlink}
+
+\definePath{\urlAcroTeXBlog}{http://www.acrotex.net/blog}
+\definecolor{webgreen}{rgb}{0,.5,0}
+
+\parindent0pt \parskip3pt
+
+\begin{document}
+
+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?
+
+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}.}
+
+Here, we reference a \textsf{AeB Pro} articles \mlurl{\urlAcroTeXBlog/?tag=aeb-pro}.
+
+If the URL contains spaces, uses URL encoding, see \mlurl{http://www.w3schools.com/tags/ref_urlencode.asp}, for example.
+In the next example, we use \verb~\%20~ for space, the normal \texttt{\%20} is a problem because \texttt{\%}
+is still the {\LaTeX} comment character.
+
+Try a PDF with search: \mlurl{http://www.math.uakron.edu/~dpstory/acrotex/aeb_man.pdf#page=8%
+&search=AcroTeX\%20web\%20exerquiz}.
+
+The comment character can be used to wrap a long URL to the next line without effecting the address,
+as is done in the source file.
+
+
+\end{document}
diff --git a/texmf-dist/doc/latex/aeb-mlink/np_test.txt b/texmf-dist/doc/latex/aeb-mlink/np_test.txt
new file mode 100644
index 00000000..d9ea3996
--- /dev/null
+++ b/texmf-dist/doc/latex/aeb-mlink/np_test.txt
@@ -0,0 +1 @@
+This is a test document for notepad to open.
diff --git a/texmf-dist/doc/latex/aeb-mlink/shameless_ad.pdf b/texmf-dist/doc/latex/aeb-mlink/shameless_ad.pdf
new file mode 100644
index 00000000..69a04440
--- /dev/null
+++ b/texmf-dist/doc/latex/aeb-mlink/shameless_ad.pdf
Binary files differ