diff --git a/docs/whitepaper/README.md b/docs/whitepaper/README.md new file mode 100644 index 0000000..78ec9af --- /dev/null +++ b/docs/whitepaper/README.md @@ -0,0 +1,39 @@ +--- +fontfamily: tgtermes +title: "mcopy: Modular Optical Tool Platform for Small Gauge Motion Picture Film" +documentclass: article +author: +- name: Matthew McWilliams + affiliation: sixteenmillimeter.com + email: hi@mmcwilliams.com +abstract: | + Tools purpose-built for working with 16mm, Super8 and Regular8 film have not been produced commercially since the + The mcopy project proposes a modular, open-source platform for building optical tools for small gauge analog moviefilm formats. + The platform can be used to assemble optical printers, digital transfer units and film recorders for digital images. +bibliography: sources.bib +csl: citation_style.csl +--- + +# Introduction + +# Desktop Application + +# Serial Protocol + +# Retrofitting Existing Hardware + +# New Hardware + +Retrofitting existing hardware was always intended as the first step to producing new hardware modules that could eventually completely replace all legacy machine parts. +This approach is sometimes referred to as a "Ship of Theseus pattern"[@wiki-shipoftheseus] and in this application is, simply put: build machines using parts that people and organizations already have until total replacements can be designed. +The practice of retrofitting hardware, in this case, required the kind of inspection that makes designing replacements possible: detailed measurements, documenting electrical diagrams, and review of sourced components. + +Two examples of this pattern that have materialized new modular components are the projector and gate designs. + +## References + +--- +refs: | + ::: {#refs} + ::: +... \ No newline at end of file diff --git a/docs/whitepaper/citation_style.csl b/docs/whitepaper/citation_style.csl new file mode 100644 index 0000000..0e5cab2 --- /dev/null +++ b/docs/whitepaper/citation_style.csl @@ -0,0 +1,169 @@ + + diff --git a/docs/whitepaper/compile.sh b/docs/whitepaper/compile.sh new file mode 100644 index 0000000..4b8ad98 --- /dev/null +++ b/docs/whitepaper/compile.sh @@ -0,0 +1,6 @@ +#!/bin/bash + +set -e + +pandoc README.md -o mcopy_whitepaper.pdf --filter pandoc-citeproc --pdf-engine=pdflatex --template=template.tex +pandoc README.md -o index.html --filter pandoc-citeproc \ No newline at end of file diff --git a/docs/whitepaper/sources.bib b/docs/whitepaper/sources.bib new file mode 100644 index 0000000..f30a232 --- /dev/null +++ b/docs/whitepaper/sources.bib @@ -0,0 +1,6 @@ +@online{wiki-shipoftheseus, + author={Wikipedia}, + title={Ship of Theseus}, + url={https://en.wikipedia.org/wiki/Ship_of_Theseus}, + urldate={2025-02-20} +} \ No newline at end of file diff --git a/docs/whitepaper/template.tex b/docs/whitepaper/template.tex new file mode 100644 index 0000000..abd7e8b --- /dev/null +++ b/docs/whitepaper/template.tex @@ -0,0 +1,68 @@ +\documentclass[10pt]{article} +\usepackage[left=1.5in, + right=1.5in, + top=1in, + bottom=1.5in,]{geometry} +\usepackage{authblk} +\usepackage{setspace} +\usepackage{hyperref} +\usepackage{lmodern} % For better font weights +\usepackage{sectsty} % For section formatting + +\newlength{\cslhangindent} +\setlength{\cslhangindent}{1.5em} +\newenvironment{cslreferences}% + {\setlength{\parindent}{0pt}% + \everypar{\setlength{\hangindent}{\cslhangindent}}\ignorespaces}% + {\par} + +% Handle conditionals +$if(colorlinks)$ +\PassOptionsToPackage{usenames,dvipsnames}{color} +$endif$ + +% Handle fonts +$if(fontfamily)$ +\usepackage[$for(fontfamilyoptions)$$fontfamilyoptions$$sep$,$endfor$]{$fontfamily$} +$endif$ + +% Make sections bolder and adjust spacing +\sectionfont{\large\bfseries} +\allsectionsfont{\bfseries} + +% Adjust line spacing +\setstretch{1.1} % Tighter line spacing + +\begin{document} + +% Thick line above title +\noindent\rule{\textwidth}{5pt} + +% Title with tighter spacing and bolder font +\begin{center} +{\fontsize{17}{19}\selectfont\bfseries $title$\par} +\end{center} + +% Thin line below title +\noindent\rule{\textwidth}{1pt} + +% Authors with tighter spacing +$for(author)$ +\begin{center} +{\large\bfseries $author.name$\par} +{\normalsize $author.affiliation$\par} +{\normalsize\ttfamily $author.email$} +\vspace{0.7em} +\end{center} +$endfor$ + +\vspace{0.5em} +{\begin{center}\large\bfseries Abstract\end{center}} + +\begin{quotation} +{\selectfont $abstract$} +\end{quotation} + +$body$ + +\end{document} \ No newline at end of file