diff options
author | Karl Berry <karl@freefriends.org> | 2018-06-13 21:44:46 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2018-06-13 21:44:46 +0000 |
commit | 046927b57b0a0739186f6d42b6af76218d6d2f6a (patch) | |
tree | 9fecdcbfd798eaf83f09b4e276a0ae5757c19161 /Master/texmf-dist/doc/latex/xbmks | |
parent | 0dc40a1ee19496b265caf65c297647f19b2a6096 (diff) |
xbmks (13jun18)
git-svn-id: svn://tug.org/texlive/trunk@48005 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/xbmks')
-rw-r--r-- | Master/texmf-dist/doc/latex/xbmks/README.md | 7 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xbmks/docs/xbmks.pdf | bin | 0 -> 90233 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xbmks/docs/xbmksman.pdf | bin | 193947 -> 200688 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xbmks/docs/xbmksman.tex | 32 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xbmks/examples/doc1.pdf | bin | 31874 -> 13348 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xbmks/examples/doc1.tex | 5 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xbmks/examples/doc2.pdf | bin | 30227 -> 11984 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xbmks/examples/doc2.tex | 4 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xbmks/examples/master.pdf | bin | 53092 -> 15811 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xbmks/examples/master.tex | 8 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xbmks/examples/stand-alone.tex | 51 |
11 files changed, 90 insertions, 17 deletions
diff --git a/Master/texmf-dist/doc/latex/xbmks/README.md b/Master/texmf-dist/doc/latex/xbmks/README.md index cab5c8ab91d..fc53fd66899 100644 --- a/Master/texmf-dist/doc/latex/xbmks/README.md +++ b/Master/texmf-dist/doc/latex/xbmks/README.md @@ -1,6 +1,6 @@ The xbmks Package Author: D. P. Story -Dated: 2018/06/11 +Dated: 2018/06/13 Short description: Create a cross-document bookmark tree. @@ -16,6 +16,11 @@ the bundle. PDF Creator: no restrictions, use dvips->distiller|ps2pdf, pdflatex, lualatex, or xelatex. +What's New (2018/06/13) Corrected a misspelling in the driver specification +for pdfmark. Now allow the docbundle key to be empty or missing; in this +case, we set docbundle=\jobname. Bookmarks are generated for that document +alone, as an extra benefit, the keys colors and style are still obeyed. + Now, I simply must get back to my retirement. diff --git a/Master/texmf-dist/doc/latex/xbmks/docs/xbmks.pdf b/Master/texmf-dist/doc/latex/xbmks/docs/xbmks.pdf Binary files differnew file mode 100644 index 00000000000..4cbeca1dd3d --- /dev/null +++ b/Master/texmf-dist/doc/latex/xbmks/docs/xbmks.pdf diff --git a/Master/texmf-dist/doc/latex/xbmks/docs/xbmksman.pdf b/Master/texmf-dist/doc/latex/xbmks/docs/xbmksman.pdf Binary files differindex 178da6d808a..c6fd8d39a0c 100644 --- a/Master/texmf-dist/doc/latex/xbmks/docs/xbmksman.pdf +++ b/Master/texmf-dist/doc/latex/xbmks/docs/xbmksman.pdf diff --git a/Master/texmf-dist/doc/latex/xbmks/docs/xbmksman.tex b/Master/texmf-dist/doc/latex/xbmks/docs/xbmksman.tex index bff6b09c411..149e707b375 100644 --- a/Master/texmf-dist/doc/latex/xbmks/docs/xbmksman.tex +++ b/Master/texmf-dist/doc/latex/xbmks/docs/xbmksman.tex @@ -11,11 +11,16 @@ aebxmp ]{aeb_pro} \usepackage{aeb_mlink} +\usepackage{xbmks} \usepackage{graphicx,array} %\usepackage{myriadpro} %\usepackage{calibri} \usepackage[altbullet]{lucidbry} +\xbmksetup{colors={intdoc=red},style={intbf}} + +\addtolength{\marginparwidth}{20pt} + %\previewtrue %\usepackage{makeidx} %\makeindex @@ -56,7 +61,7 @@ email={dpstory@acrotex.net}, subject={Documentation for the richtext package from AcroTeX}, talksite={\url{www.acrotex.net}}, - version={1.0, 2018/06/11}, + version={v1.1, 2018/06/13}, keywords={AcroTeX, rich text strings}, copyrightStatus=True, copyrightNotice={Copyright (C) \the\year, D. P. Story}, @@ -193,9 +198,9 @@ options. \paragraph*{Description of the key-values} \begin{description} - \item[\texttt{docbundle}] (Required) The value of this key, \emph{which - is required to be nonempty}, is a comma-delimited list of base names - that are a part of this document collection, or bundle. For example, + \item[\texttt{docbundle}] (Optional) The value of this key, if present, + is a comma-delimited list of base names that are a part of this + document collection, or bundle. For example, \begin{Verbatim}[xleftmargin=\amtIndent] docbundle={lesson1,lesson2,lesson3,lesson4} \end{Verbatim} @@ -214,6 +219,15 @@ files is the one currently being compiled; it is necessary in order to create a internal jump or an external jump. If anything goes wrong, be sure to check the spelling of each file listed. +\textbf{Empty or missing \texttt{docbundle} key.} If this key is missing, +then it is assigned a value of \cs{jobname}. As a result, normal bookmarks +are generated for the document \cs{jobname}; however, as an extra benefit, +the other keys are obeyed (\texttt{colors} and \texttt{style}). See the +sample file \texttt{stand-alone.tex} found in the \texttt{examples} file. +This manual uses the \pkg{xbmks} package with, +\begin{Verbatim}[xleftmargin=\amtIndent] +\xbmksetup{colors={intdoc=red},style={intbf}} +\end{Verbatim} \item[\texttt{colors}] (Optional) For any given document in the bundle, there are two types of links in the bookmarks, a link to an item in the current (or internal) document, or a link to an external document @@ -316,15 +330,17 @@ document links. collection and the \texttt{xbmks.cfg} configuration file that contains your setup options for the whole collection. \item If you are using \app{pdflatex}, \app{lualatex}, or - \app{xelatex}, you are done; otherwise, covert each DVI file to PS + \app{xelatex}, you are done; otherwise, convert each DVI file to PS using \app{dvips}. Finally, convert each PS file in the collection to PDF using \app{Acrobat Distiller} or \app{ps2pdf}. \item Delete all auxiliary file, including \texttt{xbmks.cfg} if you wish. \end{enumerate} If you are on \app{Windows OS}, you can use the -\app{\href{http://www.acrotex.net/builders/}{AeB Builder}} -utility.\footnote{\url{http://www.acrotex.net/builders/}} In that utility, you would select the -\app{External cross-references} option, found on the user-interface. +\app{\href{http://www.acrotex.net/builders/}{AeB Builder}} utility to build +the entire bundle of +documents.\footnote{\url{http://www.acrotex.net/builders/}} In that utility, +you would select the \app{External cross-references} option, found on the +user-interface. \paragraph*{Sample files.} The demonstration files are found in the \texttt{examples} folder. The \pkg{xcolor} package is used, otherwise, the packages used are minimal. diff --git a/Master/texmf-dist/doc/latex/xbmks/examples/doc1.pdf b/Master/texmf-dist/doc/latex/xbmks/examples/doc1.pdf Binary files differindex 351354a5363..df5d6497a3a 100644 --- a/Master/texmf-dist/doc/latex/xbmks/examples/doc1.pdf +++ b/Master/texmf-dist/doc/latex/xbmks/examples/doc1.pdf diff --git a/Master/texmf-dist/doc/latex/xbmks/examples/doc1.tex b/Master/texmf-dist/doc/latex/xbmks/examples/doc1.tex index 10dda228034..e45c5d894b5 100644 --- a/Master/texmf-dist/doc/latex/xbmks/examples/doc1.tex +++ b/Master/texmf-dist/doc/latex/xbmks/examples/doc1.tex @@ -1,11 +1,12 @@ -\documentclass{article} +\documentclass[12pt]{article} \usepackage{xcolor} +%\usepackage{xr-hyper} \usepackage[bookmarksopen]{hyperref} \usepackage{xbmks} + % the xr-hyper package may also be used if you have % cross document links within the body of the doc -%\usepackage{xr-hyper} %\externaldocument[m-]{master} %\externaldocument[d2-]{doc2} diff --git a/Master/texmf-dist/doc/latex/xbmks/examples/doc2.pdf b/Master/texmf-dist/doc/latex/xbmks/examples/doc2.pdf Binary files differindex 494fa06b274..331bffa81d9 100644 --- a/Master/texmf-dist/doc/latex/xbmks/examples/doc2.pdf +++ b/Master/texmf-dist/doc/latex/xbmks/examples/doc2.pdf diff --git a/Master/texmf-dist/doc/latex/xbmks/examples/doc2.tex b/Master/texmf-dist/doc/latex/xbmks/examples/doc2.tex index 9229cb1473e..9f033fefe80 100644 --- a/Master/texmf-dist/doc/latex/xbmks/examples/doc2.tex +++ b/Master/texmf-dist/doc/latex/xbmks/examples/doc2.tex @@ -1,11 +1,11 @@ -\documentclass{article} +\documentclass[12pt]{article} \usepackage{xcolor} +%\usepackage{xr-hyper} \usepackage[bookmarksopen]{hyperref} \usepackage{xbmks} % the xr-hyper package may also be used if you have % cross document links within the body of the doc -%\usepackage{xr-hyper} %\externaldocument[m-]{master} %\externaldocument[d1-]{doc1} diff --git a/Master/texmf-dist/doc/latex/xbmks/examples/master.pdf b/Master/texmf-dist/doc/latex/xbmks/examples/master.pdf Binary files differindex f82fe27dc2d..63d6ad0cc0c 100644 --- a/Master/texmf-dist/doc/latex/xbmks/examples/master.pdf +++ b/Master/texmf-dist/doc/latex/xbmks/examples/master.pdf diff --git a/Master/texmf-dist/doc/latex/xbmks/examples/master.tex b/Master/texmf-dist/doc/latex/xbmks/examples/master.tex index 21bd1f47927..1b0806a3ad6 100644 --- a/Master/texmf-dist/doc/latex/xbmks/examples/master.tex +++ b/Master/texmf-dist/doc/latex/xbmks/examples/master.tex @@ -1,24 +1,24 @@ -\documentclass{article} +\documentclass[12pt]{article} \usepackage{xcolor} +%\usepackage{xr-hyper} \usepackage[bookmarksopen]{hyperref} \usepackage{xbmks} % the xr-hyper package may also be used if you have % cross document links within the body of the doc -%\usepackage{xr-hyper} %\externaldocument[d1-]{doc1} %\externaldocument[d2-]{doc2} \title{On merging bookmarks for several documents} \author{D. P. Story} -% The \xbmksetup command is placed in only +% The \xbmksetup command is placed in only % one of the collection. It is written to xbmks.cfg % in input by the other files to obtain uniformity % of option choices. \xbmksetup{% docbundle={master,doc1,doc2}, -% colors={intdoc=red,extdoc}, + colors={intdoc=red,extdoc}, style={intbf} } diff --git a/Master/texmf-dist/doc/latex/xbmks/examples/stand-alone.tex b/Master/texmf-dist/doc/latex/xbmks/examples/stand-alone.tex new file mode 100644 index 00000000000..cb2a34fe0b6 --- /dev/null +++ b/Master/texmf-dist/doc/latex/xbmks/examples/stand-alone.tex @@ -0,0 +1,51 @@ +\documentclass[12pt]{article} +\usepackage{xcolor} +\usepackage[bookmarksopen]{hyperref} +\usepackage{xbmks} + +\title{Stand alone document} +\author{D. P. Story} + +\xbmksetup{% +% docbundle={\jobname}, + colors={intdoc=red,extdoc}, + style={intbf} +} + +\begin{document} + +\maketitle + +\section{Section One} + +When the \texttt{docbundle} key is either empty or is not present, \textsf{xbmks} sets it +to \verb~\jobname~. No cross-document bookmarks are generated because there was no specification +for creating (multiple values for \texttt{docbundle}); instead, we obtain a standard document +with bookmarks, but the color and style of of the bookmarks are controlled by the \texttt{colors} +and \texttt{style} keys, as seen in the preamble. + +\subsection{Section One: subSec 1} + +Some content goes here. + +\newpage + + +\section{Section Two} + +Some content goes here. + + +\subsection{Section Two: subSec 1} + +Some content goes here. + +\newpage + +\subsection{Section Two: subSec 2} + +Some content goes here. + + +\end{document} + |