diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/oberdiek/bookmark.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/oberdiek/bookmark.dtx | 136 |
1 files changed, 97 insertions, 39 deletions
diff --git a/Master/texmf-dist/source/latex/oberdiek/bookmark.dtx b/Master/texmf-dist/source/latex/oberdiek/bookmark.dtx index e4603494c7e..d808bc07946 100644 --- a/Master/texmf-dist/source/latex/oberdiek/bookmark.dtx +++ b/Master/texmf-dist/source/latex/oberdiek/bookmark.dtx @@ -1,11 +1,12 @@ % \iffalse meta-comment -% +% % File: bookmark.dtx -% Version: 2011/04/21 v1.21 -% +% Version: 2011/12/02 v1.24 +% Info: PDF bookmarks +% % Copyright (C) 2007-2011 by % Heiko Oberdiek <heiko.oberdiek at googlemail.com> -% +% % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either % version 1.3c of this license or (at your option) any later @@ -15,22 +16,22 @@ % http://www.latex-project.org/lppl.txt % and version 1.3 or later is part of all distributions of % LaTeX version 2005/12/01 or later. -% +% % This work has the LPPL maintenance status "maintained". -% +% % This Current Maintainer of this work is Heiko Oberdiek. -% +% % This work consists of the main source file bookmark.dtx % and the derived files % bookmark.sty, bookmark.pdf, bookmark.ins, bookmark.drv, % bkm-dvipdfm.def, bkm-dvips.def, bkm-dvipsone.def, % bkm-textures.def, bkm-pdftex.def, bkm-vtex.def, % bookmark-example.tex. -% +% % Distribution: % CTAN:macros/latex/contrib/oberdiek/bookmark.dtx % CTAN:macros/latex/contrib/oberdiek/bookmark.pdf -% +% % Unpacking: % (a) If bookmark.ins is present: % tex bookmark.ins @@ -39,7 +40,7 @@ % (c) If you insist on using LaTeX % latex \let\install=y\input{bookmark.dtx} % (quote the arguments according to the demands of your shell) -% +% % Documentation: % (a) If bookmark.drv is present: % latex bookmark.drv @@ -49,14 +50,14 @@ % if available. Here you can specify further options, e.g. % use A4 as paper format: % \PassOptionsToClass{a4paper}{article} -% +% % Programm calls to get the documentation (example): % pdflatex bookmark.dtx % makeindex -s gind.ist bookmark.idx % pdflatex bookmark.dtx % makeindex -s gind.ist bookmark.idx % pdflatex bookmark.dtx -% +% % Installation: % TDS:tex/latex/oberdiek/bookmark.sty % TDS:tex/latex/oberdiek/bkm-dvipdfm.def @@ -84,7 +85,7 @@ \input docstrip.tex \Msg{************************************************************************} \Msg{* Installation} -\Msg{* Package: bookmark 2011/04/21 v1.21 PDF bookmarks (HO)} +\Msg{* Package: bookmark 2011/12/02 v1.24 PDF bookmarks (HO)} \Msg{************************************************************************} \keepsilent @@ -96,7 +97,7 @@ This is a generated file. Project: bookmark -Version: 2011/04/21 v1.21 +Version: 2011/12/02 v1.24 Copyright (C) 2007-2011 by Heiko Oberdiek <heiko.oberdiek at googlemail.com> @@ -138,6 +139,10 @@ and the derived files \file{bkm-vtex.def}{\from{bookmark.dtx}{vtex}}% \usedir{doc/latex/oberdiek}% \file{bookmark-example.tex}{\from{bookmark.dtx}{example}}% + \nopreamble + \nopostamble + \usedir{source/latex/oberdiek/catalogue}% + \file{bookmark.xml}{\from{bookmark.dtx}{catalogue}}% } \catcode32=13\relax% active space @@ -166,16 +171,16 @@ and the derived files %<*driver> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{bookmark.drv}% - [2011/04/21 v1.21 PDF bookmarks (HO)]% + [2011/12/02 v1.24 PDF bookmarks (HO)]% \documentclass{ltxdoc} -\usepackage{holtxdoc}[2011/02/04] +\usepackage{holtxdoc}[2011/11/22] \begin{document} \DocInput{bookmark.dtx}% \end{document} %</driver> % \fi % -% \CheckSum{2323} +% \CheckSum{2326} % % \CharacterTable % {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z @@ -196,7 +201,7 @@ and the derived files % \GetFileInfo{bookmark.drv} % % \title{The \xpackage{bookmark} package} -% \date{2011/04/21 v1.21} +% \date{2011/12/02 v1.24} % \author{Heiko Oberdiek\\\xemail{heiko.oberdiek at googlemail.com}} % % \maketitle @@ -268,8 +273,7 @@ and the derived files % If a \LaTeX\ file is compiled several times, then a little % time can be saved, if option \xoption{draft} is used to % disable the bookmark stuff of this package. Default is -% \xoption{final}. If \cs{pdfdraftmode} is available, then -% the default is {draft} if draft mode is enabled. +% \xoption{final}. % Both options are boolean options, without % value the value |true| is used. |draft=true| is the same % as |final=false|. @@ -656,7 +660,7 @@ and the derived files open, openlevel=2, atend -]{bookmark}[2011/04/21] +]{bookmark}[2011/12/02] \bookmarksetup{color=blue} @@ -759,7 +763,7 @@ and the derived files %<*package> \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{bookmark}% - [2011/04/21 v1.21 PDF bookmarks (HO)]% + [2011/12/02 v1.24 PDF bookmarks (HO)]% % \end{macrocode} % % \subsubsection{Requirements} @@ -929,7 +933,6 @@ and the derived files % \begin{macrocode} \DeclareBoolOption{draft} \DeclareComplementaryOption{final}{draft} -\pdf@ifdraftmode\BKM@drafttrue{} % \end{macrocode} % \begin{macro}{\BKM@DisableOptions} % \begin{macrocode} @@ -1708,7 +1711,8 @@ and the derived files \let\BookmarkAtEnd\ltx@gobble \let\bookmarkdefinestyle\ltx@gobbletwo \let\bookmarkget\ltx@gobble - \renewcommand*{\pdfbookmark}[3][]{}% + \let\pdfbookmark\ltx@undefined + \newcommand*{\pdfbookmark}[3][]{}% \let\currentpdfbookmark\ltx@gobbletwo \let\subpdfbookmark\ltx@gobbletwo \let\belowpdfbookmark\ltx@gobbletwo @@ -1805,7 +1809,8 @@ and the derived files % % \begin{macro}{\pdfbookmark} % \begin{macrocode} -\renewcommand*{\pdfbookmark}[3][0]{% +\let\pdfbookmark\ltx@undefined +\newcommand*{\pdfbookmark}[3][0]{% \bookmark[level=#1,dest={#3.#1}]{#2}% \hyper@anchorstart{#3.#1}\hyper@anchorend } @@ -1813,14 +1818,14 @@ and the derived files % \end{macro} % \begin{macro}{\currentpdfbookmark} % \begin{macrocode} -\renewcommand*{\currentpdfbookmark}{% +\def\currentpdfbookmark{% \pdfbookmark[\BKM@currentlevel]% } % \end{macrocode} % \end{macro} % \begin{macro}{\subpdfbookmark} % \begin{macrocode} -\renewcommand*{\subpdfbookmark}{% +\def\subpdfbookmark{% \BKM@CalcExpr\BKM@CalcResult\BKM@currentlevel+1% \expandafter\pdfbookmark\expandafter[\BKM@CalcResult]% } @@ -1828,7 +1833,7 @@ and the derived files % \end{macro} % \begin{macro}{\belowpdfbookmark} % \begin{macrocode} -\renewcommand*{\belowpdfbookmark}[2]{% +\def\belowpdfbookmark#1#2{% \xdef\BKM@gtemp{\number\BKM@currentlevel}% \subpdfbookmark{#1}{#2}% \global\let\BKM@currentlevel\BKM@gtemp @@ -1839,7 +1844,7 @@ and the derived files % Section number, text, label, level, file % \begin{macro}{\Hy@writebookmark} % \begin{macrocode} -\renewcommand*{\Hy@writebookmark}[5]{% +\def\Hy@writebookmark#1#2#3#4#5{% \ifnum#4>\BKM@depth\relax \else \def\BKM@type{#5}% @@ -1880,7 +1885,7 @@ and the derived files %<*dvipdfm> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{bkm-dvipdfm.def}% - [2011/04/21 v1.21 bookmark driver for dvipdfm (HO)]% + [2011/12/02 v1.24 bookmark driver for dvipdfm (HO)]% % \end{macrocode} % % \begin{macro}{\BKM@id} @@ -2055,7 +2060,7 @@ and the derived files %<*vtex> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{bkm-vtex.def}% - [2011/04/21 v1.21 bookmark driver for VTeX (HO)]% + [2011/12/02 v1.24 bookmark driver for VTeX (HO)]% % \end{macrocode} % % \begin{macrocode} @@ -2263,7 +2268,7 @@ and the derived files % \begin{macro}{\BKM@toHexDigit} % \begin{macrocode} \def\BKM@toHexDigit#1{% - \expandafter\ifcase\expandafter\@firstofone\expandafter{\number#1} % + \ifcase\expandafter\@firstofone\expandafter{\number#1} % 0\or 1\or 2\or 3\or 4\or 5\or 6\or 7\or 8\or 9\or A\or B\or C\or D\or E\or F% \fi @@ -2386,7 +2391,7 @@ and the derived files %<*pdftex> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{bkm-pdftex.def}% - [2011/04/21 v1.21 bookmark driver for pdfTeX (HO)]% + [2011/12/02 v1.24 bookmark driver for pdfTeX (HO)]% % \end{macrocode} % % \begin{macro}{\BKM@DO@entry} @@ -2542,7 +2547,7 @@ and the derived files %<*dvips> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{bkm-dvips.def}% - [2011/04/21 v1.21 bookmark driver for dvips (HO)]% + [2011/12/02 v1.24 bookmark driver for dvips (HO)]% % \end{macrocode} % \begin{macro}{\BKM@PSHeaderFile} % \begin{macrocode} @@ -2561,7 +2566,7 @@ and the derived files %<*dvipsone> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{bkm-dvipsone.def}% - [2011/04/21 v1.21 bookmark driver for dvipsone (HO)]% + [2011/12/02 v1.24 bookmark driver for dvipsone (HO)]% % \end{macrocode} % \begin{macro}{\BKM@PSHeaderFile} % \begin{macrocode} @@ -2580,7 +2585,7 @@ and the derived files %<*textures> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{bkm-textures.def}% - [2011/04/21 v1.21 bookmark driver for textures (HO)]% + [2011/12/02 v1.24 bookmark driver for textures (HO)]% % \end{macrocode} % \begin{macro}{\BKM@PSHeaderFile} % \begin{macrocode} @@ -3248,20 +3253,59 @@ and the derived files %\end{verbatim} % \end{quote} % +% \section{Catalogue} +% +% The following XML file can be used as source for the +% \href{http://mirror.ctan.org/help/Catalogue/catalogue.html}{\TeX\ Catalogue}. +% The elements \texttt{caption} and \texttt{description} are imported +% from the original XML file from the Catalogue. +% The name of the XML file in the Catalogue is \xfile{bookmark.xml}. +% \begin{macrocode} +%<*catalogue> +<?xml version='1.0' encoding='us-ascii'?> +<!DOCTYPE entry SYSTEM 'catalogue.dtd'> +<entry datestamp='$Date$' modifier='$Author$' id='bookmark'> + <name>bookmark</name> + <caption>A new bookmark (outline) organization for hyperref.</caption> + <authorref id='auth:oberdiek'/> + <copyright owner='Heiko Oberdiek' year='2007-2011'/> + <license type='lppl1.3'/> + <version number='1.24'/> + <description> + This package implements a new bookmark (outline) organization for + package <xref refid='hyperref'>hyperref</xref>. Bookmark properties such + as style and color can now be set. Other action types + are available (URI, GoToR, Named). The bookmarks are + generated in the first compile run. Package + <xref refid='hyperref'>hyperref</xref> uses two runs. + <p/> + The package is part of the <xref refid='oberdiek'>oberdiek</xref> + bundle. + </description> + <documentation details='Package documentation' + href='ctan:/macros/latex/contrib/oberdiek/bookmark.pdf'/> + <ctan file='true' path='/macros/latex/contrib/oberdiek/bookmark.dtx'/> + <miktex location='oberdiek'/> + <texlive location='oberdiek'/> + <install path='/macros/latex/contrib/oberdiek/oberdiek.tds.zip'/> +</entry> +%</catalogue> +% \end{macrocode} +% % \begin{thebibliography}{9} -% +% % \bibitem{hyperref} % Sebastian Rahtz, Heiko Oberdiek: % \textit{The \xpackage{hyperref} package}; % 2011/04/17 v6.82g; % \CTAN{macros/latex/contrib/hyperref/} -% +% % \bibitem{currfile} % Martin Scharrer: % \textit{The \xpackage{currfile} package}; % 2011/01/09 v0.4. % \CTAN{macros/latex/contrib/currfile/} -% +% % \end{thebibliography} % % \begin{History} @@ -3439,6 +3483,20 @@ and the derived files % Some support for file name and line number in error messages % at end of document (pdfTeX and pdfmark based drivers). % \end{Version} +% \begin{Version}{2011/05/13 v1.22} +% \item +% Change of version 2010/11/05 v1.18 reverted, because otherwise +% draftmode disables some \xext{aux} file entries. +% \end{Version} +% \begin{Version}{2011/09/19 v1.23} +% \item +% Some \cs{renewcommand}s changed to \cs{def} to avoid trouble +% if the commands are not defined, because hyperref stopped early. +% \end{Version} +% \begin{Version}{2011/12/02 v1.24} +% \item +% Small optimization in \cs{BKM@toHexDigit}. +% \end{Version} % \end{History} % % \PrintIndex |