user_guide.tex

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% The Commander X16 User's Manual
%
% Authors:
% Jestin Stoffel (jestin.stoffel@gmail.com)
%
% License:
% CC BY-NC-SA 4.0 (https://creativecommons.org/licenses/by-nc-sa/4.0/)
%
% Compiling this template:
% This template uses biber for its bibliography and makeindex for its index.
% When you first open the template, compile it from the command line with the 
% commands below to make sure your LaTeX distribution is configured correctly:
%
% 1) pdflatex main
% 2) makeindex main.idx -s indexstyle.ist
% 3) biber main
% 4) pdflatex main x 2
%
% After this, when you wish to update the bibliography/index use the appropriate
% command above and make sure to compile with pdflatex several times 
% afterwards to propagate your changes to the document.
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%----------------------------------------------------------------------------------------
%	PACKAGES AND OTHER DOCUMENT CONFIGURATIONS
%----------------------------------------------------------------------------------------

\documentclass[
	11pt, % Default font size, select one of 10pt, 11pt or 12pt
	fleqn, % Left align equations
	letterpaper, % Paper size, use either 'a4paper' for A4 size or 'letterpaper' for US letter size
	%oneside, % Uncomment for oneside mode, this doesn't start new chapters and parts on odd pages (adding an empty page if required), this mode is more suitable if the book is to be read on a screen instead of printed
]{CommodoreBlueBook}

% Book information for PDF metadata, remove/comment this block if not required 
\hypersetup{
	pdftitle={Title}, % Title field
	pdfauthor={Author}, % Author field
	pdfsubject={Subject}, % Subject field
	pdfkeywords={Keyword1, Keyword2, ...}, % Keywords
	pdfcreator={LaTeX}, % Content creator field
}

\setlength\parindent{0pt}

\addbibresource{sample.bib} % Bibliography file

\definecolor{blue}{rgb}{0.0,0.0,0.8}
\definecolor{gray}{rgb}{0.73, 0.73, 0.73}

%----------------------------------------------------------------------------------------

\begin{document}

%----------------------------------------------------------------------------------------
%	COVER PAGE
%----------------------------------------------------------------------------------------

\coverpage % Output the title page
	{\includegraphics[width=\paperwidth]{cover.png}} % Code to output the background image, which should be the same dimensions as the paper to fill the page entirely; leave empty for no background image
	{ % Title(s) and author(s)
		\centering\rmfamily % Font styling
		{\Huge\bfseries Retro Computing on the\par} % Top
	}
	{
		\centering\rmfamily % Font styling
		{\huge\bfseries a friendly computer guide\par} % Bottom
	}

%----------------------------------------------------------------------------------------
%	COPYRIGHT PAGE
%----------------------------------------------------------------------------------------

\thispagestyle{empty} % Suppress headers and footers on this page

~\vfill % Push the text down to the bottom of the page

% \noindent \textsc{Published by Publisher}\\ % Publisher

\noindent \textsc{\href{https://www.commanderx16.com}{commanderx16.com}}\\ % URL

\noindent \textit{1st Edition}\\ % Printing/edition date

\noindent Copyright \copyright\ 2024 Jestin Stoffel\\ % Copyright notice

\noindent Licensed under the Creative Commons Attribution-NonCommercial 4.0
License (the ``License''). You may not use this file except in compliance with
the License. You may obtain a copy of the License at
\url{https://creativecommons.org/licenses/by-nc-sa/4.0}. Unless required by
applicable law or agreed to in writing, software distributed under the License
is distributed on an \textsc{``as is'' basis, without warranties or conditions
of any kind}, either express or implied. See the License for the specific
language governing permissions and limitations under the License.\\ % License information, replace this with your own license (if any)

\cleardoublepage % Start the following content on a new page

% start roman page numbering
\pagenumbering{Roman}

%----------------------------------------------------------------------------------------
%	TITLE PAGE
%----------------------------------------------------------------------------------------
\pagecolor{blue}

\afterpage{
	\newgeometry{
		top=1.5in, % Top margin
		bottom=-0.25in, % Bottom margin
		right=0.75in, % Right margin
		}
	\begin{flushright}
		{
			\huge\sffamily\bfseries\color{white}
			RETRO\\ COMPUTING\\ ON THE\\
			\vspace{8pt}
			{
				\contourlength{2pt}
				\contournumber{20}
				\fontsize{36pt}{36pt}\selectfont Commander
				\contour{white}{\textcolor{blue} {X16}}\\
			}
		}
		\huge\sffamily\color{white} A friendly computer guide
	\end{flushright}
	\restoregeometry
	\clearpage
}

\clearpage

% \nopagecolor % Change page color back
\pagecolor{white}

%----------------------------------------------------------------------------------------
%	PREFACE
%----------------------------------------------------------------------------------------

\include{preface}

%----------------------------------------------------------------------------------------
%	TABLE OF CONTENTS
%----------------------------------------------------------------------------------------

\pagestyle{empty} % Disable headers and footers for the following pages

\setcounter{tocdepth}{0}
\tableofcontents % Output the table of contents

% \listoffigures % Output the list of figures, comment or remove this command if not required
% 
% \listoftables % Output the list of tables, comment or remove this command if not required

\pagestyle{fancy} % Enable default headers and footers again

\clearpage % Start the following content on a new page

%----------------------------------------------------------------------------------------
%	SETUP
%----------------------------------------------------------------------------------------

\include{setup}

\cleardoublepage

% start arabic page numbering
\pagenumbering{arabic} % Reset page numbers and use arabic

%----------------------------------------------------------------------------------------
%	PARTS
%----------------------------------------------------------------------------------------

\include{getting_to_know_commanderx16}

\cleardoublepage

\include{using_screen_and_keyboard}

\cleardoublepage

\include{graphics}

\cleardoublepage

\include{sound}

%----------------------------------------------------------------------------------------
%	APPENDICES
%----------------------------------------------------------------------------------------
%----------------------------------------------------------------------------------------
%	PART - APPENDICES
%----------------------------------------------------------------------------------------

\cleardoublepage

\makeatletter\@openrightfalse
\part{APPENDIX}

\include{appendix/basic_commands}

\include{appendix/basic_table}

\include{appendix/screen_codes_table}

\include{appendix/petscii_codes_table}

\include{appendix/memory_map}

\include{appendix/65c02_op_codes}

\include{appendix/patch_table}

\include{appendix/music_play_macros}

\include{appendix/ym2151}

%------------------------------------------------

\@openrighttrue\makeatother

%----------------------------------------------------------------------------------------
\stopcontents[part] % Manually stop the 'part' table of contents here so the previous Part page table of contents doesn't list the following chapters

%----------------------------------------------------------------------------------------
%	INDEX
%----------------------------------------------------------------------------------------

\cleardoublepage % Make sure the index starts on an odd (right side) page
\phantomsection
\addcontentsline{toc}{chapter}{\textcolor{blue}{Index}} % Add an Index heading to the table of contents
\printindex % Output the index

\end{document}