[Rd] Links to non-vignette documentation

[Romain Francois]

Le 24.02.2006 01:26, Berwin A Turlach a écrit :
> G'day all,
>
> seems as if I must have slept through most of this most interesting
> discussion. :)
>
>   
>>>>>> "BR" == Prof Brian Ripley <ripley at stats.ox.ac.uk> writes:
>>>>>>             
>
>     BR> On Thu, 23 Feb 2006, hadley wickham wrote:
>     >> How can I write an index file with a pointer to my pdf?  Should
>     >> I provide a code snippet to run
>     >> system(paste(getOption("pdfviewer"), system.file("doc/my.pdf",
>     >> package="mypackage"), "&"))?
>     BR> Just add a hyperlink in inst/doc/index.html to foo.pdf and let
>     BR> the browser do the rest.  The grid/doc/index.html is a
>     BR> suitable template.
> Editing this file by hand is certainly an option, but one more think
> to remember while maintaining a package.  Thus, I think it is
> preferable to automate process as much as possible.  I ran into a
> similar problem as Hadley with a package that I am currently developing
> (since some time) and offer my solution below.
>
>   
>>>>>> "DM" == Duncan Murdoch <murdoch at stats.uwo.ca> writes:
>>>>>>             
>
>     DM> On 2/23/2006 4:23 PM, hadley wickham wrote:
>     >> What about (eg.) help(package=grid)?  This is where vignettes
>     >> are listed by name (and location).  I would like to be able put
>     >> my pdf into a similar list.
>     DM> I don't think you can do that, but you should be using a
>     DM> package man page anyway.
> I believe this can be done, albeit not directly.
>
> In my case, I wanted to include a PDF, whose source is not in Sweave
> format, with the documentation of the package and have the links to
> this documentation created automatically.  My solution, in the end was
> to create a "dummy" Rnw vignette which has a link to the pdf file.  I
> include that dummy vignette below.  Hence, in the directory inst/doc
> of my package there are the following files:
>     interface96.pdf             The PDF file I actually want to include
>                                 as part of the documentation
>     interface96-vignette.Rnw    The dummy vignette file
> Using hyperref with a "file:" url, the dummy vignette file links to
> the actual files.
>
> For the user, this means that she/he sees the dummy vignette and
> access it first and then has to click once more on a link to get to
> the actual document.  Slightly inconvenient for the user, but I
> believe it is a fair price to pay to make my life as developer
> easier. ;-))
>
> If you want to distribute binary copies (e.g. for the various version
> of Windows that exists) of your package, then you need of course all
> the tools that are necessary to handle vignettes.
>
> Cheers,
>
>         Berwin
>
> ------------------------- Source of dummy vignette -------------------------
> \documentclass[a4paper]{article}
> %\VignetteIndexEntry{Interface '96 paper by Marron et al. (1997)}
> %\VignettePackage{clps}
>
> \usepackage{hyperref}
> \usepackage{natbib}
>
> \title{Interface '96 paper by \cite{mar:tur:wan:96}}
> \author{Berwin A Turlach}
> \date{September 25, 2004}
>
> \begin{document}
> \maketitle
>
> This is just a dummy vignette with a link to the 
> \href{file:interface96.pdf}{PDF file} of \cite{mar:tur:wan:96} which
> is part of the \textit{CLPS} package.  The dummy vignette should
> appear in the automatically generated index, but I did not succeed in
> getting the actual paper to appear in that index.
>
> \bibliographystyle{dcunsp}
> \bibliography{clps}
>
> \end{document}
>   
Hi,

What about using the latex package pdfpages to copy the pages from your 
PDF file `interface96.pdf` to your Sweave file. (I don't know if it is 
compatible with Sweave).

Not tested :

\documentclass[a4paper]{article}
%\VignetteIndexEntry{Interface '96 paper by Marron et al. (1997)}
%\VignettePackage{clps}

\usepackage{hyperref}
\usepackage{natbib}
\usepackage{pdfpages}

\title{Interface '96 paper by \cite{mar:tur:wan:96}}
\author{Berwin A Turlach}
\date{September 25, 2004}

\begin{document}
\maketitle

\newpage

\includepdf{interface96.pdf}


\bibliographystyle{dcunsp}
\bibliography{clps}

\end{document}


Romain
 

-- 
visit the R Graph Gallery : http://addictedtor.free.fr/graphiques
Discover the R Movies Gallery : http://addictedtor.free.fr/movies
+---------------------------------------------------------------+
| Romain FRANCOIS - http://francoisromain.free.fr               |
| Doctorant INRIA Futurs / EDF                                  |
+---------------------------------------------------------------+