initial commit

docs/header.tex

@@ -0,0 +1,125 @@
+% header.tex
+% Professional header for mdBook (via Pandoc) PDF output.
+% Intended for use with pdflatex.
+%
+% This header provides:
+%  - Modern fonts and microtypography
+%  - Clean page geometry and headers/footers
+%  - Improved title formatting (with larger author text)
+%  - Professional table styling with alternating row colors and auto-scaling
+
+
+
+%% 1. Encoding, Fonts, and Microtypography
+\usepackage[utf8]{inputenc}   % Source encoding
+\usepackage[T1]{fontenc}      % Font encoding
+\usepackage{lmodern}          % Modern fonts
+\usepackage{microtype}        % Improves typography
+
+
+%% 1a. some additional stuff
+\usepackage{titleps}
+\usepackage{fancyhdr}
+\usepackage{awesomebox}
+\usepackage{minitoc}
+
+%% 2. Page Geometry
+\usepackage[a4paper,margin=1in]{geometry}
+
+%% 3. Graphics and Colors
+\usepackage{graphicx}         % For images
+\usepackage{xcolor}
+\definecolor{linkcolor}{RGB}{0, 0, 180}       % Deep blue for links
+\definecolor{tableShade}{RGB}{245,245,245}     % Light gray for table row shading
+\definecolor{lightGreen}{RGB}{240,255,240}     % Very light green
+\definecolor{mediumGreen}{RGB}{220,255,220}    % Darker green
+\usepackage{colortbl}
+%% 4. Hyperlinks
+\usepackage{hyperref}
+\hypersetup{
+  colorlinks   = true,
+  linkcolor    = linkcolor,
+  urlcolor     = linkcolor,
+  citecolor    = linkcolor,
+}
+
+%% 5. Title Formatting (using titling package)
+\usepackage{titling}
+
+\renewcommand{\maketitle}{%
+  \begin{titlepage}
+    \centering
+    %–––– push block to vertical centre ––––
+    \vspace*{\fill}
+
+    %–––– Title –––––
+    {\LARGE\bfseries\thetitle\par}
+    \vspace{1em}
+
+    %–––– Author –––––
+    {\large\theauthor\par}
+    \vspace{2em}
+
+    %–––– Date –––––
+    {\normalsize\itshape\thedate\par}
+    \vspace{2em}
+
+    %–––– Logo –––––
+    \includegraphics[width=0.35\textwidth]{logo.png}\par
+
+    %–––– balance to bottom –––––
+    \vspace*{\fill}
+  \end{titlepage}%
+}
+
+
+
+
+%% 6. Headers and Footers (fancyhdr)
+\usepackage{fancyhdr}
+\pagestyle{fancy}
+\fancyhf{}                     % Clear header/footer
+\lhead{\small \nouppercase{\leftmark}}
+\rhead{\small \thepage}
+\rhead{\includegraphics[width=1cm]{logo.png}}
+
+\renewcommand{\headrulewidth}{0.4pt}
+
+
+%% 8. Table Packages: booktabs, tabularx, longtable, and array
+%\usepackage{booktabs}         % Professional table rules
+%\usepackage{tabularx}         % Flexible-width tables
+%\usepackage{longtable}        % Tables spanning multiple pages
+%\usepackage{array}            % Enhanced array and tabular environments
+%\usepackage{colortbl}         % For colored table rows
+
+
+%% 9. Automatic Table Scaling and Alternating Row Colors
+\usepackage{adjustbox}        % For scaling tables to \textwidth
+\usepackage{etoolbox}         % For patching environments
+
+
+% For longtable, add alternating row colors (without adjustbox to avoid grouping conflicts).
+\AtBeginEnvironment{longtable}{\rowcolors{1}{mediumGreen}{lightGreen}}
+
+%% 10. Define Custom Column Types for tabularx (optional)
+% Use these column types in your Markdown (via Pandoc filters or manual LaTeX)
+% to enforce equal-width columns.
+\newcolumntype{Y}{>{\centering\arraybackslash}X} % centered
+\newcolumntype{L}{>{\raggedright\arraybackslash}X} % left-aligned
+\newcolumntype{R}{>{\raggedleft\arraybackslash}X}  % right-aligned
+
+
+%% 11. Use Helvetica sans-serif font
+\usepackage{helvet}              % Use Helvetica
+\renewcommand{\familydefault}{\sfdefault}  % Set the default to sans serif
+
+%% 12. highlighting code blocks
+\usepackage{listings}
+\lstset{
+  backgroundcolor=\color{yellow},
+  basicstyle=\ttfamily,
+  breaklines=true
+}
+
+