docs: add the TUGboat article draft for Moloch

.gitignore

@@ -472,3 +472,5 @@ devenv.local.yaml
 
 # pre-commit
 .pre-commit-config.yaml
+=======
+*.minted

.latexindent.yaml

@@ -0,0 +1,34 @@
+verbatimEnvironments:
+  verbatim: 1
+  lstlisting: 1
+  minted: 1
+  Code: 1
+  CodeInput: 1
+  CodeOutput: 1
+modifyLineBreaks:
+  textWrapOptions:
+    columns: 80
+    blocksBeginWith:
+      other: |-
+        (?x)
+          \\titleref
+          |
+          \\texttt
+          |
+          \\LaTeX
+          |
+          \\PDF
+          |
+          \\HTML
+    blocksFollow:
+      other: |-
+        (?x)
+          \\\]
+          |
+          \\item(?:\h|\[)
+          |
+          \\begin\{abstract\}
+          |
+          \\end\{abstract\}
+          |
+          \\caption\{

Taskfile.yml

@@ -86,3 +86,57 @@ tasks:
           basename="${basename%.pdf}"
           ./scripts/pdf-to-grid.sh "$pdf" "docs/images/example-${basename}.png" 2 150
         done
+
+  tugboat-submission:
+    desc: Generate TUGboat article submission package
+    dir: papers
+    cmds:
+      # Clean any previous build artifacts first
+      - |
+        echo "Cleaning previous build artifacts..."
+        latexmk -C moloch-tugboat.tex
+        cd images && latexmk -C && cd ..
+        rm -f moloch-tugboat.aux moloch-tugboat.bbl moloch-tugboat.blg
+
+      # Compile image .tex files to PDFs
+      - |
+        echo "Compiling image files..."
+        cd images
+        for tex_file in *.tex; do
+          if [ -f "$tex_file" ]; then
+            echo "  Processing $tex_file..."
+            latexmk -pdf -interaction=nonstopmode "$tex_file"
+          fi
+        done
+        cd ..
+
+      # Compile the main tugboat article (multiple passes for references)
+      - |
+        echo "Compiling moloch-tugboat.tex..."
+        latexmk -pdf -interaction=nonstopmode moloch-tugboat.tex
+
+      # Create build directory and submission tar
+      - |
+        echo "Creating submission package..."
+        mkdir -p ../build/moloch-tugboat
+
+        # Copy source files
+        cp moloch-tugboat.tex ../build/moloch-tugboat/
+        cp bibliography.bib ../build/moloch-tugboat/
+        cp moloch-tugboat.pdf ../build/moloch-tugboat/
+
+        # Copy images (PDFs only, not .tex sources)
+        mkdir -p ../build/moloch-tugboat/images
+        cp images/*.pdf ../build/moloch-tugboat/images/
+
+        # Create tar archive
+        cd ../build
+        tar czf moloch-tugboat.tar.gz moloch-tugboat/*
+        cd ..
+
+        echo "Submission package created: build/moloch-tugboat.tar.gz"
+
+      # Clean auxiliary files
+      - |
+        latexmk -c moloch-tugboat.tex
+        cd images && latexmk -c && cd ..

papers/.gitignore

@@ -0,0 +1 @@
+tugboat.pdf

papers/bibliography.bib

@@ -0,0 +1,146 @@
+@ctan{samcarter:2025,
+  title         = {The \texttt{beamer} package},
+  author        = {{samcarter} and Wright, Joseph and Mileti\'{c}, Vedran and Stuart, Louis and Tantau, Till},
+  url           = {https://ctan.org/pkg/beamer},
+  subtitle      = {A LaTeX class for producing presentations and slides},
+  date          = {2025-08-13},
+  version       = {3.76}
+}
+
+@ctan{vogelgesang:2017,
+  title         = {The \texttt{beamertheme-metropolis} package},
+  author        = {Vogelgesang, Matthias},
+  url           = {https://ctan.org/pkg/beamertheme-metropolis},
+  subtitle      = {A modern LaTeX beamer theme},
+  date          = {2017-01-23},
+  version       = {1.2}
+}
+
+@ctan{tantau:2007,
+  title         = {The \texttt{pgfkeys} package},
+  author        = {Tantau, Till},
+  url           = {https://ctan.org/pkg/pgfkeys},
+  subtitle      = {Key value control for PGF},
+  date          = {2007-10-08},
+  version       = {2007-10-08}
+}
+
+@ctan{feuersanger:2025,
+  title         = {The \texttt{pgf} package},
+  author        = {Feuers\"{a}nger, Christian and Menke, Henri and {The PGF/TikZ Team} and Tantau, Till},
+  url           = {https://ctan.org/pkg/pgf},
+  subtitle      = {Create PostScript and PDF graphics in TeX},
+  date          = {2025-08-29},
+  version       = {3.1.11a}
+}
+
+@ctan{mittelbach:2025,
+  title         = {The \texttt{docstrip} package},
+  author        = {Mittelbach, Frank and {The LaTeX Project Team}},
+  url           = {https://ctan.org/pkg/docstrip},
+  subtitle      = {Remove comments from file},
+  date          = {2025-09-23},
+  version       = {2.6c}
+}
+
+@ctan{dunn:2025,
+  title         = {The \texttt{lwarp} package},
+  author        = {Dunn, Brian},
+  url           = {https://ctan.org/pkg/lwarp},
+  subtitle      = {Converts LaTeX to HTML},
+  date          = {2025-12-10},
+  version       = {0.920}
+}
+
+@ctan{lelong:2018,
+  title         = {The \texttt{appendixnumberbeamer} package},
+  author        = {Lelong, J\'{e}r\^{o}me},
+  url           = {https://github.com/jlelong/appendixnumberbeamer},
+  subtitle      = {Manage frame numbering in appendixes in beamer},
+  date          = {2018},
+  version       = {1.2}
+}
+
+@ctan{latexproject:2025,
+  title         = {The fontspec package},
+  author        = {{The LaTeX Project Team} and Robertson, Will},
+  url           = {https://ctan.org/pkg/fontspec},
+  subtitle      = {Advanced font selection in \XeLaTeX\ and \LuaLaTeX},
+  date          = {2025-09-29},
+  version       = {2.9g}
+}
+
+@ctan{pgfplots,
+  title         = {The \texttt{pgfplots} package},
+  author        = {Feuers\"{a}nger, Christian and Menke, Henri and {The \acro{PGF}/TikZ Team}},
+  url           = {http://pgfplots.sourceforge.net/},
+  subtitle      = {Create normal/logarithmic plots in two and three dimensions},
+  date          = {2025-08-14},
+  version       = {1.18.2}
+}
+
+@ctan{latinmodern,
+  title         = {The \texttt{lm} package},
+  author        = {Jackowski, Bogus\l{}aw and Nowacki, Janusz Marian},
+  url           = {https://www.gust.org.pl/projects/e-foundry/latin-modern},
+  subtitle      = {Latin modern fonts in outline formats},
+  date          = {2021},
+  version       = {2.005}
+}
+
+@article{mittelbach:2014,
+  title         = "\texttt{l3build}{\Dash}{A} modern {Lua} test suite for {\TeX} programming",
+  author        = "Frank Mittelbach and Will Robertson and {{\LaTeX3} team}",
+  year          = "2014",
+  journal       = {TUGboat},
+  volume        = "35",
+  number        = "3",
+  pages         = "287--293",
+  issn          = "0896-3207",
+  url           = "https://tug.org/TUGboat/tb35-3/tb111mitt-l3build.pdf",
+  issn-l        = "0896-3207",
+  issue         = "111",
+  journal-url   = "https://tug.org/TUGboat/"
+}
+
+@software{macfarlane:2025,
+  title         = {\texttt{Pandoc}},
+  author        = {MacFarlane, John and Krewinkel, Albert and Rosenthal, Jesse},
+  year          = {2025},
+  month         = {5},
+  url           = {https://github.com/jgm/pandoc},
+  note          = {Version 3.7.0.2}
+}
+
+@software{allaire:2025,
+  title         = {{\texttt{Quarto}}},
+  author        = {
+    Allaire, J.J. and Teague, Charles and Scheidegger, Carlos and Xie, Yihui and Dervieux,
+    Christophe and Woodhull, Gordon
+  },
+  year          = {2025},
+  month         = sep,
+  doi           = {10.5281/zenodo.5960048},
+  url           = {https://github.com/quarto-dev/quarto-cli},
+  version       = {1.8}
+}
+
+@misc{carl2013,
+  title         = {The {{Paul Tol}} 21-Color Salute},
+  author        = {Carl, Peter},
+  year          = 2013,
+  month         = feb,
+  journal       = {Tradeblotter},
+  url           = {https://tradeblotter.wordpress.com/2013/02/28/the-paul-tol-21-color-salute/},
+  urldate       = {2026-01-16},
+  howpublished  = {\url{https://tradeblotter.com}}
+}
+
+@misc{catppuccin2026,
+  title         = {\texttt{Catppuccin}},
+  author        = {{The Catppuccin organization}},
+  year          = 2026,
+  journal       = {Catppuccin},
+  urldate       = {2026-01-19},
+  howpublished  = {\url{https://catppuccin.com}}
+}

papers/images/lists-metropolis.tex

@@ -0,0 +1,23 @@
+\documentclass{beamer}
+
+\usetheme[numbering=none]{metropolis}
+\setbeamercolor{normal text}{bg=white}
+
+\begin{document}
+
+\begin{frame}[t]
+  \frametitle{Metropolis}
+
+  \begin{itemize}
+    \item Item
+          \begin{itemize}
+            \item Sub-item
+                  \begin{itemize}
+                    \item Sub-sub-item
+                  \end{itemize}
+          \end{itemize}
+  \end{itemize}
+
+\end{frame}
+
+\end{document}

papers/images/lists-moloch.tex

@@ -0,0 +1,23 @@
+\documentclass{beamer}
+
+\usetheme[numbering=none]{moloch}
+\molochcolors{normal text bg=white}
+
+\begin{document}
+
+\begin{frame}[t]
+  \frametitle{Moloch}
+
+  \begin{itemize}
+    \item Item
+          \begin{itemize}
+            \item Sub-item
+                  \begin{itemize}
+                    \item Sub-sub-item
+                  \end{itemize}
+          \end{itemize}
+  \end{itemize}
+
+\end{frame}
+
+\end{document}

papers/images/metropolis-blocks.tex

@@ -0,0 +1,29 @@
+\documentclass{beamer}
+
+\usepackage[T1]{fontenc}
+\usepackage{lmodern}
+\usepackage{tikz}
+
+\usepackage{lipsum}
+
+\usetheme[numbering=none]{metropolis}
+\metroset{block=fill}
+\setbeamercolor{normal text}{bg=white}
+
+\begin{document}
+
+\begin{frame}
+  \frametitle{Metropolis}
+
+  \lipsum[66]
+
+  \begin{block}{Metropolis}
+    \lipsum[66]
+  \end{block}
+
+  \begin{tikzpicture}[overlay, remember picture]
+    \draw[line width=1pt, color=orange] (0,0.3) -- (0,7.2);
+  \end{tikzpicture}
+\end{frame}
+
+\end{document}

papers/images/moloch-blocks.tex

@@ -0,0 +1,29 @@
+\documentclass{beamer}
+
+\usepackage[T1]{fontenc}
+\usepackage{lmodern}
+\usepackage{tikz}
+
+\usepackage{lipsum}
+
+\usetheme[numbering=none]{moloch}
+\molochset{block=fill}
+\molochcolors{normal text bg=white}
+
+\begin{document}
+
+\begin{frame}
+  \frametitle{Moloch}
+
+  \lipsum[66]
+
+  \begin{block}{Metropolis}
+    \lipsum[66]
+  \end{block}
+
+  \begin{tikzpicture}[overlay, remember picture]
+    \draw[line width=1pt, color=orange] (0,0.2) -- (0,6.7);
+  \end{tikzpicture}
+\end{frame}
+
+\end{document}