From: Max Value Date: Sun, 23 Nov 2025 10:41:19 +0000 (+0000) Subject: MERGED X-Git-Url: https://git.ozva.co.uk/?a=commitdiff_plain;h=aff88e2a2206da5d8d6e01af45aa1c21001990b8;p=ootc-docs MERGED --- diff --git a/.gitignore b/.gitignore index 4469528..a6906b1 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,3 @@ **/build +docs/*.pdf +.log diff --git a/Makefile b/Makefile index 1d9906b..c70d1f2 100644 --- a/Makefile +++ b/Makefile @@ -6,17 +6,19 @@ all : pdf tidy .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) - 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 - 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 @@ -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/ootcoutline.pdf : + inkscape -D ./media/svg/ootcoutline.svg -o ./media/ootcoutline.pdf + .PHONY : tidy tidy : -rm latexml.log + -rm .log + -rm ./build/temp.tex -rm ./build/*.log ./build/*.aux ./build/cover-* .PHONY : clean diff --git a/docs/001.tex b/docs/001.tex index c360a70..52e7320 100644 --- 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?} diff --git a/docs/002.tex b/docs/002.tex index 111393a..a0f905b 100644 --- a/docs/002.tex +++ b/docs/002.tex @@ -1,3 +1,5 @@ +\documentclass{dev} + \usepackage{soul} \title{The Deck} diff --git a/docs/003.tex b/docs/003.tex index d312f39..fb5bf79 100644 --- a/docs/003.tex +++ b/docs/003.tex @@ -1,3 +1,5 @@ +\documentclass{dev} + \usepackage{amssymb} \title{The Game and The Guide} diff --git a/docs/004.tex b/docs/004.tex index 5c3fd86..e7adf86 100644 --- a/docs/004.tex +++ b/docs/004.tex @@ -1,3 +1,5 @@ +\documentclass{dev} + \usepackage{amsmath} \usepackage{soul} diff --git a/docs/dev.cls b/docs/dev.cls new file mode 100644 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 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 index 0000000..d7249b9 --- /dev/null +++ b/media/svg/ootcoutline.svg @@ -0,0 +1,38 @@ + + + + + +