summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/visualfaq/source/troubleshoot-vlf.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/visualfaq/source/troubleshoot-vlf.tex')
-rw-r--r--Master/texmf-dist/doc/latex/visualfaq/source/troubleshoot-vlf.tex143
1 files changed, 143 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/visualfaq/source/troubleshoot-vlf.tex b/Master/texmf-dist/doc/latex/visualfaq/source/troubleshoot-vlf.tex
new file mode 100644
index 00000000000..10a2d3a99ae
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/visualfaq/source/troubleshoot-vlf.tex
@@ -0,0 +1,143 @@
+\documentclass[11pt,a5paper]{article}
+\usepackage{cooltooltips}
+\usepackage[T1]{fontenc}
+\usepackage{bookman}
+\usepackage[activate]{pdfcprot}
+\usepackage{geometry}
+\usepackage{parskip}
+\usepackage{color}
+\usepackage{titlesec}
+\usepackage[pdfpagemode=None]{hyperref}
+
+% Define this document's metadata.
+\title{\textcolor{titlecolor}{\bfseries Troubleshooting the \vlf}}
+\author{Scott Pakin \\ \textit{scott+vfaq@pakin.org}}
+\hypersetup{%
+ pdftitle={Troubleshooting the Visual LaTeX FAQ},
+ pdfauthor={Scott Pakin, scott+vfaq@pakin.org},
+ pdfsubject={Helping to diagnose problems with interactive PDF features},
+ pdfkeywords={Visual LaTeX FAQ, PDF, hyperlinks, widgets, Web browser}
+}
+
+% Define a helpful shortcut.
+\newcommand*{\vlf}{\emph{Visual \LaTeX{} FAQ}}
+
+% Introduce a little extra space between paragraphs.
+\parskip=0.8\baselineskip
+\advance\parskip by 0pt plus 2pt
+
+% Define a background color, text color, and hyperlink color.
+\definecolor{bgcolor}{rgb}{0.95,0.92,1}
+\definecolor{fgcolor}{rgb}{0,0.3,0}
+\definecolor{titlecolor}{rgb}{0,0,1}
+\hypersetup{%
+ menubordercolor={0 0 1},
+ linkbordercolor={0 0 1},
+ urlbordercolor={0 0 1}
+}
+
+% Change the formatting of section titles.
+\titleformat{\section}{\Large\bfseries\color{titlecolor}}{\thesection.}{1em}{}
+\newcommand{\sectionbreak}{\clearpage}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{document}
+\pagecolor{bgcolor}
+\hypertarget{link:title}{\maketitle}
+\color{fgcolor}
+\sloppy
+
+The \vlf{} makes extensive use of PDF hyperlinks, widgets, and
+form fields. Not all of these are supported by every PDF
+viewer. Furthermore, even PDF viewers that support hyperlinks
+may need to be configured to launch a Web browser when a link to a Web
+page is activated.
+
+The purpose of this document is to help diagnose problems involving the
+interactive features of the \vlf.
+
+Ready? Then let's begin\dots
+
+
+\section{Internal hyperlinks}
+
+The simplest form of hyperlink jumps from one page of a document to
+another page in the same document:
+
+\begin{center}
+ \hyperlink{link:title}{Return to page~1.\strut}
+\end{center}
+
+The text ``Return to page~1'' is a hyperlink. Activating it should
+take you back to the first page of this document.
+
+If nothing happens then your PDF viewer probably doesn't
+support any sort of hyperlink. You will get little use out of the
+\vlf{} unless you switch to a PDF viewer that supports
+hyperlinks.
+
+Let's move on to the next test\dots
+
+
+\section{External hyperlinks}
+
+The PDF format supports hyperlinks to other documents,
+including non-PDF documents. All of the hyperlinks in the
+\vlf{} refer to Web pages. The following hyperlink points to the UK
+\TeX\ FAQ home page:
+
+\begin{center}
+ \href{http://www.tex.ac.uk/faq}{Open a Web browser.\strut}
+\end{center}
+
+If nothing happens when you activate ``Open a Web browser'' then one
+of the following is likely to be the case:
+
+\begin{itemize}
+ \item Your PDF viewer doesn't support external hyperlinks.
+ You will get little use out of the \vlf{} unless you switch to a
+ PDF viewer that supports hyperlinks.
+
+ \item You need to tell your PDF viewer which application you want to
+ use as your Web browser. In some of Adobe's PDF viewers, the
+ browser-selection dialog can be found under
+ \Acrobatmenu{Weblink:Prefs}{Edit$\rightarrow$\linebreak[0]Preferences$\rightarrow$\linebreak[0]Weblink\strut}.
+ The procedure to associate a Web browser with external hyperlinks
+ will of course be different in other PDF viewers.
+\end{itemize}
+
+If your PDF viewer opened a Web browser at the UK \TeX\ FAQ
+home page, then you'll likely be able to use the \vlf.
+
+There's just one final test to try to make sure\dots
+
+
+\section{Pop-up notes}
+
+Instead of relying upon simple hyperlinks, the \vlf{} works some PDF
+magic to convey additional information via tooltips and pop-up notes.
+Unfortunately, few PDF viewers support all of the requisite PDF
+mechanisms: \textsf{Text} annotations, \textsf{Widget} annotations,
+form fields, and JavaScript. See if the following hyperlink works in
+your PDF viewer:
+
+\begin{center}
+ \cooltooltip[0 0 1]{A pop-up note}{Additional information would
+ normally appear here.}{http://www.tex.ac.uk/faq}{The UK TeX
+ FAQ}{Fancy, \vlf-style hyperlink\strut}
+\end{center}
+
+If all goes well, moving the mouse pointer over the ``Fancy,
+\vlf-style hyperlink'' text should display a tooltip that reads,
+``\textsf{The UK TeX FAQ}'', and pop up a small window entitled
+``\textsf{A pop-up note}'' and containing a line of text.
+
+Whether or not the tooltip and pop-up note work in your PDF viewer,
+activating the hyperlink should open a Web browser at the UK \TeX\ FAQ
+home page. If so, then \mbox{\emph{Congratulations!}}; the \vlf{} is
+almost certainly usable with your PDF viewer. If not, then
+\cooltooltiptoggle{\fcolorbox{titlecolor}{bgcolor}{disabling pop-ups}}
+(clicking again re-enables them) may solve the problem.
+
+\end{document}