\documentclass[a4paper]{article}
% generated by Docutils <http://docutils.sourceforge.net/>
\usepackage{fixltx2e} % LaTeX patches, \textsubscript
\usepackage{cmap} % fix search and cut-and-paste in Acrobat
\usepackage{ifthen}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{color}
\setcounter{secnumdepth}{0}

%%% Custom LaTeX preamble
% PDF Standard Fonts
\usepackage{mathptmx} % Times
\usepackage[scaled=.90]{helvet}
\usepackage{courier}

%%% User specified packages and stylesheets

%%% Fallback definitions for Docutils-specific commands

% sidebar (text outside the main text flow)
\providecommand{\DUsidebar}[2][class-arg]{%
  \begin{center}
    \colorbox[gray]{0.80}{\parbox{0.9\linewidth}{#2}}
  \end{center}
}

% title for topics, admonitions, unsupported section levels, and sidebar
\providecommand*{\DUtitle}[2][class-arg]{%
  % call \DUtitle#1{#2} if it exists:
  \ifcsname DUtitle#1\endcsname%
    \csname DUtitle#1\endcsname{#2}%
  \else
    \smallskip\noindent\textbf{#2}\smallskip%
  \fi
}

% hyperlinks:
\ifthenelse{\isundefined{\hypersetup}}{
  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
  \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
}{}


%%% Body
\begin{document}


\section{Link formatting%
  \label{link-formatting}%
}

especially the hash \textquotedbl{}\#\textquotedbl{} character is problematic for LaTeX as it is
used in LaTeX's macro language.

Contributed by d.abrahams

\DUsidebar{
\DUtitle[title]{\texttt{const} and an iterator's \texttt{value\_type}}

argument will be correct for all \href{new-iter-concepts.html\#lvalue-iterators-lib-lvalue-iterators}{lvalue iterators}.
}


\section{hyper links%
  \label{hyper-links}%
}

Explicit targets and references.

\label{section_2}

\phantomsection\label{example}
This paragraph is pointed to by the explicit \textquotedbl{}example\textquotedbl{} target.

\newpage

This is an internal cross-references (\hyperref[example]{example}).

This is an internal cross-references (\hyperref[hyper-links]{hyper links}).

href offers a named link to a hypertarget.

refpage a link with page-number text to a label.

\pageref{section_2}

One might consider adding
%
\begin{description}
\item[{\texttt{\textbackslash{}pageref\{key\}} :}] \leavevmode 
The \texttt{\textbackslash{}pageref command produces the page number of the place in
the text where the corresponding `{}`\textbackslash{}label} command appears. ie.
where \texttt{\textbackslash{}label\{key\}} appears. For a smart version see \texttt{\textbackslash{}vpageref}.

\item[{\texttt{\textbackslash{}ref\{key\}} :}] \leavevmode 
The ref command produces the number of the sectional unit, equation
number, ... of the corresponding label command. For a smart version
see vref.

\end{description}

Smarter version of the original latex2e cross reference commands.
Generated strings are customizable, Babel options are recognized (further
info in the package documentation).
%
\begin{description}
\item[{\texttt{\textbackslash{}vref}, \texttt{\textbackslash{}vpageref} :}] \leavevmode 
\texttt{\textbackslash{}vref} is similar to \texttt{\textbackslash{}ref} but adds an additional page reference,
like on the facing page or on page 27 whenever the corresponding
\texttt{\textbackslash{}label} is not on the same page.

\texttt{\textbackslash{}vpageref} is a variation of \texttt{\textbackslash{}pageref} with similar functionality.

\item[{\texttt{\textbackslash{}vrefrange}, \texttt{\textbackslash{}vpagerefrange} :}] \leavevmode 
The \texttt{\textbackslash{}v...range} commands take two labels as arguments and produce
strings which depend on wether or not these labels fall onto a single
page or on different pages.

\item[{\texttt{\textbackslash{}vref*}, \texttt{\textbackslash{}vpageref*}, \texttt{\textbackslash{}vpagerefrange*} :}] \leavevmode 
Star \texttt{*} variants do not add any space before the generated text for
situations like: \texttt{(\textbackslash{}vref\{foo\} ...)}

\end{description}

\end{document}