From 001d2f268370febe53928de6bd985ed75ee4b68c Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Tue, 23 Feb 2021 14:50:58 +0900
Subject: acrotex update

---
 texmf-dist/doc/latex/acrotex/aeb_man.tex | 135 +++++++++++++++++--------------
 1 file changed, 76 insertions(+), 59 deletions(-)

(limited to 'texmf-dist/doc/latex/acrotex/aeb_man.tex')

diff --git a/texmf-dist/doc/latex/acrotex/aeb_man.tex b/texmf-dist/doc/latex/acrotex/aeb_man.tex
index cf08a132..802c92c6 100644
--- a/texmf-dist/doc/latex/acrotex/aeb_man.tex
+++ b/texmf-dist/doc/latex/acrotex/aeb_man.tex
@@ -21,6 +21,7 @@
 \DeclareInitView{layoutmag={navitab:UseOutlines}}
 \xbmksetup{colors={int=red},styles={intbf}}
 
+\reversemarginpar
 \newbox\aebbox
 
 \usepackage{acroman}
@@ -29,6 +30,7 @@
 \setcounter{secnumdepth}{4}
 \setcounter{tocdepth}{4}
 
+\let\tops\texorpdfstring
 \let\uif\textsf
 
 \def\AcroBlog{{Acro\!\TeX} Blog}
@@ -70,7 +72,7 @@
 \LTpre=0pt %\medskipamount
 \LTpost=-2\medskipamount
 %\LTpost=0pt %\medskipamount
-\setlength{\mathindent}{20pt}
+\setlength{\mathindent}{\the\parindent}
 
 \def\AEBBook{\textsl{{Acro\!\TeX} eDucation System Tools: {\LaTeX} for interactive PDF documents}}
 
@@ -175,7 +177,6 @@
 \def\nhurl#1{\bNH\url{#1}\eNH}
 \def\grayV#1{\textcolor{gray}{#1}}
 \def\darg#1{\{#1\}}
-\def\parboxValign{t}
 \renewcommand*{\backrefalt}[4]{%
     \ifcase #1\or
        See page~#2.\else See pages~#2.\fi
@@ -183,6 +184,7 @@
 \newenvironment{aebQuote}
    {\list{}{\leftmargin\amtIndent}%
     \item\relax}{\endlist}
+\def\parboxValign{t}
 \newcommand{\FmtMP}[2][0pt]{\mbox{}\marginpar{%
     \raisebox{.5\baselineskip+#1}{%
     \expandafter\parbox\expandafter[\parboxValign]%
@@ -233,10 +235,10 @@
 \university{{\AcroT} Software Development Team}
 \email{dpstory@acrotex.net}
 \versionLabel{Dated:}
-\version{2021/01/20}
+\version{2021/02/17}
 \copyrightyears{1999-\the\year}
 \nocopyright
-\prepared{2021/01/20}
+\prepared{2021/02/17}
 \revisionLabel{Distribution Dated:}
 
 \copyrightStatus{True}
@@ -547,64 +549,57 @@ are the installation files for the individual packages,
 \end{questions}
 
 
-
-\subsection{Installing \texttt{aeb.js}}
-
-
-The JavaScript file \texttt{aeb.js} is only needed if you use \textbf{Acrobat
-Pro 8.1} or later and \textbf{Adobe Distiller} as the PDF creator. Increased
-security in that version has made it necessary to install a folder JavaScript
-file. The JavaScript within \texttt{aeb.js} raises the ``trust'' of certain
-JavaScript methods used to import document JavaScript into the document just
-after the distillation process and the newly created PDF is opened in
-\textbf{Acrobat} for the first time. The installation of this file is not
-needed if you use \textsf{pdftex}, or \textsf{dvipdfm} (or any of their
-variations), or use a version of \textbf{Acrobat} prior to 8.1.
+\subsection{Concerning the use of \tops{\app}{}{Acrobat}}\label{ss:DistAcro}
+
+Some \hypertarget{DistAcroWF}{document} authors use the workflow
+\begin{equation}\text{\ttfamily
+tex\,->\,dvi\,->\,\app{dvips}\,->\,ps\,->\,\ameta{\upshape\app{Distiller}\string|\app{ps2pdf}}\,->\allowbreak
+\,\app{PDF viewer}}\label{eq:AcrobatWF}
+\end{equation}
+to create a PDF document. If the document contains quizzes created by the
+\pkg{exerquiz} package (see \Nameref{s:exerquiz}), \uif{Document JavaScripts}
+are required; as a result, at the end of the above workflow, the \app{PDF
+viewer} \emph{is required to be} \app{Acrobat}\FmtMP{\app{Acrobat}
+required}.\footnote{Other PDF creation workflows do not require \app{Acrobat}
+to embed \uif{Document JavaScripts}} The role of \app{Acrobat} is to embed
+the \uif{Document JavaScripts} in the document. The next two subsections
+discuss the use of \app{Acrobat}, first to install the folder JavaScript file
+\texttt{aeb.js}, and second to configure \app{Acrobat}, if needed.
+
+\subsubsection{Installing \texttt{aeb.js}}
+
+The JavaScript file \texttt{aeb.js} is only needed if you use the workflow of
+\hyperref[eq:AcrobatWF]{display~\begin{NoHyper}\eqref{eq:AcrobatWF}\end{NoHyper}}
+and \uif{Document JavaScripts} are needed to be embedded.
+
+Increased security for the \app{Acrobat} application makes it necessary to
+install a folder JavaScript file. The JavaScript within \texttt{aeb.js}
+raises the ``trust'' of certain JavaScript methods used to import
+\uif{document JavaScript} into the document just after the PDF creation and
+the newly created PDF is opened in \app{Acrobat} for the first time. The
+installation of this file is not needed if you use \app{pdftex},
+\app{lualatex}, or \app{xelatex} (or any of its variants), or if you use
+a version of \app{Acrobat} prior to version 8.1.
 
 The instructions for installing \texttt{aeb.js} are in the
 \texttt{\href{install_jsfiles.pdf}{install\_jsfiles.pdf}}, which resides in
-the \texttt{doc} folder of the \texttt{acrotex} installation. If you use
-\textbf{Distiller} as your PDF creator, please refer to that document.
+the \texttt{doc} folder of the \texttt{acrotex} installation. if you use the workflow of
+\hyperref[eq:AcrobatWF]{display~\begin{NoHyper}\eqref{eq:AcrobatWF}\end{NoHyper}}, please refer to that document.
 
-After you've installed the JavaScript files, as directed by the
+After you've installed the JavaScript file, as directed by the
 \texttt{\href{install_jsfiles.pdf}{install\_jsfiles.pdf}}, validate the
 installation of the JavaScript files by navigating to the \texttt{examples}
 subfolder and opening the file \texttt{test\_install.pdf} in \app{Acrobat};
 follow the directions contained on that one page document.
 
+\subsubsection{Configuring \tops{\app}{}{Acrobat}}
 
-\begin{comment}
-\paragraph*{Acrobat Pro~8.1 or later.}
-Start \textbf{Acrobat Pro~8.1}\footnote{The file will cause no harm if you
-install it in an earlier version of Acrobat, as early as version 7.} or
-later, and open the console window \textsf{Advanced \texttt> JavaScript
-\texttt> Debugger} (\texttt{Ctrl+J} for Windows or \texttt{Cmd+J} for Mac
-OS). Copy and paste the following code into the window.
-\begin{Verbatim}[xleftmargin=\amtIndent]
-app.getPath("user","javascript");
-\end{Verbatim}
-Now, with the mouse cursor on the line containing this script, press
-the \texttt{Ctrl+Enter} key. This will execute this JavaScript. This
-JavaScript method returns the path to where \texttt{aeb.js} should
-be placed. For example, on my system, the return string is
-\begin{Verbatim}[xleftmargin=\amtIndent,fontsize=\small]
-/C/Documents and Settings/story/
-    Application Data/Adobe/Acrobat/8.0/JavaScripts
-\end{Verbatim}
-Follow the path to this folder. If the \texttt{JavaScripts} folder
-does not exist, create it.  Finally, copy \texttt{aeb.js}
-into this folder. The file is read each time Acrobat starts.
+If you have \app{Acrobat DC} that was purchased or updated after December 2020,
+\app{Acrobat} needs to be configured for the workflow
+\hyperref[eq:AcrobatWF]{display~\begin{NoHyper}\eqref{eq:AcrobatWF}\end{NoHyper}}
+to function correctly. For detailed discussion, refer to the document
+\texttt{\href{acrobat-in-workflow.pdf}{acrobat-in-workflow.pdf}}.
 
-\paragraph*{Acrobat Pro 10.1.1 for Windows only.} For this version of \textbf{Acrobat},
-things have tightened up even more. The user JavaScripts folder has moved to
-\begin{Verbatim}[xleftmargin=\amtIndent,fontsize=\small]
-%AppData%\Adobe\Acrobat\Privileged\10.0\JavaScripts
-\end{Verbatim}
-\exAeBBlogArticle{p=737}where \verb!%AppData%! is an environment variable defined by Acrobat. For details
-of how to install the folder JavaScripts in the new location, see my blog
-article \mlhref{http://www.acrotex.net/blog/?p=737}{Acrobat Security Changes in 10.1.1 and
-Acro\!\TeX}.
-\end{comment}
 
 \subsection{Language Localizations}
 
@@ -789,6 +784,26 @@ document. At this point you can move your \textsf{PDF} to another
 folder, or to the web. The document does not need the
 \texttt{.fdf} files any more.
 
+\redpoint \textcolor{red}{Important:} If you use \app{Acrobat
+DC}\FmtMP{\app{Acrobat DC}} in your PDF creation workflow and have updated
+the application after December 2020, the {\AEB} workflow is broken. To
+restore the workflow, it is necessary \emph{to clear the checkbox} labeled
+\uif{Enable Protected Mode at startup}\FmtMP{Protected Mode}, this checkbox
+is found under the menu \uif{Edit > Preferences}
+(\uif{Ctrl+K}).\footnote{When the box is checked, importing FDF files, as
+described above, is prohibited. We want FDF files imported, so we clear the
+checkbox.}  In the \uif{Preferences} dialog box, select the \uif{Security
+(Enhanced)} category from the left panel; the targeted checkbox is at the top
+line on the right panel. Refer to \hyperref[fig:SP]{Figure~\ref*{fig:SP}} for
+a visual.
+
+
+\begin{figure}[htb]\fboxsep0pt\relax\centering
+  \fbox{\includegraphics[width=.5\linewidth]{figures/SecurityPrefs}}
+  \caption{\tops{\protect\uif}{}{Security (Enhanced) Preferences}}\label{fig:SP}
+\end{figure}
+
+
 \begin{comment}
 \redpoint \textbf{For Distiller~4.0--4.05 Users.} Versions prior
 to~5.0 of the Acrobat product cannot import document level
@@ -834,7 +849,7 @@ You can edit \textsf{eq\_dljs.pdf} and make whatever changes you
 please to the script, in terms of changing color.
 \end{comment}
 
-There are several ways the Distiller workflow can be accomplished:
+%There are several ways the Distiller workflow can be accomplished:
 %\begin{itemize}
 %    \item \textbf{Through the {\LaTeX} Editor.} Some editors, WinEdt, in particular, have toolbars that can distill
 %    a PostScript file. (The default is to use  Ghostscript, you'll have to change to Distiller.) From WinEdt, you
@@ -858,12 +873,13 @@ There are several ways the Distiller workflow can be accomplished:
 %        5. Open the .pdf file.
 %
 %        This will allow readers the opportunity to see what will happen if they fail to save the file before moving it
-to another location, like the web.
+%to another location, like the web.
 %
 %
 %    \end{enumerate}
 %\end{itemize}
 
+
 \newtopic For distiller users, the
 \href{http://www.math.uakron.edu/~dpstory/aeb_pro.html}{\AEB\ Pro package}
 has many exciting features, functionality requires the document author use
@@ -3688,7 +3704,7 @@ dot (.) at the end of the section number. To revert to this behavior, use the
     \par\vskip6pt\vskip0pt plus .25\vsize\penalty-1000 \vskip0pt plus-.25\vsize}
 
 %\addtocontents{toc}{\par\protect\vspace{\bigskipamount}\kern0pt\vspace{-\medskipamount}}
-\part{The Exerquiz Package}\label{s:exerquiz}
+\part{The Exerquiz Package}\chgCurrLblName{The Exerquiz Package}\label{s:exerquiz}
 
 %The \textsf{exerquiz} package contains a series of macros for
 %creating on-line exercises, short quizzes (with or without
@@ -3751,12 +3767,13 @@ discussed in this section.
 
 \section{\protect\textsf{Exerquiz} and Acrobat JavaScript}
 
-\textsf{Exerquiz} now uses the \textsf{insdljs} Package to insert
-Document level Java\-Scripts into the \textsf{PDF} file. The quizzes
-created using the \texttt{shortquiz} or \texttt{quiz} environment are
-graded, marked and scored using these inserted JavaScript functions.
+\pkg{Exerquiz} now uses the \pkg{insdljs} package to insert \uif{Document
+level Java\-Scripts} into the {PDF} file. (Review
+\hyperref[ss:DistAcro]{Section~\ref*{ss:DistAcro}} on page~\pageref*{ss:DistAcro}, as needed.) The quizzes
+created using the \texttt{shortquiz} or \texttt{quiz} environment are graded,
+marked and scored using these inserted JavaScript functions.
 
-Because the package \textsf{insdljs} is already loaded, it is easy
+Because the package pkg{insdljs} is already loaded, it is easy
 for the document author to develop JavaScripts that can be called
 from the standard \textsf{Exerquiz} commands. The ability to write
 JavaScript, therefore, right in the \LaTeX{} document gives a
-- 
cgit v1.2.3

