unaltraweb 0.3.0

data/scripts/manual/templates/manual.tex

@@ -0,0 +1,494 @@
+\documentclass[11pt,a4paper,twoside,openright]{book}
+
+\usepackage{amsmath,amssymb}
+\usepackage{booktabs}
+\usepackage{cancel}
+\usepackage{emptypage}
+\usepackage{enumitem}
+\usepackage{etoolbox}
+\usepackage{fontspec}
+\usepackage{float}
+\usepackage{framed}
+\usepackage{graphicx}
+\usepackage{grffile}
+\usepackage{longtable}
+\usepackage{array}
+\usepackage{calc}
+\usepackage{geometry}
+\usepackage{microtype}
+\usepackage{needspace}
+\usepackage{ragged2e}
+\usepackage{setspace}
+\usepackage{subcaption}
+\usepackage{tikz}
+\usepackage{titlesec}
+\usepackage{listings}
+\usepackage{lstlinebgrd}
+\usepackage[most]{tcolorbox}
+\usepackage{xcolor}
+\usepackage{xurl}
+\usepackage{hyperref}
+\usepackage{bookmark}
+\usepackage[$babel-lang$]{babel}
+
+\geometry{inner=25mm,outer=22mm,top=24mm,bottom=26mm}
+\setmainfont{DejaVu Serif}
+\setsansfont{DejaVu Sans}
+\setmonofont{DejaVu Sans Mono}[Scale=MatchLowercase]
+\setstretch{1.08}
+\setlength{\parindent}{0pt}
+\setlength{\parskip}{0.5em}
+\raggedbottom
+\clubpenalty=10000
+\widowpenalty=10000
+\displaywidowpenalty=10000
+\setcounter{secnumdepth}{3}
+\setcounter{tocdepth}{2}
+\pretocmd{\section}{\Needspace{6\baselineskip}}{}{}
+\pretocmd{\subsection}{\Needspace{5\baselineskip}}{}{}
+\pretocmd{\subsubsection}{\Needspace{5\baselineskip}}{}{}
+\pretocmd{\paragraph}{\Needspace{4\baselineskip}}{}{}
+\setlist[description]{style=nextline,leftmargin=1.5em,labelindent=0pt,itemsep=0.65em,topsep=0.65em,font=\normalfont\bfseries}
+\renewcommand*{\descriptionlabel}[1]{\hspace\labelsep\normalfont\bfseries #1:}
+\setlength{\LTpre}{0.6em}
+\setlength{\LTpost}{0.8em}
+
+\definecolor{ManualPrimary}{HTML}{$primary-color$}
+\definecolor{ManualBand}{HTML}{$band-color$}
+\definecolor{ManualSecondary}{HTML}{$secondary-color$}
+\definecolor{ManualMuted}{HTML}{$muted-color$}
+\definecolor{ManualInternalLink}{HTML}{$internal-link-color$}
+\definecolor{ManualExternalLink}{HTML}{$external-link-color$}
+\definecolor{ManualCitationLink}{HTML}{$citation-link-color$}
+\definecolor{ManualInlineCode}{HTML}{$inline-code-color$}
+\colorlet{ManualCodeBackground}{ManualMuted!5!white}
+\colorlet{ManualCodeStripe}{ManualSecondary!4!white}
+\colorlet{ManualCodeBorder}{ManualSecondary!38!white}
+\colorlet{ManualCodeText}{ManualSecondary!82!black}
+\definecolor{ManualCodeKeyword}{HTML}{003F73}
+\definecolor{ManualCodeComment}{HTML}{39705A}
+\definecolor{ManualCodeString}{HTML}{9A3D45}
+\definecolor{ManualCodeNumber}{HTML}{687789}
+\DeclareCaptionFont{manualcaption}{\sffamily\fontsize{9.4}{11.2}\selectfont}
+\DeclareCaptionFont{manualsubcaption}{\sffamily\fontsize{8.8}{10.5}\selectfont}
+\DeclareCaptionLabelFormat{manual}{\textcolor{ManualSecondary}{#1\nobreakspace #2}}
+\captionsetup{
+  font={manualcaption,color=ManualMuted},
+  labelfont={bf,sf},
+  labelformat=manual,
+  format=hang,
+  justification=RaggedRight,
+  singlelinecheck=false
+}
+\captionsetup[figure]{position=top,margin=1em,aboveskip=0pt,belowskip=7pt}
+\captionsetup[table]{position=top,margin=1em,aboveskip=0pt,belowskip=7pt}
+\captionsetup[lstlisting]{position=top,margin=0pt,aboveskip=0pt,belowskip=7pt}
+\captionsetup[subfigure]{
+  font={manualsubcaption,color=ManualMuted},
+  labelfont={bf,sf,color=ManualSecondary},
+  margin=0pt,
+  skip=5pt
+}
+\titleformat{\chapter}[hang]
+  {\normalfont\sffamily\LARGE\bfseries\color{ManualSecondary}}
+  {\thechapter.}{0.55em}{}
+\titlespacing*{\chapter}{0pt}{36pt}{30pt}
+\titleformat{\section}
+  {\normalfont\Large\bfseries\color{ManualSecondary}}
+  {\thesection}{0.75em}{}
+\titleformat{\subsection}
+  {\normalfont\large\bfseries\color{ManualSecondary}}
+  {\thesubsection}{0.75em}{}
+\titleformat{\subsubsection}
+  {\normalfont\normalsize\bfseries\color{ManualSecondary}}
+  {\thesubsubsection}{0.75em}{}
+\titleformat{\paragraph}[runin]
+  {\normalfont\normalsize\bfseries\color{ManualSecondary}}
+  {\theparagraph}{0.75em}{}
+\titleformat{\subparagraph}[runin]
+  {\normalfont\normalsize\bfseries\color{ManualSecondary}}
+  {\thesubparagraph}{0.75em}{}
+\definecolor{ManualCalloutInfo}{HTML}{2A5FB8}
+\definecolor{ManualCalloutExample}{HTML}{13795B}
+\definecolor{ManualCalloutWarning}{HTML}{A65D03}
+\definecolor{ManualCalloutObjectives}{HTML}{2F6FD6}
+\definecolor{ManualCalloutDanger}{HTML}{A12929}
+
+\newcommand{\ManualCodeLineBackground}{%
+  \ifodd\value{lstnumber}\color{ManualCodeBackground}\else\color{ManualCodeStripe}\fi
+}
+\lstdefinelanguage{ManualURL}{
+  sensitive=true,
+  morecomment=[l]{\#},
+  morekeywords={http,https,SERVICE,REQUEST,VERSION,LAYERS,FORMAT,CRS,SRS,BBOX,WIDTH,HEIGHT},
+  morestring=[b]"
+}
+\lstdefinelanguage{ManualSpreadsheet}{
+  sensitive=false,
+  morekeywords={AND,AVERAGE,COUNTIF,DATEDIF,DATE,DAY,HEX2DEC,HLOOKUP,IF,ISBLANK,ISNUMBER,ISTEXT,LEFT,MID,MONTH,NA,NETWORKDAYS,ROUND,SI,SUM,SUMA,SUMIFS,TODAY,TRIM,VLOOKUP,WEEKDAY,XLOOKUP,YEAR},
+  morestring=[b]"
+}
+\lstdefinelanguage{ManualFileTree}{
+  sensitive=true,
+  morecomment=[l]{\#},
+  alsoletter={_-},
+  morekeywords={data,figures,maps,outputs,processed,qgis,raw,scripts,src},
+  emph={csv,geojson,gpkg,jpeg,jpg,pdf,png,qgz,svg,tif,tiff,xlsx},
+  emphstyle=\color{ManualCodeString}
+}
+\lstdefinestyle{manualbase}{
+  basicstyle=\ttfamily\small\color{ManualCodeText},
+  keywordstyle=\bfseries\color{ManualCodeKeyword},
+  commentstyle=\itshape\color{ManualCodeComment},
+  stringstyle=\color{ManualCodeString},
+  numberstyle=\scriptsize\ttfamily\color{ManualCodeNumber},
+  numbers=none,
+  frame=none,
+  xleftmargin=0pt,
+  framexleftmargin=0pt,
+  columns=fullflexible,
+  keepspaces=true,
+  showspaces=false,
+  showstringspaces=false,
+  showtabs=false,
+  tabsize=4,
+  upquote=true,
+  breaklines=true,
+  breakatwhitespace=false,
+  breakautoindent=true,
+  breakindent=0.75em,
+  prebreak={},
+  postbreak={},
+  linebackgroundcolor=\ManualCodeLineBackground,
+  linebackgroundsep=0pt,
+  linebackgroundwidth=\linewidth,
+  aboveskip=0pt,
+  belowskip=0pt,
+  literate=
+    {à}{{\`a}}1 {á}{{\'a}}1 {è}{{\`e}}1 {é}{{\'e}}1
+    {í}{{\'i}}1 {ï}{{\"i}}1 {ò}{{\`o}}1 {ó}{{\'o}}1
+    {ú}{{\'u}}1 {ü}{{\"u}}1 {ç}{{\c{c}}}1
+    {À}{{\`A}}1 {Á}{{\'A}}1 {È}{{\`E}}1 {É}{{\'E}}1
+    {Í}{{\'I}}1 {Ï}{{\"I}}1 {Ò}{{\`O}}1 {Ó}{{\'O}}1
+    {Ú}{{\'U}}1 {Ü}{{\"U}}1 {Ç}{{\c{C}}}1
+    {·}{{\textperiodcentered}}1 {«}{{\guillemotleft}}1 {»}{{\guillemotright}}1
+}
+\lstdefinestyle{manualcode}{
+  style=manualbase,
+  numbers=left,
+  numbersep=7pt,
+  xleftmargin=2.35em
+}
+\lstdefinestyle{manualverbatim}{
+  style=manualbase,
+  numbers=none,
+  xleftmargin=0pt
+}
+\newtcblisting{manualcode}[2][]{
+  enhanced,
+  breakable,
+  listing only,
+  listing engine=listings,
+  listing options={style=manualcode,#1},
+  colback=ManualCodeBackground,
+  colframe=ManualCodeBorder,
+  colbacktitle=ManualSecondary!8!white,
+  coltitle=ManualSecondary,
+  fonttitle=\sffamily\bfseries\footnotesize,
+  title={\strut #2},
+  boxrule=0.55pt,
+  titlerule=0pt,
+  arc=0.8mm,
+  outer arc=0.8mm,
+  left=2pt,
+  right=4pt,
+  top=6pt,
+  bottom=6pt,
+  lefttitle=9pt,
+  righttitle=9pt,
+  toptitle=5pt,
+  bottomtitle=5pt,
+  before skip=1em,
+  after skip=1.1em
+}
+\newenvironment{manualcodelisting}[1]{%
+  \Needspace{6\baselineskip}%
+  \captionof{lstlisting}{#1}%
+  \vspace{-0.45em}%
+}{}
+\newtcblisting{manualverbatim}{
+  enhanced,
+  breakable,
+  listing only,
+  listing engine=listings,
+  listing options={style=manualverbatim},
+  colback=ManualCodeBackground,
+  colframe=ManualCodeBorder,
+  boxrule=0.55pt,
+  arc=0.8mm,
+  outer arc=0.8mm,
+  left=5pt,
+  right=5pt,
+  top=6pt,
+  bottom=6pt,
+  before skip=1em,
+  after skip=1.1em
+}
+
+\let\ManualOriginalTexttt\texttt
+\renewcommand{\texttt}[1]{{\color{ManualInlineCode}\ManualOriginalTexttt{#1}}}
+
+\newenvironment{manualcallout}[3][enhanced]{%
+  \begin{tcolorbox}[
+    #1,
+    colback=#2!6!white,
+    colframe=#2,
+    boxrule=0.55pt,
+    leftrule=2.6pt,
+    arc=1.2pt,
+    left=8pt,
+    right=8pt,
+    top=7pt,
+    bottom=7pt,
+    before skip=0.8em,
+    after skip=0.8em
+  ]%
+  {\bfseries\sffamily\color{#2}#3}\par\smallskip
+}{%
+  \end{tcolorbox}
+}
+
+\hypersetup{
+  colorlinks=true,
+  linkcolor=ManualInternalLink,
+  urlcolor=ManualExternalLink,
+  citecolor=ManualCitationLink,
+  pdftitle={$title$},
+  pdfauthor={$author$}
+}
+
+\providecommand{\tightlist}{%
+  \setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
+\providecommand{\pandocbounded}[1]{#1}
+\providecommand{\cm}{\,\mathrm{cm}}
+\providecommand{\mm}{\,\mathrm{mm}}
+\providecommand{\m}{\,\mathrm{m}}
+\providecommand{\km}{\,\mathrm{km}}
+\providecommand{\cms}{\,\mathrm{cm^2}}
+\providecommand{\squarekilometre}{\,\mathrm{km^2}}
+\providecommand{\hectare}{\,\mathrm{ha}}
+\providecommand{\ha}{\,\mathrm{ha}}
+\newcommand{\passthrough}[1]{#1}
+\newlength{\cslhangindent}
+\setlength{\cslhangindent}{1.5em}
+\newlength{\csllabelwidth}
+\setlength{\csllabelwidth}{3em}
+\NewDocumentCommand\citeproctext{}{}
+\NewDocumentCommand\citeproc{mm}{\begingroup\def\citeproctext{#2}\cite{#1}\endgroup}
+\makeatletter
+\let\@cite@ofmt\@firstofone
+\def\@biblabel#1{}
+\def\@cite#1#2{{#1\if@tempswa , #2\fi}}
+\makeatother
+\newenvironment{CSLReferences}[2]
+  {\begin{list}{}{%
+    \setlength{\itemindent}{0pt}
+    \setlength{\leftmargin}{0pt}
+    \setlength{\parsep}{0pt}
+    \ifodd #1
+      \setlength{\leftmargin}{\cslhangindent}
+      \setlength{\itemindent}{-1\cslhangindent}
+    \fi
+    \setlength{\itemsep}{#2\baselineskip}}}
+  {\end{list}}
+\newcommand{\CSLBlock}[1]{\hfill\break\parbox[t]{\linewidth}{\strut\ignorespaces#1\strut}}
+\newcommand{\CSLLeftMargin}[1]{\parbox[t]{\csllabelwidth}{\strut#1\strut}}
+\newcommand{\CSLRightInline}[1]{\parbox[t]{\linewidth - \csllabelwidth}{\strut#1\strut}}
+\newcommand{\CSLIndent}[1]{\hspace{\cslhangindent}#1}
+
+\makeatletter
+\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth\else\Gin@nat@width\fi}
+\def\maxheight{\ifdim\Gin@nat@height>0.82\textheight 0.82\textheight\else\Gin@nat@height\fi}
+\makeatother
+\setkeys{Gin}{width=\maxwidth,height=\maxheight,keepaspectratio}
+\floatplacement{figure}{H}
+\renewcommand{\lstlistingname}{$listing-label$}
+\renewcommand{\lstlistlistingname}{$list-of-listings-title$}
+\renewcommand{\listfigurename}{$list-of-figures-title$}
+\renewcommand{\listtablename}{$list-of-tables-title$}
+
+\usepackage{fancyhdr}
+\pagestyle{fancy}
+\fancyhf{}
+\fancyhead[LE,RO]{\small\sffamily\color{ManualMuted}{$short-title$}}
+\fancyhead[RE,LO]{\small\sffamily\color{ManualMuted}\leftmark}
+\fancyfoot[LE,RO]{\small\sffamily\thepage}
+\renewcommand{\headrulewidth}{0.2pt}
+\renewcommand{\footrulewidth}{0pt}
+
+\fancypagestyle{plain}{%
+  \fancyhf{}%
+  \fancyfoot[LE,RO]{\small\sffamily\thepage}%
+  \renewcommand{\headrulewidth}{0pt}%
+  \renewcommand{\footrulewidth}{0pt}%
+}
+
+\begin{document}
+\special{pdf:trailerid [<$trailer-id$><$trailer-id$>]}
+\frontmatter
+
+\begin{titlepage}
+\thispagestyle{empty}
+\begin{tikzpicture}[remember picture,overlay]
+  \fill[ManualBand] (current page.north west) rectangle ([yshift=-2cm]current page.north east);
+  \fill[ManualBand] (current page.south west) rectangle ([yshift=2cm]current page.south east);
+
+  \node[anchor=north,inner sep=0pt,text=white,yshift=-0.46cm] at (current page.north) {
+    $if(series-logo)$\raisebox{-0.23cm}{\includegraphics[height=1.05cm]{$series-logo$}}\hspace{0.42cm}$endif$
+    {\large\bfseries\sffamily ``\textit{$series$}''}$if(series-subtitle)$\enspace·\enspace{\normalsize\bfseries\sffamily $series-subtitle$}$endif$
+  };
+
+  \node[text width=0.9\textwidth,align=center,anchor=north,font=\fontsize{23}{28}\selectfont\bfseries\sffamily,text=ManualSecondary,yshift=-3.6cm]
+    at (current page.north) {$title$};
+
+$if(cover-image)$
+  \node[anchor=north,inner sep=0pt,yshift=-7.8cm] at (current page.north) {
+    \includegraphics[width=\paperwidth]{$cover-image$}
+  };
+$else$
+  \fill[ManualSecondary!10] ([yshift=-7cm]current page.north west) rectangle ([yshift=-18cm]current page.north east);
+$endif$
+
+  \node[text width=0.92\textwidth,align=center,anchor=north,font=\normalsize\sffamily,text=ManualMuted,yshift=-22.12cm]
+    at (current page.north) {$for(instructors)$$instructors$$sep$ · $endfor$};
+
+$if(cover-logo)$
+  \node[anchor=center,yshift=4.7cm] at (current page.south) {
+    \includegraphics[height=2.1cm]{$cover-logo$}
+  };
+$endif$
+
+  \node[anchor=center,font=\small\sffamily,text=white] at ([yshift=1cm]current page.south) {$rights$};
+\end{tikzpicture}
+\end{titlepage}
+
+\thispagestyle{empty}
+\vspace*{0.7cm}
+{\LARGE\bfseries\sffamily\color{ManualSecondary}$metadata-page-title$}\par
+\vspace{0.35cm}
+{\large\bfseries\sffamily $title$}\par
+$if(description)$
+\vspace{0.2cm}
+{\small\color{ManualMuted}$description$}\par
+$endif$
+\vspace{0.55cm}
+\small
+\begin{description}[style=multiline,leftmargin=4.95cm,labelwidth=4.5cm,labelsep=0.45cm,itemsep=0.34em,parsep=0pt,topsep=0pt,font=\normalfont\bfseries\sffamily\color{ManualSecondary}]
+$if(series)$
+  \item[$metadata-series-label$] $series$$if(series-subtitle)$ · $series-subtitle$$endif$
+$endif$
+$if(edition)$
+  \item[$metadata-edition-label$] $edition$
+$endif$
+$if(publication-date)$
+  \item[$metadata-publication-date-label$] $publication-date$
+$endif$
+$if(release-channel)$
+  \item[$metadata-release-channel-label$] $release-channel$
+$endif$
+$if(release-selector)$
+  \item[$metadata-release-version-label$] $release-selector$
+$endif$
+$if(publisher)$
+  \item[$metadata-publisher-label$] $publisher$
+$endif$
+$if(instructors)$
+  \item[$metadata-instructors-label$] $for(instructors)$$instructors$$sep$, $endfor$
+$endif$
+$if(institution)$
+  \item[$metadata-institution-label$] $institution$
+$endif$
+$if(department)$
+  \item[$metadata-department-label$] $department$
+$endif$
+$if(faculty)$
+  \item[$metadata-faculty-label$] $faculty$
+$endif$
+$if(location)$
+  \item[$metadata-location-label$] $location$
+$endif$
+$if(subject)$
+  \item[$metadata-subject-label$] $subject$
+$endif$
+$if(teaching-guides)$
+  \item[$metadata-teaching-guides-label$]
+  $for(teaching-guides)$$teaching-guides.degree$$if(teaching-guides.subject-code)$ · \texttt{$teaching-guides.subject-code$}$endif$\par
+  $endfor$
+$endif$
+$if(academic-year)$
+  \item[$metadata-academic-year-label$] $academic-year$
+$endif$
+$if(revision-date)$
+  \item[$metadata-revision-date-label$] $revision-date$
+$endif$
+$if(identifier)$
+  \item[$metadata-identifier-label$] $identifier$
+$endif$
+$if(source)$
+  \item[$metadata-source-label$] $source$
+$endif$
+$if(license)$
+  \item[$metadata-license-label$] $license$
+$endif$
+$if(rights)$
+  \item[$metadata-rights-label$] $rights$
+$endif$
+\end{description}
+\clearpage
+
+$if(draft)$
+\thispagestyle{empty}
+\vspace*{0.3\textheight}
+\begin{center}
+  {\Huge\bfseries\sffamily\color{ManualPrimary}$draft-label$}\par
+  \vspace{1em}
+  {\large\sffamily $draft-description$}
+\end{center}
+\clearpage
+$endif$
+
+$if(toc)$
+\tableofcontents
+\label{manual:toc-end}
+\clearpage
+$endif$
+
+$if(has-figures)$
+\listoffigures
+\clearpage
+$endif$
+
+$if(has-tables)$
+\listoftables
+\clearpage
+$endif$
+
+$if(has-listings)$
+\lstlistoflistings
+\clearpage
+$endif$
+
+\mainmatter
+$if(include-home)$
+\setcounter{chapter}{-1}
+$endif$
+\makeatletter
+\let\ManualOriginalStarredChapter\@schapter
+\renewcommand{\@schapter}[1]{%
+  \markboth{\MakeUppercase{#1}}{}%
+  \ManualOriginalStarredChapter{#1}%
+}
+\makeatother
+$body$
+
+\end{document}