SNOUG draft outline

BUILD.md

@@ -5,7 +5,10 @@
 * Minted syntax highlighting requires python-pygments to be installed.
 
 ```
-apt install texlive-latex-recommended texlive-xetex python3-pygments
+apt install texlive-latex-recommended texlive-xetex \
+    texlive-humanities \
+    python3-pygments \
+    fonts-gemunu-libre fonts-linuxlibertine
 ```
 
 

src/Colophon.tex

@@ -20,7 +20,7 @@
 
 Debian GNU/Linux
 
-{\LaTeX} Memoir
+{\LaTeX}
 
 \rule{0\textwidth}{0pt}\\[\baselineskip]%
 \rule{0.5\textwidth}{0.4pt}\\[\baselineskip]

src/Copyright.tex

@@ -27,9 +27,6 @@ this document under the terms of the
 Creative Commons Attribution 4.0 International Public License
 (CC BY-SA 4.0).
 
-Document layout/template:\par
-Copyright \copyright\ 2022 Jeff Moe\par
-
 Published by Jeff Moe, Loveland, Colorado, USA.
 
 % ISBN: NNN-N-NNN-NNNNN-N

src/Hardware.tex

@@ -46,6 +46,13 @@ Cameras being tested:
 \end{itemize}
 
 
+\fbox{
+    \parbox{\linewidth}{
+        \textcolor{red}{NOTICE:} \\
+        ZWO/ASI cameras require proprietary non-libre software on host computer.
+    }
+}
+
 \section{Lenses}
 
 Lenses being tested:
@@ -67,4 +74,17 @@ Computers, such as Raspberry Pi, that can be used.
  \item Intel NUC --- ?
 \end{itemize}
 
+\subsection{Comparison}
+Comparing embedded computers for SatNOGS Optical.
 
+\begin{center}
+ \hspace*{-1.5cm}\begin{tabular}{||c c c c c||}
+ \hline
+ Make & Model & Architecture & Max RAM & eMMC \\ [0.5ex]
+ \hline\hline
+ Odroid & N2 & ARM64 & 4 GB & Yes \\
+ \hline
+ Odroid & M2 & ARM64 & 8 GB & Yes \\ [1ex]
+ \hline
+\end{tabular}
+\end{center}

src/Introduction.tex

@@ -10,10 +10,20 @@
 %
 
 \section{Introduction}
-SatNOGS Optical Unofficial Guide.
+The SatNOGS Optical Unofficial Guide documents how to set up and run an
+optical ground station for the Libre Space Foundation's SatNOGS network.
+The Libre Space Foundation supports
+``free and accessible space for all, creating Open Source space technologies.''%
+\footnote{\scriptsize{https://libre.space}}
+
+More rocks in space.%
+\footnote{\scriptsize{https://starlink.com}}
+
 
 \section{Process Overview}
-SatNOGS Optical Process Overview.
+SatNOGS Optical Process Overview.%
+\footnote{\scriptsize{https://spacecruft.org/spacecruft/SNOPO}}
+See figure (Fig. \ref{fig:snopo}, page \pageref{fig:snopo})
 
 \begin{figure}[h!]
 \includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{SNOPO.png}
@@ -21,3 +31,7 @@ SatNOGS Optical Process Overview.
  \label{fig:snopo}
 \end{figure}
 
+
+Run \texttt{acquire.py}, then \texttt{process\_new.py}.
+But don't run \textcolor{red}{rm -rf /*}.
+

src/Makefile

@@ -1,3 +1,5 @@
+# Makefile
+
 all:
 	xelatex								\
 		-halt-on-error						\
@@ -5,6 +7,8 @@ all:
 		-interaction=nonstopmode				\
 		-no-pdf							\
 		SNOUG.tex
+	makeindex -s SNOUG.gst -o SNOUG.gls SNOUG.glo
+	makeindex -s SNOUG.ist SNOUG.idx
 	xelatex								\
 		-halt-on-error						\
 		-shell-escape						\

src/SNOUG.tex

@@ -161,8 +161,8 @@ leftmargin=1cm,rightmargin=1cm
 
 %%% FOOTNOTES %%%
 % no horizontal rule before footnotes:
-\let\oldfootnoterule\footnoterule
-\renewcommand*{\footnoterule}{}
+%\let\oldfootnoterule\footnoterule
+%\renewcommand*{\footnoterule}{}
 \setlength{\footmarkwidth}{3.5em}
 %%% END FOOTNOTES %%%
 
@@ -200,7 +200,9 @@ leftmargin=1cm,rightmargin=1cm
 %%% TITLE PAGE %%%
 % We want the title to be on the right hand page.
 % If we pad a page, it gives us two with openright
+\pagecolor{jebba-green}
 \include{Title}
+\pagecolor{white}
 %%% END TITLE PAGE
 
 %%% COPYRIGHT PAGE %%%
@@ -280,6 +282,7 @@ leftmargin=1cm,rightmargin=1cm
 \chapterconf{Ground_Stations}{Ground Stations}{Earth Ground Stations}
 \chapterconf{Hardware}{Hardware}{Hardware for Optical Ground Stations}
 \chapterconf{Operation}{Operation}{Operating Optical Ground Stations}
+\chapterconf{Support}{Support}{Help}
 \chapterconf{Contact}{Contact}{Email}
 %% END MAINMATTER CHAPTERS %%%
 
@@ -294,6 +297,7 @@ leftmargin=1cm,rightmargin=1cm
 %%% END INDEX %%%
 
 %%% GLOSSARY %%%
+% XXX Fix word formatting, bold glossary word
 \renewcommand{\memgloterm}[1]{\textbf{#1}}
 \renewcommand{\memglodesc}[1]{\textit{#1}}
 \renewcommand{\memglonum}[1]{}

src/Satellites.tex

@@ -13,4 +13,4 @@
 \label{sec:overview-satellites}
 
 Artificial satellites are rocks with modems.
-
+\glossary{Artificial satellite}{Satellite launched by teh hoomans.}

src/Support.tex

@@ -0,0 +1,20 @@
+%
+% Support
+%
+% SatNOGS Optical Unofficial Guide
+%
+% Copyright (C) 2022, Jeff Moe
+%
+% This document is licensed under the Creative Commons Attribution 4.0
+% International Public License (CC BY-SA 4.0) by Jeff Moe.
+%
+
+\section{Support}
+\label{sec:support}
+\index{community}
+\index{support}
+\index{forum}
+How to get help.
+
+https://community.libre.space
+

src/Title.tex

@@ -11,17 +11,37 @@
 
 \date {}
 \thispagestyle{empty}
+\begingroup
+\centering
 \begin{center}
-\par
-%\includegraphics[keepaspectratio=true,angle=0,height=0.95\textheight,width=0.95\textwidth]{ai-title.pdf}
-\par
-\null\vfill
-{\fontspec{lmroman12-regular.otf}\fontsize{25pt}{5cm}\selectfont \textcolor{jebba-purple}{SatNOGS Optical Unofficial Guide}}
-
-
-\par
-\null\vfill
-\renewcommand{\dateseparator}{}
-\hfill\texttt{\yyyymmdddate\today} % Timestamp build date
+\fontspec{GemunuLibre-ExtraBold.otf}\fontsize{58pt}{1em}\selectfont %
+SatNOGS Optical \\
+\fontspec{LinLibertine_RI.otf}\fontsize{16pt}{0em}\selectfont %
+\emph{\textcolor{white}{\begin{turn}{15}Unofficial\end{turn}}} \\
+\fontspec{GemunuLibre-ExtraBold.otf}\fontsize{68pt}{1em}\selectfont %
+Guide
 \end{center}
-
+\par
+\begin{center}
+\includegraphics[keepaspectratio=true,angle=0,height=0.10\textheight,width=0.15\textwidth]{spacecruft.png}
+\includegraphics[keepaspectratio=true,angle=0,height=0.15\textheight,width=0.25\textwidth]{spacecruft.png}
+\includegraphics[keepaspectratio=true,angle=0,height=0.15\textheight,width=0.20\textwidth]{spacecruft.png}
+\\
+\par
+\null\vfill
+\centering
+\includegraphics[keepaspectratio=true,angle=0,height=0.85\textheight,width=0.85\textwidth]{title-pic.png}
+\par
+\null\vfill
+\includegraphics[keepaspectratio=true,angle=0,height=0.02\textheight,width=0.02\textwidth]{spacecruft.png}
+\includegraphics[keepaspectratio=true,angle=0,height=0.02\textheight,width=0.02\textwidth]{spacecruft.png}
+\includegraphics[keepaspectratio=true,angle=0,height=0.02\textheight,width=0.02\textwidth]{spacecruft.png}
+\\
+\null\vfill\hfill
+\fontspec{lmroman12-italic.otf}\fontsize{10pt}{1em}\selectfont %
+{by} \\
+\null\vfill\hfill
+\fontspec{lmroman12-regular.otf}\fontsize{14pt}{1em}\selectfont %
+{Jeff Moe}
+\end{center}
+\endgroup