%-------------------------------------------------------------------------------
% This file provides a skeleton ATLAS book for things like TDRs.
%-------------------------------------------------------------------------------
% \pdfoutput=1
% The \pdfoutput command is needed by arXiv/JHEP/JINST to ensure use of pdflatex.
% It should be included in the first 5 lines of the file.
\pdfinclusioncopyfonts=1
% This command may be needed in order to get \ell in PDF plots to appear. Found in
% https://tex.stackexchange.com/questions/322010/pdflatex-glyph-undefined-symbols-disappear-from-included-pdf
%-------------------------------------------------------------------------------
% Specify where ATLAS LaTeX style files can be found.
\RequirePackage{latex/atlaslatexpath}
% Comment out the above line if the files are in a central location, e.g. $HOME/texmf.
%-------------------------------------------------------------------------------
\documentclass[BOOK, atlasdraft=true, UKenglish, palatino]{atlasdoc}
% The language of the document must be set: usually UKenglish or USenglish.
% british and american also work!
% Commonly used options:
%  atlasdraft=true|false This document is an ATLAS draft.
%  coverpage             Create ATLAS draft cover page for collaboration circulation.
%                        See atlas-draft-cover.tex for a list of variables that should be defined.
%  NOTE                  The document is an ATLAS note (draft).
%  PAPER                 The document is an ATLAS paper (draft).
%  CONF                  The document is a CONF note (draft).
%  PUB                   The document is a PUB note (draft).
%  BOOK                  The document is of book form, like an LOI or TDR (draft)
%  paper=a4|letter       Set paper size to A4 (default) or letter.

%-------------------------------------------------------------------------------
% Extra packages:
\usepackage{atlaspackage}
% Commonly used options:
%  subfigure|subfig|subcaption  to use one of these packages for figures in figures.
%  minimal               Minimal set of packages.
%  default               Standard set of packages.
%  full                  Full set of packages.
%-------------------------------------------------------------------------------

% Style file with biblatex options for ATLAS documents.
\usepackage{atlasbiblatex}
% Commonly used options:
%  backref=true|false    Turn on or off back references in the bibliography.

%-------------------------------------------------------------------------------
% Package to include front and back cover images
% \usepackage{pdfpages}

% Useful macros
\usepackage{atlasphysics}
% See doc/atlas_physics.pdf for a list of the defined symbols.
% Default options are:
%   true:  journal, misc, particle, unit, xref
%   false: BSM, heppparticle, hepprocess, hion, jetetmiss, math, process,
%          other, snippets
% See the package for details on the options.

% Macro to add to-do notes (for several authors). Uses the todonotes package.
% \ATLnote{JS}{Jane}{green!20}{green!50!black!60}
% add macros \JSnote and \JSinote for notes in the margin and inline.
% The first colour is for the body and the second for the border of the note.
% Set output=false in order not to print out the notes.
% Set shift=false to avoid adjustment of margins.
% This package should not be used in the final version of the book.
\ifthenelse{\boolean{AtlasDraft}}{%
  \usepackage[output=true, shift=true]{atlastodo}
}{}

% Files with references for use with biblatex.
% Note that biber gives an error if it finds empty bib files.
% \addbibresource{atlas-document.bib}
\addbibresource{bib/ATLAS.bib}
\addbibresource{bib/CMS.bib}
\addbibresource{bib/ConfNotes.bib}
\addbibresource{bib/PubNotes.bib}

% Paths for figures - do not forget the / at the end of the directory name.
\graphicspath{{logos/}{figures/}}

% Add your own definitions here (file atlas-document-defs.sty).
\usepackage{atlas-document-defs}

%-------------------------------------------------------------------------------
% Generic document information
%-------------------------------------------------------------------------------

% Title, abstract and document 
\input{atlas-document-metadata}
% Author and title for the PDF file
\hypersetup{pdftitle={ATLAS document}, pdfauthor={The ATLAS Collaboration}}

%-------------------------------------------------------------------------------
% Content
%-------------------------------------------------------------------------------
\begin{document}

% Add a front cover image here
% \includepdf{file1.pdf}

\frontmatter
\maketitle

% \pagenumbering{roman}
\tableofcontents

% List of to-do notes
% \listoftodos

\clearpage
\mainmatter
% \pagenumbering{arabic}
%===============================================================================
\chapter{Executive summary}
%===============================================================================

%===============================================================================
\part{Motivation}
%===============================================================================

Put the motivation here ...

The ATLAS detector~\cite{PERF-2007-01} should be upgraded.


%===============================================================================
\chapter{Physics}
%===============================================================================

%===============================================================================
\part{Implementation}
%===============================================================================

%===============================================================================
\chapter{Plan}
%===============================================================================

Put the description of the plan here.

%===============================================================================
\chapter{Finances}
%===============================================================================

Put the costs here.

\clearpage
%-------------------------------------------------------------------------------
\section*{Acknowledgements}
%-------------------------------------------------------------------------------

%\input{acknowledgements/Acknowledgements}

The \texttt{atlaslatex} package contains the acknowledgements that were valid 
at the time of the release you are using.
These can be found in the \texttt{acknowledgements} subdirectory.
When your ATLAS paper or PUB/CONF note is ready to be published,
download the latest set of acknowledgements from:\\
\url{https://twiki.cern.ch/twiki/bin/view/AtlasProtected/PubComAcknowledgements}


%-------------------------------------------------------------------------------
\clearpage
\appendix
\part*{Appendix}
\addcontentsline{toc}{part}{Appendix}
%-------------------------------------------------------------------------------

In a document, an appendix is used for technical details that would otherwise disturb the flow.
Such an appendix should be printed before the Bibliography.


%-------------------------------------------------------------------------------
% Print the bibliography.
\printbibliography
%-------------------------------------------------------------------------------

%-------------------------------------------------------------------------------
\backmatter

% Lists of figures and tables - useful at the draft stage
\listoffigures
\listoftables

% Add a back cover image here - make sure it is on the back side of a new sheet
% \cleardoublepage
% \pagestyle{empty}
% \mbox{}
% \newpage
% \includepdf{file2.pdf}

\end{document}
