CD-1 Preparation

Get git and get oriented...

If you plan to access the git repository, you will need to install git and get a GitHub account. There are several sources for downloading the application, e.g., github,git-scm.com, or codeplex. Comprehensive guidance on the use of git and LaTeX is available at
https://github.com/DUNE/document-guidance
A quick reference is on the right-hand side of this page.
PLEASE take the 20 minutes or so up front that it requires to read through the:
Guidance, Getting Started and other sections of information on the GitHub page
Standards pages linked at left
Then clone the repository and read through the document-guidance tex and pdf files.

IT WILL SAVE HEADACHES LATER!!

Contacts

Anne Heavey (aheavey@fnal.gov, 630-840-8039) is the technical editor for the CDR volumes and may assist with the CERN prototype document. The scientific editors are still TBD.

Brett Viren (bv@bnl.gov) has set up the git repository on GitHub and put some LaTeX "machinery" in place so that it's easy to use and provides consistency. He is also available to help with LaTeX editing problems.

Documents and Repositories

The Physics and DUNE Detector volumes of the 2015 CDR are being done in LaTeX. This is also true for the annex documents on LBNE FD, ND and Cryo info that is undergoing updates, and for the CERN Prototype Proposal.
The files for these volumes are being kept in GitHub repositories
under https://github.com/DUNE

Document guidance: https://github.com/DUNE/document-guidance -- info on the web page and in the LaTeX source/PDF
CDR 2015 physics and detectors volumes + ND & Cryo annexes: https://github.com/DUNE/cdr.
FD annex (update to 2012 LBNE FD): https://github.com/DUNE/lbne-fd-closeout
CERN Prototype Proposal

We're documenting LaTeX questions and issues here: LaTeX-hints. This includes migrating from the LBNE repository to the DUNE one.

For LaTeX-challenged contributors:

If you prefer to work in Word, please contact Anne to receive a docx file with the existing content that you need to update.
Please read and follow the graphics guidelines
Upload your files to the Contributions Library

Helpful Links:

TeX Users Group (Fermilab has an institutional membership)
LaTex Guide (wikibooks)
GitHub instructions: Working with Repositories
git repository cheat sheet (PDF)
Git Reference
CDR Contributions document library

Quick References

---- Git ----

Install git (https://github.com/).
Clone repository (See "Initial Clone" in instructions)
General editing procedure

cd to directory into which you cloned document
git pull
(Edit files. Then test that document compiles.)
pdflatex volume-x
(Fix editing errors and retry until it compiles.)
git pull (yes, again, for good measure)
(If you have new files, add them.)
git add volume-x/new-file.tex
git add volume-x/figures/new-image-file.pdf
git commit -a -m "some commit message"
git push

If git pull fails:

git stash
git pull
git stash pop
(Fix conflicts, commit and push.)

---- Figures in LaTeX ----

There’s an enviroment defined as cdrfigure, and all you need to do for a figure in your file is fill in the following with the short caption, the label (minus “fig:” at the front), the long caption and then the filename with the appropriate width.

\begin{cdrfigure}[short]{label}{long}
\includegraphics[width=0.8\textwidth]{file}
\end{cdrfigure}

The reference that points to it needs to read Figure~\ref{fig:label} (i.e., with the fig:)

---- Tables in LaTeX ----

For tables, it’s similar:

\begin{cdrtable}[short]{cc}{label}{long}
Header Column1 & Header Column 2 \\ \toprowrule
Row 1 & First \\ \colhline
Row 2 & Second \\ \colhline
Row 3 & Third \\
\end{cdrtable}

The third argument (reads {cc}) can use c, l, r, p{some length} but please do not include lines like “|c|l|l|”.

LaTeX // <![CDATA[ _spBodyOnLoadFunctionNames.push("setupPageDescriptionCallout"); // ]]>