Cleaned up the preamble finally

005/codex-005.tex

@@ -1,5 +1,7 @@
 \documentclass[twoside]{report}
 
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Packages %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
 \usepackage{amsmath}
@@ -14,11 +16,32 @@
 \usepackage{gensymb} % Just for the degree symbol
 \usepackage{ccicons} % Creative Commons icons; now we can delete an image
 \usepackage{lettrine} % Drop caps
+\usepackage{wrapfig} % Let's wrap some images
+\usepackage{hanging} % For hanging indents in a script
+\usepackage{fancyvrb} % Use line numbers with code samples
+\usepackage{fvextra} % Break lines inside Verbatim environment:
+\usepackage{enumitem} % Control spacing in lists
+\usepackage{setspace} % Better control over line-spacing
+\usepackage{nicefrac} % Use nice fractions
+\usepackage[bottom]{footmisc} % Keep the footnotes at the bottom of the page
+\usepackage{tabto} % Use tab stops when we need to (especially in footnotes)
+\usepackage{microtype} % Make things neater. Thanks /u/-LeopardShark-
+\usepackage{tabularray} % Easy tables
 
-% Where are our images?
-\graphicspath{{images/}}
 
-% Let's set this as a half-letter sized sheet
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Commands %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\graphicspath{{images/}} % Where are our images?
+\usepackage{multicol} % Include two- or three-column sections
+\counterwithout{footnote}{chapter} % Stop resetting the footnote count after each chapter
+\NumTabs{18} % Define 18 tab stops (at 1/4" intervals) [tabto package]
+\raggedbottom  % Don't force text to fill page
+\setlength{\belowcaptionskip}{4pt} % Adjust space between caption and figure
+\renewcommand*\contentsname{In This Issue…} % Change the name of the TOC
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Document Setup%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \usepackage{geometry}
 \geometry{
 	paperheight=8.5in,
@@ -27,11 +50,12 @@
 	margin=0.5in
 }
 
-% Adjust the top and bottom margins
-\addtolength{\topmargin}{0.4in}
-\addtolength{\textheight}{-0.75in}
+\addtolength{\topmargin}{0.4in} % Adjust and bottom margin
+\addtolength{\textheight}{-0.75in} % Adjust the bottom margin
 
-% Set the header style
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Page Headers%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \usepackage{fancyhdr}
 \pagestyle{fancy}
  \fancyhf{}
@@ -40,21 +64,10 @@
  \cfoot{Page \thepage}
 \renewcommand{\footrulewidth}{0.5pt}
 
-% Include two- or three-column sections
-\usepackage{multicol}
 
-% Stop resetting the footnote count after each chapter
-\counterwithout{footnote}{chapter}
-
-% Let's wrap some images
-\usepackage{wrapfig}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-% Adjust spacing before chapter titles
-% See https://tex.stackexchange.com/a/488653/245702
-% and https://tex.stackexchange.com/a/40001/245702
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Chapter Title Spacing %%%%%%%%%%%%%%%%%%%%
 \usepackage{titlesec}
-
 \titleformat{\chapter}[display]
     {\normalfont\huge\bfseries}
     {\chaptertitlename\ \thechapter}
@@ -62,16 +75,9 @@
     {\Huge}
 \titlespacing*{\chapter}{0pt}{0pt}{40pt}
 
-% Use tab stops when we need to (especially in footnotes)
-\usepackage{tabto}
-% Define 18 tab stops (at 1/4" intervals)
-\NumTabs{18}
 
-% Make things neater. Thanks /u/-LeopardShark-
-\usepackage{microtype}
-
-% Easy tables
-\usepackage{tabularray}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Custom Macros %%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 % Make a nice border and box for the tops of our examples
 \newcommand\klab[3]{\vspace{#1}\noindent{}\hrulefill\fbox{\texttt{~#2~}}\hrulefill\vspace{#3}}
@@ -103,45 +109,20 @@
 	\medskip
 }
 
-% Delete later
-\usepackage{lipsum}
 
-% For hanging indents in a script
-\usepackage{hanging}
-
-% Use line numbers with code samples
-% \begin{Verbatim}...\end{Verbatim} <-- Note the capitalization!
-\usepackage{fancyvrb}
-% Break lines inside this environment:
-\usepackage{fvextra}
-
-% Control spacing in lists
-\usepackage{enumitem}
-
-% Don't force text to fill page
-\raggedbottom
-
-% Better control over line-spacing
-\usepackage{setspace}
-
-% Use nice fractions
-\usepackage{nicefrac}
-
-% Keep the footnotes at the bottom of the page
-\usepackage[bottom]{footmisc}
-
-% Do we want to include URLs?
-% Yes, but we also want to hide the big red box it puts around them in the pdf. Thanks /u/0b0101011001001011
-\usepackage[hidelinks]{hyperref}
-
-% Adjust space between caption and figure
-% https://tex.stackexchange.com/questions/45990/how-can-i-modify-vertical-space-between-figure-and-caption
-\setlength{\belowcaptionskip}{4pt}
-
-% Just for issue #005 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Just for Issue #005 %%%%%%%%%%%%%%%%%%%%%%
 
 
-%%%% Document Information %%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Include URLS %%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Be sure to load this package last
+% [hidelinks option to hide big red box. Thanks /u/0b0101011001001011
+\usepackage[hidelinks]{hyperref} % Inlcude URLs, but load this package last
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Document Information %%%%%%%%%%%%%%%%%%%%%
 \author{Kenneth John Odle}
 \title{
  {\Huge the codex} \\
@@ -152,8 +133,9 @@
 }
 \date{\begin{small}\today{}\end{small}}
 
-% Change the name of the TOC
-\renewcommand*\contentsname{In This Issue…}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Let's get it started %%%%%%%%%%%%%%%%%%%%%
 
 \begin{document}
 \maketitle