To add a reference to another part of your document, add the following new commands to the preamble of your document source:
\usepackage{nameref}
\usepackage[colorlinks=true]{hyperref}
\newcommand*{\tqfullref}[1]{\hyperref[{#1}]{“\ref*{#1} \nameref*{#1}”}}
\newcommand*{\tqfullvref}[1]{\hyperref[{#1}]{“\ref*{#1} \nameref*{#1}”} on page \pageref{#1}}
\newcommand*{\tqref}[1]{\hyperref[{#1}]{\ref*{#1}}}
\newcommand*{\tqvref}[1]{\hyperref[{#1}]{\ref*{#1}} on page \pageref{#1}}
These are for a document in English language, for another language you have to adjust the commands accordingly; for the German language, the will look like this:
\usepackage{nameref}
\usepackage[colorlinks=true]{hyperref}
\newcommand*{\tqfullref}[1]{\hyperref[{#1}]{„\ref*{#1} \nameref*{#1}”}}
\newcommand*{\tqfullvref}[1]{\hyperref[{#1}]{„\ref*{#1} \nameref*{#1}”} auf Seite \pageref{#1}}
\newcommand*{\tqref}[1]{\hyperref[{#1}]{\ref*{#1}}}
\newcommand*{\tqvref}[1]{\hyperref[{#1}]{\ref*{#1}} auf Seite \pageref{#1}}
Because the hyperlink package redefines several other LaTex commands, it should be loaded always as the last package.
The destination for the reference will be marked with the \label command, like this:
\section{<headline>}\label{sec:<label>}
…
See chapter \tqfullref{sec:<label>}
See chapter \tqfullvref{sec:<label>}
See chapter \tqref{sec:<label>}
See chapter \tqvref{sec:<label>}
\tqfullref adds a reference like “<number> <headline>”\tqfullvref adds a reference like “<number> <headline>” on page <page>\tqref adds a reference like <number>\tqvref adds a reference like <number> on page <page>Both, the number/headline and the page number will be generated as hyperlinks. So the resulting output would look like this:
1.2.3 <headline>
…
See chapter “1.2.3 <headline>”
See chapter “1.2.3 <headline>” on page 42
See chapter 1.2.3
See chapter 1.2.3 on page 42
The hyperlink package provides also the commands \url and \href that allow to integrate references to websites or an email address into the generated document. The code:
Send me an email: \href{mailto:thomas.thrien@tquadrat.org}{thomas.thrien@tquadrat.org}
Or see my GitHub page: \url{https://tquadrat.github.io/}
results in:
Send me an email: thomas.thrien@tquadrat.org
Or see my GitHub page: https://tquadrat.github.io/
To integrate ‘listings’ – source code of programs, scripts and alike – into a document, use the package listings. It allows syntax highlighting for several programming languages.
To integrate the package, put the line \usepackage{listings} to the preamble of your document.
The configuration of the package is done with the \lstset environment.
\lstset{
language=Java, % The programming language
backgroundcolor=\color[gray]{.9}, % The background color
basicstyle=\ttfamily\footnotesize\bfseries,
% The basic style
commentstyle=\color[gray]{.2}\bfseries,
% The style for the comments if different
% from the basic style
identifierstyle=, % The style for identifiers
stringstsyle=, % The style for String constants
keywordstyle=\color[gray]{.2}, % The style for the keywords of the selected
% programming language if different from the
% basic style
showstringspaces=true, % A special character is displayed for the
% blanks in a String
frame=single, % The listing should be surrounded by a frame
framerule=0.2pt, % The width of that frame
xleftmargin=.2cm, % additional indentation for the source code
xrightmargin=.2cm, % right margin
breaklines=true, % source code lines can be broken at the
% margin
breakatwhitespace=true, % lines are broken at whitespace
inputencoding=utf8, % the input encoding
extendedchars=true, % allows non-ASCII characters
literate= % the mapping of extended characters to
% TeX/LaTeX constructs; required for nearly
% all non-ASCII character in the source code
{á}1 {Á}1 {à}1 {À}1 {ä}1 {Ä}1
{â}1 {Â}1 {ã}1 {Ã}1 {æ}1 {Æ}1
{å}1 {Å}1
{ç}1 {Ç}1
{é}1 {É}1 {è}1 {È}1 {ë}1 {Ë}1
{ê}1 {Ê}1 {ẽ}1 {Ẽ}1
{í}1 {Í}1 {ì}1 {Ì}1 {ï}1 {Ï}1
{î}1 {Î}1 {ĩ}1 {Ĩ}1
{ñ}1 {Ñ}1
{ó}1 {Ó}1 {ò}1 {Ò}1 {ö}1 {Ö}1
{ô}1 {Ô}1 {õ}1 {Õ}1 {œ}1 {Œ}1
{ø}1 {ő}}1 {Ő}}1
{ß}1
{ú}1 {Ú}1 {ù}1 {Ù}1 {ü}1 {Ü}1
{û}1 {Û}1 {ũ}1 {Ũ}1 {ű}}1 {Ű}}1
{€}1 {£}1
{«}1 {»}1
{¿}1 {¡}1
{©}1
{…}1
}
The format for the literate= entries is {<source character>}<effectice length of the replacement sequence>. To print the copyright symbol in the listing, the literate sequence would be {©}1.
The list above is not exhaustive, it just contains those characters that I have used within a source code file at some time in the past.
The package is used basically in two ways:
\begin{lstlisting} … \end{lstlisting}\lstinline|…|The environment allows to overwrite some of the settings provide with \lstset: \begin{lstlisting}[language=python, numbers=left] … \end{lstlisting}.
\lstinline|…| works similar to \verb: the vertical bars are just the delimiters for the value; any character that is not part of the value can be used for that.