\documentclass[default]{prosper}

\title{What to do when you need hyperlinks in a
  \texttt{prosper}-presentation}
\subtitle{with emphasis on \LaTeX{}-documents converted to html with TeX4ht}
\author{Simen Kvaal}

\institution{Simula Research Laboratory}
\date{Summer 2002}

\slideCaption{Summer 2002}

\newcommand{\bsl}{\symbol{`\\}}
\newcommand{\latexcmd}[1]{\texttt{\bsl#1}}
\newcommand{\myhref}[2]{\href{#1}{\begin{blue}\underline{#2}\end{blue}}}
\newcommand{\knowmore}[1]{\emph{Do you want to know more?}\\#1}
\hyperbaseurl{http://folk.uio.no/simek/links_in_prosper/}

\begin{document}
\maketitle

\begin{slide}{Introduction}
\begin{itemize}
\item \texttt{Prosper} is great for making slides in \LaTeX{}.
\item Viewing the slides on an online computer suggests linking the
  presentation to a web site.
\item More specifically; we want to link to some section in a
  web-document created with \LaTeX{}~and TeX4ht.
\item Let's see wether this is possible!
\end{itemize}
\end{slide}

\begin{slide}{How to insert hyperlinks}
\begin{itemize}
\item Here is an example:
\end{itemize}

\begin{quote}Bram Stoker wrote ``Dracula'' more than a century ago. On
  \myhref{http://promo.net/pg/}{Project Gutenberg} you can find
  ``Dracula'' and hundreds of public domain books online.\end{quote}

\begin{itemize}
\item The link was inserted with the
  \latexcmd{href\{\emph{url}\}\{\emph{text}\}} command. This
  command resides in the \texttt{hyperref}-package, which is
  \emph{included by \texttt{prosper}}.
\item Thus, to insert a hyperlink to an external web-document, one
  only has to insert the appropriate \latexcmd{href}-command.
\end{itemize}
\end{slide}

\begin{slide}{How to insert hyperlinks cont.}
\begin{itemize}
\item Note that the \texttt{urlcolor}-parameter to \texttt{hyperref}
  is obscured by the \texttt{prosper} class, so the best way to do
  create a colored hyperlink is to precede the text with a
  color-command, e.g. \texttt{\{\bsl green \latexcmd{underline}\{text\}\}}
\end{itemize}
\end{slide}

\begin{slide}{Creating hyperlinks in TeX4ht}
\begin{itemize}
\item With TeX4ht one can create splendid html-versions of
  \LaTeX{}-documents. The only trouble is how to know the name of the
  links to various html-pages created.
\item Solution: Exploit TeX4ht's ``hooks'' when issuing sectioning
  commands.
\item I have written a collection of macros in \texttt{customlinks.tex} to
  accomplish this task.
\item Simply issue \latexcmd{input\{customlinks.tex\}} after
  \latexcmd{begin\{document\}}, and the hooks will be set up.
\end{itemize}
\end{slide}

\begin{slide}{Creating hyperlinks in TeX4ht cont.}
\begin{itemize}
\item After compiling the document, run
\begin{verbatim}
cat doc.log | grep Customlinks >links.txt
\end{verbatim}
to create a text file containing descriptions of all the links. They
are all easily read and remembered. (\texttt{doc.log} is the logfile
from your main document.)
\item You can also create custom links wherever you want, with the
  \latexcmd{customlink} and \latexcmd{pagelink} commands.
\item \knowmore{See \myhref{http://www.amazon.co.uk/exec/obidos/ASIN/0201433117/ref=sr_aps_books_1_1/026-6166072-9768429}{the \LaTeX{} Web Companion} and the
    \texttt{customlinks.tex} source.}
\end{itemize}
\end{slide}

\begin{slide}{A simple example: \texttt{dracula.tex}}
\begin{itemize}
\item \myhref{dracula.tex}{\texttt{dracula.tex}} contains some bloody
  sections.
\item The document is converted to html with TeX4ht. See it
    \myhref{http://www.simula.no/~simek/links_in_prosper/dracula.html}{here!}
    (For the sake of simplicity, we don't split the document over
  several html-files.)
\item After running the \texttt{cat}-command mentioned on the previous
  slide, we get this text-file describing the links:
\begin{tiny}\begin{verbatim}
 --- Customlinks says: Link to chapter 1: dracula.html#ch1
 --- Customlinks says: Link to section 1.1: dracula.html#sec1-1
 --- Customlinks says: Link to chapter 2: dracula.html#ch2
 --- Customlinks says: Link to section 2.1: dracula.html#sec2-1
\end{verbatim}\end{tiny}
\item Now, let's see section 2.1, which is from Jonathan Harker's
  journal:
  \myhref{dracula.html\#sec2-1}{Jonathan harker's journal.}
\end{itemize}
\end{slide}

\begin{slide}{Resources}
\begin{itemize}
\item
  \myhref{http://www.amazon.co.uk/exec/obidos/ASIN/0201433117/ref=sr_aps_books_1_1/026-6166072-9768429}{the
  \LaTeX{} Web Companion} can be found in bookstores.
\item 
  The \texttt{prosper} package: \myhref{http://prosper.sourceforge.net}{prosper.sourceforge.net}
\item
  The \LaTeX{} source for this document: \myhref{slides.tex}{slides.tex}
\end{itemize} 
\end{slide}

\end{document}