# Book Class: Instructor's Guide [closed]

I am currently an undergraduate student finishing my bachelor's in mathematics. For my Complex Analysis course, my instructor personally chose me to create an Instructor's Guide for the course. The professor wants me to create the guide using a Book Document Class on LaTex.

I only have about five months of experience with LaTex. Most of the document classes I have worked with are articles and beamers.

The Instructor's Guide is like a mini book you can say. Every topic in lecture will be a chapter. Like a book, I will need a preface, table of contents, a glossary, etc. The professor told me I could actually have the chapters on a separate tex. document and just import them to my "master" file. Since I am still fairly new to LaTex, I was hoping someone could help me into the right direction: whether it be on what usepackages I should use, or suggestions about the layout of the Guides.

-

## closed as too broad by Jubobs, ChrisS, Claudio Fiandrino, Guido, Martin SchröderFeb 11 '14 at 7:31

There are either too many possible answers, or good answers would be too long for this format. Please add details to narrow the answer set or to isolate an issue that can be answered in a few paragraphs. If this question can be reworded to fit the rules in the help center, please edit the question.

I started with Lyx. I am now on to LaTeX on Texmaker, but I think Lyx is very nice to start with. You can then export the LaTeX and learn about the insides of it. –  olga.saucedo Feb 11 '14 at 3:01
Welcome to TeX SE. Your question is really too big to ask like this. It would be better to think through what you need to know and then ask a more narrowly-focused question or several questions. It isn't clear to me, for example, how far you have got or if you have actually tried to start yourself at all. That said, I guess amsbook might be an obvious choice for a maths course. The glossaries package can help with glossaries and the other thing you mention come pretty much included unless you want something special. Use \include{} to include your chapters. –  cfr Feb 11 '14 at 3:01
I have thus far created two chapters for the instructor's guide using an article class. Each chapter is on a separate tex document. I am creating the glossary as I go along throughout the course. I have a separate document with a list of references as well. Thus far I am only a week into the course. Progress thus far is on schedule. –  Kevin_H Feb 11 '14 at 3:08
May be useful: How can I selectively paginate my Master's Thesis? –  Harish Kumar Feb 11 '14 at 4:11

There are quite a few things that you can do to make this project go smoothly- of course, there is bound to be a learning curve of some kind, so take what I say here as for what it's worth :)

# The basics

One of the main things to remember when constructing a medium-to-big document like you describe is to emphasize content over form. As your professor says, you should probably have a main file, say main.tex which uses \include to incorporate each of your chapter files; during construction, you should make judicious use of the includeonly command to compile small portions of the document to increase your efficiency. A skeleton of this file might look like:

main.tex

\documentclass{book}

\includeonly{zebras}

\begin{document}

\include{zebras}
\include{lions}

\end{document}


All of the page settings, including margins, headers/footers, numbering schemes, spacing should all be controlled in this document.

Each of the chapter files should only contain content, such as

zebras.tex

\chapter{chapter heading}
\begin{example}
...
\end{example}
...


# Customizing elements

You'll want to use packages to customize the various elements of your document, which include (but not limited to):

You'll almost certainly want to create your own environments- perhaps examples, theorems, lemmas, etc. There are many packages that can help with this, which include (but are not limited) to:

If you want framed theorem-like environments, then you can use:

In this day and age, you can draw almost any picture that you want to in LaTeX; the two main packages in use today (and you'll see them a lot) on this site are tikz and pstricks; the asymptote package has an increasing presence.

All of these packages should be loaded and tweaked in your main.tex; remember that zebras.tex and lions.tex should only contain content.

# Cross referencing

LaTeX's cross referencing system has always been incredibly robust; we are lucky enough to live in an age of the varioref, hyperref and cleveref packages.

For example, instead of always having to type Figure \ref{fig:bernoulli}, you can simply type \cref{fig:bernoulli}. For figures and objects that are 'far away', you can write \vref{fig:bernoulli} which may produce, Figure 2.1 on page . You need a little care to load them in the correct order, which is

\usepackage{varioref}
\usepackage{hyperref}
\usepackage{cleveref}


While we're speaking of referencing, it's an excellent idea to use meaningful labels such as \label{fig:bernoulli} as discussed in What is the advantage of using the notation 'fig:' in the \label {}?.

# Useful tools

There are a lot of tools that can help with automation- personally I consider arara the front runner; you set up directives in your document such as

% arara: pdflatex
% arara: makeglossaries
% arara: pdflatex
\documentclass{book}

\includeonly{zebras}

\begin{document}

\include{zebras}
\include{lions}

\end{document}


which will be very useful if/when you incorporate the glossaries package.

It is well worth taking the effort to learn how to use a Version Control System such as git; it may seem like an extra layer that may not seem strictly necessary, but even simple use of such a tool can make a world of difference in work flow.