Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
112 commits
Select commit Hold shift + click to select a range
474c9d8
docs: add article for tugboat
jolars Jan 12, 2026
90c4bcc
chore: add latexindent config file
jolars Jan 13, 2026
97ce947
docs: added `pdfa` hyperref option as per tugboat manual
samcarter Jan 14, 2026
4d4044d
docs: adding hints for editor about address
samcarter Jan 14, 2026
ee0f796
refactor: use colons in bib entry names
jolars Jan 14, 2026
98f427e
chore update latexindent settings
jolars Jan 14, 2026
8258988
refactor: use `\titleref` throughout
jolars Jan 14, 2026
014b08d
refactor: use lowercase beamer and titleref it
jolars Jan 14, 2026
0d5aed8
fix: use correct beamer subtitle
jolars Jan 14, 2026
d35c2cb
chore: remove `subtitle` from bibtex file
jolars Jan 14, 2026
df19d5b
feat: fix abstract
jolars Jan 14, 2026
49f4f85
refactor: update bibliography entries using ctanbib
jolars Jan 14, 2026
722304b
feat: update abstract
jolars Jan 14, 2026
f4c6089
chore: remove "increasing"
jolars Jan 14, 2026
f91d7d8
fix: complete sentence
jolars Jan 14, 2026
a44650f
chore: don't track tugboat paper pdf
jolars Jan 14, 2026
c4e1991
chore: remove unused spacing
jolars Jan 14, 2026
0009b75
feat: add a part about progress bars on frames
jolars Jan 14, 2026
83220a8
refactor: move reference to before snippet
jolars Jan 15, 2026
7c087a4
refactor: use texttt instead of titleref
jolars Jan 15, 2026
a412f4c
feat: write about sectionpages
jolars Jan 15, 2026
3e87165
refactor: show both section page styles
jolars Jan 15, 2026
c2b55d2
feat: mention standout frames
jolars Jan 15, 2026
1ddc8f9
feat: write more about the color system
jolars Jan 15, 2026
74bbe03
feat: mention title page styles
jolars Jan 15, 2026
e21f739
chore: format a bit
jolars Jan 15, 2026
6362087
feat: add placeholders for acknowledgements and conclusions
jolars Jan 15, 2026
c355931
fix: reorder an fix label placement
jolars Jan 15, 2026
f40865f
refactor: consistently use first author
jolars Jan 15, 2026
395d354
refactor: add def for tburl
jolars Jan 15, 2026
c34fadf
chore: remove commented code
jolars Jan 15, 2026
5b04c69
refactor: update bibliography
jolars Jan 15, 2026
1da6d13
feat: start writing the documentation section
jolars Jan 15, 2026
38488e1
fix: minor language tweaks
samcarter Jan 16, 2026
1c6d60d
feat: added sentence why metropolis in particular is so prone to brea…
samcarter Jan 16, 2026
364b6f0
chore: autoformat
jolars Jan 16, 2026
fdcfee6
fix: remove extra "these"
jolars Jan 16, 2026
92e4f84
refactor: title case for pandoc
jolars Jan 16, 2026
ea2e302
refactor: use tugboat commands for pdf and html
jolars Jan 16, 2026
5f60b72
fix: use correct year for Pandoc in bibliography
jolars Jan 16, 2026
e766aae
feat: flesh out documentation section
jolars Jan 16, 2026
067b1a8
feat: add an example of the describe option output
jolars Jan 16, 2026
49579f3
chore: add texttt to `blocksBeginWith` in latexindent
jolars Jan 16, 2026
2ffbb22
refactor: update bibliography
jolars Jan 16, 2026
721a39b
chore: add caption to latexindent formatting
jolars Jan 16, 2026
ec6c726
feat: add some content about blocks
jolars Jan 16, 2026
d901413
refactor: clip images for better displays
jolars Jan 16, 2026
ea232b6
chore: ignore minted files
jolars Jan 16, 2026
4a79e2d
refactor: rewrite misc changes list
jolars Jan 16, 2026
075318b
feat: write about itemize lists too
jolars Jan 16, 2026
0fc838e
refactor: rewrite blocks part
jolars Jan 16, 2026
d430a67
feat: mention `sectionpage=progressbar` too
jolars Jan 19, 2026
97db63a
fix: fix some typos and replace article
jolars Jan 19, 2026
b7f556e
fix: consistently use "we", "us", etc
jolars Jan 19, 2026
9e84aa4
refactor: rephrase
jolars Jan 19, 2026
6b4d5ab
feat: update abstract
jolars Jan 19, 2026
f67c69a
feat: enabling -> providing
jolars Jan 19, 2026
690464a
fix: rectify missing elements of blocks section
jolars Jan 19, 2026
17817a1
fix: add missing period
jolars Jan 19, 2026
932fb55
feat: update introductin
jolars Jan 19, 2026
c03de2d
refactor: reword some paragraphs
jolars Jan 19, 2026
4f29392
feat: rephrase transitioning start
jolars Jan 19, 2026
3fa00be
feat: rework spacing section
jolars Jan 19, 2026
09f0920
feat: rewrite some paragraphs
jolars Jan 19, 2026
767a235
feat: updae conclusion
jolars Jan 19, 2026
b1d8f65
fix: fix some grammar errors
jolars Jan 19, 2026
5b9b73f
fix: avoid sentence end space after punctuation
samcarter Jan 19, 2026
fc910f4
fix: unified moloch in typewriter
samcarter Jan 20, 2026
55db641
feat: added sentence why the code is more stable
samcarter Jan 20, 2026
f9c3366
chore: autoformat
jolars Jan 20, 2026
c0750c4
chore: remove unused logo2
jolars Jan 20, 2026
c27f880
refactor: change to white background color
jolars Jan 20, 2026
5ae96ae
fix: add missing apostrophe
jolars Jan 20, 2026
c2118bc
feat: update author and institute
jolars Jan 20, 2026
cc43b19
fix: removed superfluous `\centering` for figures which span the whol…
samcarter Jan 20, 2026
3920836
fix: fira sans light is also used on macOS and windows, not a linux s…
samcarter Jan 20, 2026
0d0c47d
feat: added footnote with github url to full set of weights
samcarter Jan 20, 2026
8383d04
fix: added missing unicode-math package (for the `\setmathfont` macro)
samcarter Jan 20, 2026
74c5aa8
fix: correct spacing between quantity and unit via siunitx
samcarter Jan 20, 2026
34f305e
chore: add missing period
jolars Jan 20, 2026
4aa67fe
fix: avoid end-sentence space
samcarter Jan 20, 2026
2080306
refactor: reorder sections
jolars Jan 20, 2026
9854ee8
fix: only use firamath-otf for unicode engines
samcarter Jan 20, 2026
682fd29
feat: mention grayscale with new color
jolars Jan 20, 2026
9720ab1
fix: under the hood, fontspec is also used by firasans.sty etc.
samcarter Jan 20, 2026
b933eb2
Merge branch 'tugboat-article' of github.com:jolars/moloch into tugbo…
samcarter Jan 20, 2026
8310f3d
refactor: revise frame numbering paragraph
jolars Jan 20, 2026
82d4383
fix: might sound better: small screen -> small screens
samcarter Jan 20, 2026
3f05594
feat: updated the list of misc changes
jolars Jan 21, 2026
76d5179
feat: reorder sections
jolars Jan 21, 2026
4a10580
feat: add acknowledgements
jolars Jan 21, 2026
69b4a76
feat: also thank moloch users
samcarter Jan 21, 2026
ff14452
chore: autoformat
jolars Jan 21, 2026
4f7fb96
feat: add "but unmaintained" and fix overflow
jolars Jan 22, 2026
edc09a0
chore: don't inline code, to fix overflow
jolars Jan 22, 2026
21ed735
chore: rephrase to fix overflow
jolars Jan 22, 2026
0b4d213
chore: put package name in footnote to fix overflow
jolars Jan 22, 2026
3797523
chore: rephrase to fix overflow
jolars Jan 22, 2026
e2081e6
chore: rephrase to fix overflow
jolars Jan 22, 2026
b5fa51d
chore: remove "openly" to fix overflow
jolars Jan 22, 2026
514a4dc
chore: merge paragraphs to fix orphaned code line
jolars Jan 22, 2026
b66afbe
feat: change title and use sentence case
jolars Jan 22, 2026
5ac151d
fix: use sentence case throughout
jolars Jan 22, 2026
fda9b64
feat: add some more text to improve breaking of titles
jolars Jan 22, 2026
25118d0
chre: reduce size in progressbar demos
jolars Jan 22, 2026
cc7841c
feat: rearrange progress bar plots and place in more logical order
jolars Jan 22, 2026
b907964
fix: add missing url entry in bibliography, update formatting
jolars Jan 22, 2026
426a9aa
refactor: use \meta instead of dots
jolars Jan 23, 2026
88a2353
refactor: reorganize tugboat files
jolars Jan 23, 2026
cf82bbe
chore: add tugboat build task
jolars Jan 23, 2026
f298d21
chore: rename document and output
jolars Feb 23, 2026
d95a0cb
chore: update files
jolars Feb 23, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -461,3 +461,4 @@ dist
.task/

examples/*.pdf
*.minted
34 changes: 34 additions & 0 deletions .latexindent.yaml
Original file line number Diff line number Diff line change
@@ -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\{
54 changes: 54 additions & 0 deletions Taskfile.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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 ..
1 change: 1 addition & 0 deletions papers/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
tugboat.pdf
146 changes: 146 additions & 0 deletions papers/bibliography.bib
Original file line number Diff line number Diff line change
@@ -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}}
}
Binary file added papers/images/describe-option-html.pdf
Binary file not shown.
Binary file added papers/images/describe-option-pdf.pdf
Binary file not shown.
Binary file added papers/images/lists-metropolis.pdf
Binary file not shown.
23 changes: 23 additions & 0 deletions papers/images/lists-metropolis.tex
Original file line number Diff line number Diff line change
@@ -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}
Binary file added papers/images/lists-moloch.pdf
Binary file not shown.
23 changes: 23 additions & 0 deletions papers/images/lists-moloch.tex
Original file line number Diff line number Diff line change
@@ -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}
Binary file added papers/images/logo.pdf
Binary file not shown.
Binary file added papers/images/metropolis-blocks.pdf
Binary file not shown.
29 changes: 29 additions & 0 deletions papers/images/metropolis-blocks.tex
Original file line number Diff line number Diff line change
@@ -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}
Binary file added papers/images/moloch-blocks.pdf
Binary file not shown.
29 changes: 29 additions & 0 deletions papers/images/moloch-blocks.tex
Original file line number Diff line number Diff line change
@@ -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}
Binary file added papers/images/moloch-demo.pdf
Binary file not shown.
Loading