MERGED

diff --git a/.gitignore b/.gitignore
index 4469528287c64a162fb1f47d325f2d49adbbd6ad..a6906b13a854c8b74096ccfec68c86179fc1e6d1 100644 (file)
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,3 @@
 **/build
 **/build

+docs/*.pdf
+.log

diff --git a/Makefile b/Makefile
index 1d9906bc38874824efe1b10e9c4d51a529d20654..c70d1f2f5e5c42254dfe5e648d3f9185deae4e21 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -6,17 +6,19 @@ all : pdf tidy
 .PHONY : pdf
 pdf : $(documents)
 
 .PHONY : pdf
 pdf : $(documents)
 

-$(documents) : ./media/goodnight.pdf ./media/ootcblack.pdf ./media/ootccolor.pdf ./media/ootcgray.pdf
+$(documents) : ./media/goodnight.pdf ./media/ootcblack.pdf ./media/ootccolor.pdf ./media/ootcgray.pdf ./media/ootcoutline.pdf
+       tail -n +2 "docs/$@.tex" > ./build/temp.tex
+

        # compile as pdf for screens using the ootc-pdf format (twice)
        # compile as pdf for screens using the ootc-pdf format (twice)

-       pdflatex -output-directory="./build" -interaction="nonstopmode" -jobname='$@' -output-format='pdf' "\documentclass{ootc-pdf}\input{docs/$@}"
-       pdflatex -output-directory="./build" -interaction="nonstopmode" -jobname='$@' -output-format='pdf' "\documentclass{ootc-pdf}\input{docs/$@}"
+       pdflatex -output-directory="./build" -interaction="nonstopmode" -jobname='$@' -output-format='pdf' "\documentclass{ootc-pdf}\input{build/temp}"
+       pdflatex -output-directory="./build" -interaction="nonstopmode" -jobname='$@' -output-format='pdf' "\documentclass{ootc-pdf}\input{build/temp}"

 
        # make the titlepage for the document
        # pdfjam ./build/$@.pdf 1 -o ./build/cover-$@.pdf
        # magick -density 60x60 ./build/cover-$@.pdf -quality 90 -background white -flatten -alpha off ./build/$@.png
 
        # compile as epub using the ootc-epub format
 
        # make the titlepage for the document
        # pdfjam ./build/$@.pdf 1 -o ./build/cover-$@.pdf
        # magick -density 60x60 ./build/cover-$@.pdf -quality 90 -background white -flatten -alpha off ./build/$@.png
 
        # compile as epub using the ootc-epub format

-       latexmlc --dest=./build/$@.epub --base=./build --includestyles "literal:\documentclass{ootc-html}\input{docs/$@}"
+       latexmlc --dest=./build/$@.epub --base=./build --includestyles "literal:\documentclass{ootc-html}\input{build/temp}"

 
 ./media/goodnight.pdf :
        inkscape -D ./media/svg/goodnight.svg  -o ./media/goodnight.pdf
 
 ./media/goodnight.pdf :
        inkscape -D ./media/svg/goodnight.svg  -o ./media/goodnight.pdf


@@ -30,9 +32,14 @@ $(documents) : ./media/goodnight.pdf ./media/ootcblack.pdf ./media/ootccolor.pdf
 ./media/ootcgray.pdf :
        inkscape -D ./media/svg/ootcgray.svg  -o ./media/ootcgray.pdf
 
 ./media/ootcgray.pdf :
        inkscape -D ./media/svg/ootcgray.svg  -o ./media/ootcgray.pdf
 

+./media/ootcoutline.pdf :
+       inkscape -D ./media/svg/ootcoutline.svg  -o ./media/ootcoutline.pdf
+

 .PHONY : tidy
 tidy :
        -rm latexml.log
 .PHONY : tidy
 tidy :
        -rm latexml.log

+       -rm .log
+       -rm ./build/temp.tex

        -rm ./build/*.log ./build/*.aux ./build/cover-*
 
 .PHONY : clean
        -rm ./build/*.log ./build/*.aux ./build/cover-*
 
 .PHONY : clean

diff --git a/docs/001.tex b/docs/001.tex
index c360a702340a4d95a01c9d57aff3577ea1aafefe..52e7320581f3a34639179c20b6975b15f6dcf026 100644 (file)
--- a/docs/001.tex
+++ b/docs/001.tex
@@ -1,4 +1,5 @@
-% \documentclass{../ootc-pdf}
+\documentclass{dev}
+

 \usepackage{amssymb}
 
 \title{Defining the rule: What \textit{is} The Commissioner (all hail) anyway?}
 \usepackage{amssymb}
 
 \title{Defining the rule: What \textit{is} The Commissioner (all hail) anyway?}

diff --git a/docs/002.tex b/docs/002.tex
index 111393ac35f6b99533ed9da70b40064e2088ec83..a0f905b7144631819ac48403c964778452c49de6 100644 (file)
--- a/docs/002.tex
+++ b/docs/002.tex
@@ -1,3 +1,5 @@
+\documentclass{dev}
+

 \usepackage{soul}
 
 \title{The Deck}
 \usepackage{soul}
 
 \title{The Deck}

diff --git a/docs/003.tex b/docs/003.tex
index d312f39e17a9c2a8bc2149075d3b64988b38e636..fb5bf79785e2083937afd5cbab9fecb450b7155c 100644 (file)
--- a/docs/003.tex
+++ b/docs/003.tex
@@ -1,3 +1,5 @@
+\documentclass{dev}
+

 \usepackage{amssymb}
 
 \title{The Game and The Guide}
 \usepackage{amssymb}
 
 \title{The Game and The Guide}

diff --git a/docs/004.tex b/docs/004.tex
index 5c3fd86ee50d0544ff3af0e92d89a197ac293429..e7adf86d9bddc6bfa4de5a11c8c7e41e7fc66aa5 100644 (file)
--- a/docs/004.tex
+++ b/docs/004.tex
@@ -1,3 +1,5 @@
+\documentclass{dev}
+

 \usepackage{amsmath}
 \usepackage{soul}
 
 \usepackage{amsmath}
 \usepackage{soul}
 

diff --git a/docs/dev.cls b/docs/dev.cls
new file mode 100644 (file)
index 0000000..52f150a
--- /dev/null
+++ b/docs/dev.cls
@@ -0,0 +1,94 @@
+% ---------------------------------------------------------
+% Documentation class for documentation of the Office of
+% the Commissioner (all hail).
+%
+% This file is licenced under the Blackjack 2 Esoteric
+% Licence.
+% ---------------------------------------------------------
+
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesClass{dev}[27/08/2025 Class for typesetting documentation content before being published.]
+
+\LoadClass{article}
+\usepackage{tikz}
+\RequirePackage{graphicx}
+\RequirePackage[table]{xcolor}
+\graphicspath{{./media/}}
+\RequirePackage[
+       a4paper,
+       top=2cm,
+       bottom=4cm,
+       left=4cm,
+       right=2cm,
+       ]{geometry}
+\RequirePackage{helvet}
+\renewcommand{\familydefault}{\sfdefault}
+\RequirePackage{draftwatermark}
+
+% ---------------------------------------------------------
+% Colour setup
+
+\definecolor           {ootc-blue}             {HTML}  {8BE7FF}
+\definecolor           {ootc-pink}             {HTML}  {F49AC0}
+\definecolor           {ootc-green}    {HTML}  {7CC576}
+
+% ---------------------------------------------------------
+% Additional option setup
+
+\newcommand*{\id}[1]{\gdef\@id{#1}}
+\newcommand*{\@id}{DRA}
+\newcommand*{\type}[1]{\gdef\@type{#1}}
+\newcommand*{\@type}{Draft}
+\newcommand*{\exerpt}[1]{\gdef\@exerpt{#1}}
+\newcommand*{\@exerpt}{}
+\newcommand*{\version}[1]{\gdef\@version{#1}}
+\newcommand*{\@version}{v1.0}
+
+% ---------------------------------------------------------
+% Re-make the title in the OotC style
+% ---------------------------------------------------------
+
+% Titlepage 1
+\renewcommand{\maketitle}{%
+       \begin{titlepage}
+               \begin{flushright}
+                       {\Huge\noindent\textbf{\@id}\par}
+                       {\Large\noindent\@type\par}
+                       \vspace{5mm}
+                       {\Huge\noindent\textbf{\@title}\par}
+                       \vspace{5mm}
+               \end{flushright}
+               \vspace*{\fill}
+               {\large\noindent\textit{%
+                       \textbf{The Office of the Commissioner (all hail)}
+                       }%
+               }%
+               \tikz[%
+                       remember picture,
+                       overlay,
+                       shift=(current page.east)
+                       ]%
+                       \node[inner sep=0pt]
+                       at (-3cm,-2cm){%
+                               \includegraphics[width=12cm]{ootcoutline}
+                               };
+               \clearpage
+               \thispagestyle{empty}
+% ---------------------------------------------------------
+% Titlepage 2
+               \newpage
+               \section*{Document information}
+               \@title\par
+               Item \@id \textit{(\@version)}\par
+               \begin{quotation}
+                       \noindent\textcolor{gray}{\textit{%
+                               "\@exerpt{}"
+                       }}
+               \end{quotation}
+               \thispagestyle{empty}
+       \end{titlepage}
+       \pagenumbering{arabic}
+}
+
+% ---------------------------------------------------------
+\endinput

diff --git a/media/ootcoutline.pdf b/media/ootcoutline.pdf
new file mode 100644 (file)
index 0000000..06f641b
Binary files /dev/null and b/media/ootcoutline.pdf differ

diff --git a/media/svg/ootcoutline.svg b/media/svg/ootcoutline.svg
new file mode 100755 (executable)
index 0000000..d7249b9
--- /dev/null
+++ b/media/svg/ootcoutline.svg
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   width="3.0099702cm"
+   height="4.100904cm"
+   version="1.1"
+   id="svg1"
+   sodipodi:docname="ootcoutline.svg"
+   inkscape:version="1.4.2 (ebf0e940d0, 2025-05-08)"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <defs
+     id="defs1" />
+  <sodipodi:namedview
+     id="namedview1"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:zoom="3.0353407"
+     inkscape:cx="16.966794"
+     inkscape:cy="91.093563"
+     inkscape:window-width="1366"
+     inkscape:window-height="704"
+     inkscape:window-x="0"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="svg1"
+     inkscape:document-units="cm" />
+  <path
+     id="path6"
+     style="fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.377953;stroke-dasharray:none;stroke-opacity:1"
+     d="M 32.578265,0.19313548 C 28.1657,0.11635959 23.574353,1.1022607 18.804118,3.1506864 14.118467,5.1627573 10.309178,7.697864 7.3751023,10.75534 5.1624469,13.038799 3.4239794,15.831265 2.1605607,19.132586 0.89683101,22.434841 0.24012877,25.832175 0.19017713,29.325211 0.14489387,34.057234 1.3812409,39.354287 3.8987413,45.217147 c 3.9338863,9.16138 9.5472307,15.267699 16.8414167,18.32004 7.293407,3.052808 15.22024,2.741279 23.779244,-0.933979 C 52.973368,58.972922 58.599673,53.449416 61.397899,46.031986 64.195813,38.61549 63.60024,30.260572 59.610178,20.968633 55.586659,11.598575 49.89921,5.3758079 42.549627,2.300592 39.333913,0.95532103 36.010258,0.25285007 32.578265,0.19313548 Z M 30.182985,11.470793 c 2.268949,-0.01323 4.474771,0.480974 6.61779,1.482575 4.285571,2.003979 7.845091,6.303482 10.677395,12.899433 2.866073,6.67438 3.529867,12.317948 1.99257,16.930772 -1.538075,4.61298 -4.623012,7.914235 -9.25591,9.903587 -4.632743,1.989351 -9.176895,1.948875 -13.630994,-0.122484 -4.454255,-2.07027 -8.080513,-6.364742 -10.879205,-12.882109 -2.843353,-6.621782 -3.50487,-12.204674 -1.983757,-16.748717 1.520647,-4.54311 4.67632,-7.843965 9.466231,-9.900852 2.394956,-1.028366 4.726932,-1.548978 6.99588,-1.562205 z m 60.886466,29.775194 c -0.51588,-0.0061 -1.0371,0.0058 -1.563421,0.03586 -4.211032,0.240732 -8.024697,1.389244 -11.441171,3.445664 -4.466082,2.688363 -7.74802,5.811068 -9.846144,9.36806 -2.097969,3.556993 -2.979255,7.436687 -2.643287,11.640247 0.335656,4.203098 1.575758,8.085837 3.720722,11.649366 3.466893,5.759533 8.27635,9.372741 14.429117,10.839389 6.151988,1.466338 12.169675,0.429766 18.051363,-3.110731 5.83268,-3.510776 9.52729,-8.295455 11.08497,-14.352831 1.55675,-6.057376 0.56501,-12.027294 -2.97518,-17.908517 -2.29171,-3.807218 -5.20872,-6.747447 -8.75078,-8.820985 -3.099705,-1.814617 -6.455026,-2.742786 -10.066189,-2.785526 z m 1.494427,11.586451 c 0.615727,0.0093 1.218951,0.06961 1.809909,0.181448 3.151777,0.596307 5.535605,2.236612 7.151803,4.921551 1.61588,2.684317 1.94567,5.55255 0.9902,8.604891 -0.95577,3.051874 -3.336676,5.724166 -7.143893,8.015872 -3.904943,2.350684 -7.429751,3.233224 -10.57406,2.649366 -3.144463,-0.584326 -5.524668,-2.218697 -7.140549,-4.903014 -1.616193,-2.68494 -1.949601,-5.559106 -1.001453,-8.623429 0.948303,-3.064323 3.349808,-5.756905 7.2062,-8.078178 3.132813,-1.885782 6.033699,-2.808604 8.701843,-2.768507 z m -42.516885,16.13721 -6.802884,5.916317 -3.617081,-4.159294 -7.222005,6.280731 3.616777,4.159293 -14.927563,12.981798 c -3.202974,2.785621 -5.246844,4.732805 -6.131501,5.841856 -1.27758,1.526101 -2.085102,2.974241 -2.422937,4.343781 -0.337835,1.36971 -0.210828,2.94817 0.381433,4.73616 0.591795,1.78752 1.598351,3.4984 3.01925,5.13217 2.317538,2.66487 4.843927,4.65823 7.578819,5.97984 l 6.355498,-6.88616 c -1.963831,-1.08617 -3.309892,-2.04814 -4.038937,-2.88643 -0.523481,-0.60191 -0.817153,-1.24276 -0.880487,-1.92388 -0.06365,-0.68065 0.08381,-1.28134 0.443738,-1.8014 0.358999,-0.52021 1.936045,-1.99519 4.73038,-4.42523 l 13.799372,-12.000413 5.383527,6.19016 7.222005,-6.280428 -5.383527,-6.190463 12.090672,-10.514488 z m 23.349488,28.653384 c -3.34148,0.02486 -6.912886,0.494288 -10.714171,1.408415 -9.582935,2.304313 -16.510886,6.723863 -20.784007,13.259903 -4.273278,6.53526 -5.437619,13.84643 -3.492773,21.93377 1.571687,6.53604 4.481708,11.54177 8.731021,15.01753 4.248379,3.4753 9.916666,5.32785 17.003108,5.55738 l 0.913312,-12.83227 c -4.70588,0.0475 -8.380032,-0.85633 -11.023268,-2.71045 -2.643391,-1.8549 -4.357882,-4.41658 -5.143726,-7.68429 -1.065635,-4.43153 -0.297453,-8.42491 2.305012,-11.98004 2.601687,-3.55559 7.752281,-6.25891 15.452148,-8.11039 7.255904,-1.74489 12.842592,-1.60178 16.75905,0.43036 3.916302,2.03153 6.417432,5.30477 7.503141,9.8194 0.785688,3.26771 0.539501,6.26429 -0.738856,8.98876 -1.278513,2.72446 -3.41007,4.82623 -6.394097,6.30595 l 5.835169,11.47278 c 4.541242,-2.55733 7.780501,-5.53357 9.718189,-8.92888 3.284827,-5.71176 4.031387,-12.29278 2.239977,-19.74274 -2.051448,-8.53083 -6.510644,-14.73831 -13.377827,-18.62427 -4.291892,-2.428632 -9.222272,-3.622353 -14.791402,-3.580918 z" />
+</svg>