% \LaTeX-Main\
% !TeX encoding=UTF-8
% !TeX spellcheck=en_US
%%
%% The LaTeX package mercatormap - version 1.3.0 (2026/02/19)
%% mercatormap.tex: Manual
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2020-2026 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
%% -------------------------------------------------------------------------------------------
%%
%% This work may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either version 1.3
%% of this license or (at your option) any later version.
%% The latest version of this license is in
%%   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 `author-maintained'.
%%
%% This work consists of all files listed in README
%%
% arara: pdflatex: { shell: yes }
% arara: biber
% arara: pdflatex: { shell: yes }
% arara: pdflatex: { shell: yes }
% arara: pdflatex: { shell: yes, synctex: yes }
\documentclass[a4paper,11pt]{ltxdoc}
\usepackage{mercatormap.doc}

% The following personal API-keys are needed for compilation
% \mrcsetapikey{thunderforest}{YOUR-API-KEY}     % registered key

\def\version{1.3.0}%
\def\datum{2026/02/19}%

\mrcactivatescript% activates Python script

\addbibresource{mercatormap.bib}

\hypersetup{
  pdftitle={Manual for the mercatormap package},
  pdfauthor={Thomas F. Sturm},
  pdfsubject={Map drawing based on pixel map tiles with mercator projection},
  pdfkeywords={map tiles, mercator projection, map drawing}
}

\makeindex

\usetikzlibrary{external}
\tikzsetexternalprefix{_figures/}
\tikzexternalize
\tikzexternaldisable% for final version
\tcbset{shield externalize}

\nocite{Sturm:2020,package:tikz,package:siunitx}

\ExplSyntaxOn
\cs_if_exist:NT \pdfsuppresswarningpagegroup
  {
    \pdfsuppresswarningpagegroup=1
  }
\ExplSyntaxOff

%\includeonly{mercatormap.doc.intro}
%\includeonly{mercatormap.doc.examples}
%\includeonly{mercatormap.doc.definition}
%\includeonly{mercatormap.doc.maptiles}
%\includeonly{mercatormap.doc.drawing}
%\includeonly{mercatormap.doc.scales}
%\includeonly{mercatormap.doc.marker}
%\includeonly{mercatormap.doc.routes}
%\includeonly{mercatormap.doc.orthodromes}
%\includeonly{mercatormap.doc.animations}
%\includeonly{mercatormap.doc.limitations}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{document}

\input{mercatormap.doc.abstract.tex}
\include{mercatormap.doc.intro}
\include{mercatormap.doc.examples}
\include{mercatormap.doc.definition}
\include{mercatormap.doc.maptiles}
\include{mercatormap.doc.drawing}
\include{mercatormap.doc.scales}
\include{mercatormap.doc.marker}
\include{mercatormap.doc.routes}
\include{mercatormap.doc.orthodromes}
\include{mercatormap.doc.animations}
\include{mercatormap.doc.limitations}

\clearpage
\phantomsection
\printbibliography[heading=bibintoc]

\clearpage
\phantomsection
\printindex

\end{document}
