% usage.tex % % This file explains how to use the withesis style % it is heavily modelled after a similar chapter by McCauley % for the Purdue Thesis style % % Eric Benedict, May 2000 % % It is provided without warranty on an AS IS basis. \chapter{Using the {\tt withesis} Style} You can get a copy of the \LaTeX{} style for creating a University of Wisconsin--Madison thesis or dissertation from: {\tt http://www.cae.wisc.edu/\verb+~+benedict/LaTeX.html} After somehow unpacking it, you will have the style files ({\tt withesis.sty} {\tt withe10.sty}, and {\tt withe12.sty}) as well the files used to create this document. The files used for this document can be copied and used as a template for your own thesis or dissertation. The final printed form of this document is useful, but the combination of the source code and final copy form a much more valuable reference. Keeping a working copy of the this document can be helpful when you are later working on your thesis or disseration and want to know how to do something. If you find a similar example in this document, then you can simply look at the corresponding source code and add it to your document. Because many parts of this document were written by different people, the styles and techniques are also different and provide different ways of achieving the same or similar results. Because of the typical size of theses, it makes sense to break the document up into several smaller files. Usually this is done at the chapter level. These files can then be {\tt \verb|\include|}d in a {\em root} file. It is the {\em root} file that you will run \LaTeX{} on. For this manual, the root file is called {\tt main.tex}. \section{The Root File and the Preamble} The {\tt \verb|\documentclass|} command is used to tell \LaTeX{} that you will be using the {\tt withesis} document class and it is the first command in your root file. Class options such as {\tt 10pt}, {\tt 12pt}, {\tt msthesis} or {\tt margincheck} are specified here: {\tt \verb|\documentclass[12pt,msthesis]{withesis}|} The class option {\tt msthesis} sets the margins to be appropriate for depositing with the UW library, namely a 1.25 inch left margin with the remaining margins 1 inch. The defaults for the title page are also defined for a thesis and for a Master of Science degree. The class option {\tt margincheck} will place a small black square at the end of each line which exceeds the margins.\footnote{In reality, the square is placed at the end of lines which exceed their {\tt \char92hbox}. This usually (but not always) indicates a margin violation on the right margin. Left margin violations aren't indicated and if the margin violation is large enough, there isn't room for the black box to be visiable.} This is visible both in the {\tt .dvi} file as well as in the {\tt .ps} file. The area immediately following this command is called the {\em preamble} and is used for things like including different style packages, defining new macros and declaring the page style. The style packages can be used to easily change the thesis font. For example, this document is set in Times Roman instead of the \LaTeX default of Computer Modern. This change was performed by including the {\tt times} package: {\tt\verb|\usepackage{times}|}\footnote{In this document, the typewriter font {\tt $\backslash$tt} was redefined to use the Computer Modern font with the command {\tt $\backslash$renewcommand\{$\backslash$ttdefault\}\{cmtt\}}. For more information, see~\cite{goossens}.} Remember that if you change the fonts from the default Computer Modern to PostScript ({\em e.g.} Times Roman) then in order to correctly see the document, you will need to convert the {\tt *.dvi} output into a {\tt *.ps} file and view the document with a PostScript viewer. This is required since most {\tt *.dvi} previewer programs cannot display PostScript fonts. Usually, the previewer will substitute default fonts so the document may be viewed; however, since the alternate fonts may not be the same size, the formatting of the document may appear to be incorrect. The style package for including Postscript figures, {\tt epsfig}, is included with {\tt\verb|\usepackage{epsfig}|} If multiple style packages are required, then they can be combined into one statement as follows: {\tt\verb|\usepackage{epsfig,times}|} Many different style packages are available. For more information, see~\cite{goossens}. The page styles are defined using a similar method. A special style is defined for the {\tt withesis} style: {\tt\verb|\pagestyle{thesisdraft}|} This style causes the footer text to become: {\verb| DRAFT: Do Not Distribute