From 5882a85eb9148d3c3354663f7cf11de2f0d2de69 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 12 Sep 2010 18:03:36 +0000 Subject: visual 30jul10 (6aug10) git-svn-id: svn://tug.org/texlive/trunk@19677 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/visualfaq/README | 8 +- .../texmf-dist/doc/latex/visualfaq/source/README | 48 +++++++ .../doc/latex/visualfaq/source/README.TXT | 48 ------- .../latex/visualfaq/source/troubleshoot-vlf.tex | 143 --------------------- .../doc/latex/visualfaq/source/visualFAQ.out | 25 ++++ .../doc/latex/visualfaq/source/visualFAQ.tex | 50 +++++-- .../texmf-dist/doc/latex/visualfaq/visualFAQ.pdf | Bin 1667943 -> 1144794 bytes 7 files changed, 117 insertions(+), 205 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/visualfaq/source/README delete mode 100644 Master/texmf-dist/doc/latex/visualfaq/source/README.TXT delete mode 100644 Master/texmf-dist/doc/latex/visualfaq/source/troubleshoot-vlf.tex create mode 100644 Master/texmf-dist/doc/latex/visualfaq/source/visualFAQ.out (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/visualfaq/README b/Master/texmf-dist/doc/latex/visualfaq/README index e0504bb3f31..bfcaec5e424 100644 --- a/Master/texmf-dist/doc/latex/visualfaq/README +++ b/Master/texmf-dist/doc/latex/visualfaq/README @@ -30,14 +30,14 @@ hyperlinks aren't working on your system. Copyright and license ===================== -Copyright (C) 2006 by Scott Pakin, scott+vfaq@pakin.org +Copyright (C) 2010 by Scott Pakin, scott+vfaq@pakin.org This file may be distributed and/or modified under the conditions of -the LaTeX Project Public License, either version 1.3b of this license +the LaTeX Project Public License, either version 1.3c of this license or (at your option) any later version. The latest version of this license is in: http://www.latex-project.org/lppl.txt -and version 1.3b or later is part of all distributions of LaTeX -version 2006/01/07 or later. +and version 1.3c or later is part of all distributions of LaTeX +version 2008/05/04 or later. diff --git a/Master/texmf-dist/doc/latex/visualfaq/source/README b/Master/texmf-dist/doc/latex/visualfaq/source/README new file mode 100644 index 00000000000..77c021b92e6 --- /dev/null +++ b/Master/texmf-dist/doc/latex/visualfaq/source/README @@ -0,0 +1,48 @@ + ___ _____ ___ ___ _ + / __|_ _/ _ \| _ \ | + \__ \ | || (_) | _/_| + |___/ |_| \___/|_| (_) + + +There is nothing in this directory that is of use to the average LaTeX +user. + + If you want to associate ---\ download the cooltooltips + pop-up windows and tooltips ---/ package from CTAN. + with hyperlinks + + If you want to see a code ---\ read the documentation for + example for a particular ---/ whatever package the FAQ + FAQ answer answer recommends. + + If you want to rebuild ---\ don't bother; the content has + the Visual LaTeX FAQ for ---/ been laid out manually and the + whatever reason PDF file has been postprocessed + +The source to the Visual LaTeX FAQ necessarily has to utilize a number +of crude hacks and is more often than not a demonstration of how *not* +to achieve a particular effect. First, a lot of trickery is involved +in wrapping hyperlinks around typesetting examples: If you can't put +something in an \fbox and have it look right then you can't easily put +a hyperlink around it, either. Second, some packages exhibit +contradictory functionality. For example, parskip.sty sets the +paragraph indent to zero for all paragraphs while indentfirst.sty sets +the paragraph indent to a nonzero value for all paragraphs. Clearly, +a LaTeX file can't meaningfully load both packages. + +The good news is that the UK TeX FAQ, to which all of the Visual LaTeX +FAQ's hyperlinks point, is likely to include an increasing number of +code examples (cf. http://tinyurl.com/fj4gz). + +The visualFAQ.pdf file on CTAN has been postprocessed to include page +thumbnails and to support "Fast Web View" (a.k.a. Linearized PDF). +Rebuilding the PDF will lose that metadata. Changes to the document, +including formatting changes, are also not recommended. Because of +the extensive use of unbreakable TeX boxes the document is very +sensitive to layout. Any change is likely to cause ugly slabs of +inter- and intraparagraph whitespace to appear throughout the +document. + +In short, you're best off using the Visual LaTeX FAQ as it was +intended: Browse through the prebuilt visualFAQ.pdf file, click on +hyperlinks of interest, and learn from what the UK TeX FAQ has to say. diff --git a/Master/texmf-dist/doc/latex/visualfaq/source/README.TXT b/Master/texmf-dist/doc/latex/visualfaq/source/README.TXT deleted file mode 100644 index 77c021b92e6..00000000000 --- a/Master/texmf-dist/doc/latex/visualfaq/source/README.TXT +++ /dev/null @@ -1,48 +0,0 @@ - ___ _____ ___ ___ _ - / __|_ _/ _ \| _ \ | - \__ \ | || (_) | _/_| - |___/ |_| \___/|_| (_) - - -There is nothing in this directory that is of use to the average LaTeX -user. - - If you want to associate ---\ download the cooltooltips - pop-up windows and tooltips ---/ package from CTAN. - with hyperlinks - - If you want to see a code ---\ read the documentation for - example for a particular ---/ whatever package the FAQ - FAQ answer answer recommends. - - If you want to rebuild ---\ don't bother; the content has - the Visual LaTeX FAQ for ---/ been laid out manually and the - whatever reason PDF file has been postprocessed - -The source to the Visual LaTeX FAQ necessarily has to utilize a number -of crude hacks and is more often than not a demonstration of how *not* -to achieve a particular effect. First, a lot of trickery is involved -in wrapping hyperlinks around typesetting examples: If you can't put -something in an \fbox and have it look right then you can't easily put -a hyperlink around it, either. Second, some packages exhibit -contradictory functionality. For example, parskip.sty sets the -paragraph indent to zero for all paragraphs while indentfirst.sty sets -the paragraph indent to a nonzero value for all paragraphs. Clearly, -a LaTeX file can't meaningfully load both packages. - -The good news is that the UK TeX FAQ, to which all of the Visual LaTeX -FAQ's hyperlinks point, is likely to include an increasing number of -code examples (cf. http://tinyurl.com/fj4gz). - -The visualFAQ.pdf file on CTAN has been postprocessed to include page -thumbnails and to support "Fast Web View" (a.k.a. Linearized PDF). -Rebuilding the PDF will lose that metadata. Changes to the document, -including formatting changes, are also not recommended. Because of -the extensive use of unbreakable TeX boxes the document is very -sensitive to layout. Any change is likely to cause ugly slabs of -inter- and intraparagraph whitespace to appear throughout the -document. - -In short, you're best off using the Visual LaTeX FAQ as it was -intended: Browse through the prebuilt visualFAQ.pdf file, click on -hyperlinks of interest, and learn from what the UK TeX FAQ has to say. diff --git a/Master/texmf-dist/doc/latex/visualfaq/source/troubleshoot-vlf.tex b/Master/texmf-dist/doc/latex/visualfaq/source/troubleshoot-vlf.tex deleted file mode 100644 index 10a2d3a99ae..00000000000 --- a/Master/texmf-dist/doc/latex/visualfaq/source/troubleshoot-vlf.tex +++ /dev/null @@ -1,143 +0,0 @@ -\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} diff --git a/Master/texmf-dist/doc/latex/visualfaq/source/visualFAQ.out b/Master/texmf-dist/doc/latex/visualfaq/source/visualFAQ.out new file mode 100644 index 00000000000..7e384a5591b --- /dev/null +++ b/Master/texmf-dist/doc/latex/visualfaq/source/visualFAQ.out @@ -0,0 +1,25 @@ +\BOOKMARK [1][]{section.1}{Magna condimentum}{} +\BOOKMARK [1][]{section.2}{Morbi tincidunt lacus}{} +\BOOKMARK [2][]{subsection.2.1}{Vehicula enim}{section.2} +\BOOKMARK [3][]{subsubsection.2.1.1}{Phasellus orci quam}{subsection.2.1} +\BOOKMARK [1][]{section.3}{Fusce dignissim}{} +\BOOKMARK [2][]{subsection.3.1}{Vestibulum ante ipsum primis}{section.3} +\BOOKMARK [1][]{section*.1}{Donec purus}{} +\BOOKMARK [2][]{subsection.4.1}{Mauris sagittis}{section*.1} +\BOOKMARK [2][]{subsection.4.2}{Lacus aliquam egestas}{section*.1} +\BOOKMARK [2][]{subsection.4.3}{Inceptos lacinia tortor vit\346 pulvinar convallis}{section*.1} +\BOOKMARK [2][]{subsection.4.4}{Nunc varius}{section*.1} +\BOOKMARK [1][]{section.5}{Philosophia ei mea}{} +\BOOKMARK [2][]{section*.2}{Ius nonumy ceteros similique}{section.5} +\BOOKMARK [2][]{subsection.5.2}{Dictas euripidis cum id}{section.5} +\BOOKMARK [2][]{subsection.5.3}{Assum minim}{section.5} +\BOOKMARK [2][]{section*.3}{Postea legendos}{section.5} +\BOOKMARK [2][]{subsection.5.5}{Mauris suscipit lectus}{section.5} +\BOOKMARK [1][]{section.6}{Nostrud sed augue}{} +\BOOKMARK [2][]{subsection.6.1}{Velit in autem veniam}{section.6} +\BOOKMARK [2][]{subsection.6.2}{Te lorem blandit}{section.6} +\BOOKMARK [2][]{subsection.6.3}{Ornatus takimata}{section.6} +\BOOKMARK [2][]{subsection.6.4}{Has libris efficiendi omittantur}{section.6} +\BOOKMARK [1][]{section.7}{Consequat constituam mediocritatem}{} +\BOOKMARK [1][]{appendix.A}{Fringilla dictum hendrerit}{} +\BOOKMARK [1][]{section*.9}{Ubique nunc facilis mollis gubergren}{} diff --git a/Master/texmf-dist/doc/latex/visualfaq/source/visualFAQ.tex b/Master/texmf-dist/doc/latex/visualfaq/source/visualFAQ.tex index 7bd650a5da7..d17d4e974b1 100644 --- a/Master/texmf-dist/doc/latex/visualfaq/source/visualFAQ.tex +++ b/Master/texmf-dist/doc/latex/visualfaq/source/visualFAQ.tex @@ -370,7 +370,7 @@ \end{figure*} \begin{multicols}{2} -\section{Magna sociosqu condimentum} +\section{Magna condimentum} \thispagestyle{fancyplain} % Why can't this go earlier? % FAQ: "Big letters at the start of a paragraph" @@ -1325,11 +1325,12 @@ justo. Nunc dignissim, pede quis dignissim ultricies, ante lacus rhoncus ipsum, vel commodo lectus risus vel magna. Nulla eleifend odio sed augue. M\ae{}cenas pretium laoreet arcu. Nullam hendrerit. Curabitur nonummy. Cras volutpat \antifaq{wrongpn}{"Page -number is wrong at start of page"}{page~\thepage} eleifend pede. In ac -arcu non nibh venenatis commodo. Morbi lorem. Sed ullamcorper luctus -enim. Vestibulum et tortor. Quisque elit. Sed molestie tincidunt -auctor pede. Proin felis velit, mattis semper, gravida vel, -ullamcorper semper, mi. M\ae{}cenas varius, felis semper pharetra + number is wrong at start of page"}{page~\thepage} eleifend pede. In +ac arcu non nibh venenatis commodo. Morbi lorem. Sed ullamcorper +luctus enim. Vestibulum et tortor. Quisque elit. Sed molestie +tincidunt auctor pede. Proin felis velit, mattis semper, gravida vel, +ullamcorper semper, mi~\faq{whatbst}{"Choosing a bibliography + style"}{(Dapibus, 1938)}. M\ae{}cenas varius, felis semper pharetra eleifend, felis leo hendrerit tortor, ac tempor wisi nunc eget sapien. Proin viverra pede nec justo. Donec suscipit. Phasellus egestas tortor sit amet sem. M\ae{}cenas dignissim malesuada @@ -1386,6 +1387,16 @@ lectus. Vestibulum ullamcorper aliquam nulla. \label{tbl:sideways} \end{table} +% FAQ: "Repeated graphics in a document'' +\begin{figure} + \centering + \newcommand{\replogobox}{% + \faq{repeatgrf}{"Repeated graphics in a document"}{\usebox{\logobox}}} + \setlength{\baselineskip}{1.5\ht\logobox} + \replogobox \hfil \replogobox \hfil + \replogobox \hfil \replogobox \hfil + \replogobox \hfil \replogobox \par +\end{figure} % FAQ: "Really blank pages between chapters" @@ -2260,6 +2271,24 @@ Congue Magna, Duo Cu, \foreign{and} Mucius Veritus. \foreign{part}~2, \foreign{pages}~189--201, Has Consectetuer, Ut Esse, 3rd~\foreign{edition}, \foreign{November}~1986. +% FAQ: "Choosing a bibliography style" +\makeatletter +\let\orig@biblabel=\@biblabel +\renewcommand*{\@biblabel}[1]{% + [\faq{whatbst}{"Choosing a bibliography style"}{Dapibus, 1938\strut}]% +} +\bibitem{whatbst} +Morbi Dapibus, +\newblock Cum sociis natoque penatibus et magnis dis parturient montes, +\newblock In \emph{Proc.\ of the 8th Intl.\ Conf.\ on Vestibulum Tincidunt}, +\newblock Jan. 3, 1938. + +Choro Fabellas, Modus Consetetur, and Homero D. Invenire. +\newblock Iudico oratio ea sed: Nibh legendos quo an. +\newblock Technical Report~DXVII, University of Iracundia, August 1979. +\let\@biblabel=\orig@biblabel +\makeatother + % FAQ: "Multiple citations" \bibitem{multicite} \faq{mcite}{"Multiple citations"}{\parbox[t]{\linewidth}{% @@ -2306,13 +2335,13 @@ Agam Prima, Congue Everti, and Appetere Facilisis. \newblock Te soleat percipitur an sit ne \faq{citeURL}% {"URLs in BibTeX bibliographies"}% - {\nolinkurl{http://tex.ac.eck.ik/ock-uck/vissentanique.pdf}} + {\nolinkurl{http://www.ctan.org/tex-archive/info/visualFAQ/}} % FAQ: "URLs in BibTeX bibliographies" \bibitem{urls} \faq{citeURL}% {"URLs in BibTeX bibliographies"}% - {\nolinkurl{http://www.vis.faq/~latex/doc.html}} + {\nolinkurl{http://www.ctan.org/tex-archive/info/visualFAQ/}} \end{thebibliography} \bigskip @@ -2475,8 +2504,9 @@ essent lucilius eum. %\noindent %\begin{minipage}{\linewidth} \begin{multicols}{2} -\newcommand{\appendixBname}{Ubique facilis nunc mollis gubergren} -\section*{\faq{appendix}{"Appendixes"}{Appendix~B}\quad\appendixBname} +\newcommand{\appendixBname}{Ubique nunc facilis mollis gubergren} +\section*{\faq{appendix}{"Appendixes"}{% + Appendix~B}\quad\raggedright\appendixBname} \sectionmark{\appendixBname} \phantomsection \addcontentsline{toc}{section}{\appendixBname} diff --git a/Master/texmf-dist/doc/latex/visualfaq/visualFAQ.pdf b/Master/texmf-dist/doc/latex/visualfaq/visualFAQ.pdf index bafc7de6983..59da9c8dcfd 100644 Binary files a/Master/texmf-dist/doc/latex/visualfaq/visualFAQ.pdf and b/Master/texmf-dist/doc/latex/visualfaq/visualFAQ.pdf differ -- cgit v1.2.3