diff options
author | Karl Berry <karl@freefriends.org> | 2008-09-20 00:34:07 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2008-09-20 00:34:07 +0000 |
commit | 4be602aabb747be11a542f7d567a76e126ecef88 (patch) | |
tree | 892b8be9aeaedc1ed43f9be13964f69b8290fde5 /Master/texmf-dist/doc/latex/psu-thesis | |
parent | 89d1e010eb673d8f40f47b75386c3027bb328dfa (diff) |
new latex package psu-thesis (17sep08)
git-svn-id: svn://tug.org/texlive/trunk@10647 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/psu-thesis')
-rw-r--r-- | Master/texmf-dist/doc/latex/psu-thesis/README | 414 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/psu-thesis/manual.pdf | bin | 0 -> 93709 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/psu-thesis/manual.tex | 426 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/psu-thesis/mssample.pdf | bin | 0 -> 103509 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/psu-thesis/mssample.tex | 180 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/psu-thesis/phdsample.pdf | bin | 0 -> 94925 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/psu-thesis/phdsample.tex | 185 |
7 files changed, 1205 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/psu-thesis/README b/Master/texmf-dist/doc/latex/psu-thesis/README new file mode 100644 index 00000000000..ec7ce0db361 --- /dev/null +++ b/Master/texmf-dist/doc/latex/psu-thesis/README @@ -0,0 +1,414 @@ + psu-thesis.sty + Copyright 2008 Matt Floros + +This work may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either version 1.3 +of this license or (at your option) any later version. +The latest version of this license is in + http://www.latex-project.org/lppl.txt +and version 1.3 or later is part of all distributions of LaTeX +version 2005/12/01 or later. + +This work has the LPPL maintenance status `maintained'. + +The Current Maintainer of this work is Matt Floros. + +This work consists of the files psuthesis.sty and psuthesis.bst + +-------------------------------------------------------------------------------- + +Manual for psu-thesis LATEX Style File +Matthew W. Floros +September 17, 2008 + + +Included Files + +manual.tex +manual.pdf +psu-thesis.sty +psu-thesis.bst +mssample.tex +mssample.pdf +phdsample.tex +phdsample.pdf + + +Introduction + +The origin of this style file came directly from my horrible experience trying +to write a technical Master's thesis using "a popular word processor." It was at +that time that I decided that it would be best to bite the bullet and simply +learn TEX and not have to deal with that nightmare again for my PhD thesis. + +Unfortunately, at the time I was writing my Ph.D. thesis, Penn State did not +provide any support for TEX users. Although there were several style files +floating around different departments, they seemed to me as a novice user to +require quite a bit of effort to use them. The style file itself had to be +changed, i.e. lines commented out or uncommented, and there was no +documentation. My goal was to merge together parts of various style files and +make a single package whose features could all be accessed through issuing +simple LATEX commands in the document rather than editing the style file itself. + +I received my PhD in December of 2000 and did the development work on this +package then. I wrote most of this documentation in 2002 and then came back to +it in 2008 when I realized I could upload it to CTAN and make it available to +other people. A fair amount of work went into it and I thought others could +benefit. As of 2000, the Penn State Thesis Office had no interest in having +anything to do with a LATEX style file and only maintained templates for +"popular word processors." I'm sure they still feel the same way. + +Note that I have not reviewed the thesis guidelines since 2000 and they may have +changed. When I submitted my thesis in 2000, it passed Thesis Office scrutiny +using this package. The committee page was contributed from a 2004 thesis, and +incorporated "as-is," with appropriate logic to include it or not. + +There are few guidelines for the main body of the thesis, so nearly all of the +provided commands can be classified as either front matter or back matter. These +commands are used to set up the title page, abstract, appendices, and so forth. +There are some commands which do not fall into these two categories which are +provided at the end. A summary of the commands is provided below. + +Note that the setspace package is a separate LATEX package, not something +developed at PSU. It is a required package because the line spacing and some of +the commands in the psu-thesis style file rely on commands in the setspace style +file. + +To include the style file (and bibliographic style file psuthesis.bst) in your +thesis document, simply issue the command \usepackage{psu-thesis} in the +preamble after the documentclass command and \usepackage{doublespace} command +since many of the psu-thesis commands rely on the doublespace package. It is +also intended to be used with the report document class: + +\documentclass[dvips,11pt,twoside]{report} +\usepackage{doublespace} +\usepackage{psu-thesis} +\bibliographystyle{psuthesis} + +The package was set up with both one-sided and two-sided printing in mind, so +the optional arguments oneside and twoside to the report document class can be +used and the macros provided in this package will adapt accordingly. + + +Package Options + +The following options are available: + +master +doctor +signature +draft + +The first two package options, master and doctor are available which set +defaults for those thesis types: + +master doctor +-------------------------------------------------------------------------------- +Set degree to "Master of Science" Set degree to "Doctor of Philosophy" +Permission to Copy Page Committee Page +List of Tables List of Tables +List of Figures List of Figures + +The signature option will include the signature page, which has since been +supplanted by the committee page. The \includesignature command in the preamble +produces the same effect. + +The draft option is useful for version control of drafts of your thesis while it +is being written. It produces a box with the date the document was produced at +the top of every page, + ++-------------------------------------+ +|Draft: June 26, 2008 at 1:32 am | ++-------------------------------------+ + +You can also place the \draft command in the preamble to activate this feature. + + +Front Matter + +Most of the commands provided are related to the front matter. Commands can be +divided into three groups, commands which set information for the title page, +commands to set up the signature page, and commands to include and format the +other front matter items. + +The front matter definition commands can be issued either in the preamble or +within the document itself. The only command that is required to appear within +the document is the \makefrontmatter command which generates and outputs all of +the frontmatter material based on the other commands issued. Of course if the +commands to create the front matter parts are not in the preamble, they must +appear before the \makefrontmatter command. + + +Title Page Information + +A variety of general information is required for the style file to format the +title page, signature page, and so forth. These commands to input the +information are straightforward. The appropriate information is simply the +argument of the command: + +\title{} thesis title (it should be in all caps; this is not automatic) +\author{} thesis author \dept{} academic department in which thesis is earned +\college{} college the above department belongs to \submitdate{} month and year +of submission/publication of thesis \copyrightyear{} year of publication of +thesis (for title and copyright pages) \degree{} degree being obtained, e.g. +"Doctor of Philosophy" + +The thesis type is set to produce "A Thesis in..." by default but can be changed +to "A Thesis Proposal in..." with the \proposal command or "A Dissertation in" +with the \dissertation command. + +Additionally, the \includecopyrightline command will include a copyright line on +the title page using the copyright year and author information supplied. +Alternatively, the command \includecopyrightpage will cause a separate copyright +page to be output immediately following the title page. Both the title page line +and separate page can be included, but only one is recommended. + + +Signature/Committee Page Information + +The signature and committee pages can be set up with up to six thesis readers +using the \includesignature and \includecommittee commands, respectively. A +suite of commands are included to aid in the formatting of the signature and +committee pages. Headings and spacing are set automatically. The author +information is taken from the \author{} command above. Each reader is added with +a consecutive command, i.e. + +\firstreader{}{} +\secondreader{}{} +\thirdreader{}{} +\fourthreader{}{} +\fifthreader{}{} +\sixthreader{}{} + +Each reader command requires two arguments. The first is the reader's name, +and the second is the title and affiliation of that reader, for example +\firstreader{Isaac Newton}{Professor of Mathematics} would produce + + +------------------------------------------------ ------------------- +Isaac Newton +Professor of Mathematics + +for the signature page and similar without the lines for the committee page. The +signature page is optional, and can be included with \includesignature in the +preamble or the signature package option. It is not numbered, so it can be bound +with the author's personal copy and the page numbers will not differ from the +reference copy. + +Several macros have been defined to format the reader affiliations. First, +macros are defined to identify the professor as assistant, associate, or full +professor: + +\assistprof{} +\assocprof{} +\prof{} + +Additionally, the macro head{} is defined to identify that the reader is the +head of the department. The Thesis Office likes to see both \prof{} and \head{} +for department heads. Macros are provided for additional information as follows: + +Macro Command Text Produced +------------- ------------- +\adviser Thesis Adviser +\coadviser Thesis Co-Adviser +\chair Chair of Committee +\cochair Co-Chair of Committee +\adviserchair Thesis Adviser, Chair of Committee +\coadviserchair Thesis Co-Adviser, Co-Chair of Committee + +These macros are not necessarily of much value since it is nearly as easy to +simply type the appropriate information into the document rather than using the +macros, but several style files I came across contained such shortcuts, so they +were retained in this package. + +For example, either + +\secondreader{Isaac Newton}{\prof{Mathematics}\head{Mathematics} +\adviserchair} + +or + +\secondreader{Isaac Newton}{Professor of Physics \\ +Head of Department of Physics \\ +Thesis Adviser, Chair of Committee} + +would produce + +------------------------------------------------ ------------------- +Isaac Newton +Professor of Physics +Head of Department of Physics +Thesis Adviser, Chair of Committee + + +Permission to Copy Page + +The permission to copy page is produced with the \includepermission command. The +name is taken from the \author entry. No other input is required since the +required text is given in the thesis guide. + + +List of Symbols + +Three macros are included for the List of Symbols. The first, +\listofsymbols[width]{}, causes the List of Symbols to be included in the +frontmatter. The List of Symbols itself is the required argument, which can of +course be entered directly or in a separate file and accessed with an \input or +similar command. + +The second macro is to aid in generating the symbol list and takes the form + +\symbolentry{symbol}{definition} + +The command outputs the symbol and definition in two columns. The definition +column is in paragraph form, so manual line breaking is not necessary. The width +of the symbol column is set by the optional argument [width] in the +\listofsymbols[width]{} command. The default is 1 inch. The definition column +will be the remainder of the page, i.e. \textwidth-width. To change the width in +the middle of the list of symbols, use the command \setsymwidth{width}. It +redefines the symbol width and automatically adjusts the description width to +the remainder of the page. + +By default, the first argument is output in math mode, but plain text symbols +can be created with \mbox{}. For example, \symbolentry{g}{Acceleration due to +Gravity} produces + + +g Acceleration due to gravity + + +Unformatted Front Matter Pages + +The remaining frontmatter pages do not include any formatting, hence commands +are provided for the sole purpose of determining whether to include each page or +not, and placing them in the correct order. They can be defined in any order but +will appear in a specific order when the document is processed. These front +matter items can be included are in two groups, commands which merely include +the associated item, and commands which include the item and define its +contents. The items will be output in the following order if the corresponding +command is present: + +Macro Command Front Matter Item + +\includecopyrightpage Copyright Page +\includepermission Permission to Copy Page (For MS Theses) +\includesignature Signature Page (For PhD Theses) +\includecommittee Committee Page (For PhD Theses) +\dedicationtext{content} Dedication +\abstracttext{content} Abstract + (Table of Contents) +\includelistoffigures List of Figures +\includelistoftables List of Tables +\listofsymbols[wid]{content} List of Symbols +\dedicationtext{content} Dedication +\prefacetext{content} Preface +\acknowltext{content} Acknowledgements +\epigraphtext{content} Epigraph +\frontispiece{content} Frontispiece + +For my thesis the content for each of these was an \include command to include a +separate file, but you can put your actual content in the braces if you like. + + +Back Matter + +There is considerably less back matter than front matter, but unfortunately, the +thesis office wants some of the items to appear differently than the LATEX +defaults. The following macros are provided to format the back matter items to +the thesis office standards. + + +Appendices + +Two commands are provided for inclusion of appendices, \singleappendix and +\appendices. The reason for these is that the thesis office wants a single +appendix to be called "Appendix" and LATEX treats it as a chapter and by default +if the \appendix command was issued, would call it "Appendix A" and would put +"A" in the table of contents. The provided macros \singleappendix and +\appendices format the appendix/appendices to be called "Appendix" in both the +text and the table of contents in the case of a single appendix and have the +letters prefaced by the word "Appendix" in the table of contents in the case of +multiple appendices. + +The appropriate command should be issued, followed by a \chapter command to +provide a title for the appendix, + +\singleappendix \chapter{Appendix name} <text of appendix> + +or + +\appendices \chapter{First appendix name} <text of appendix> +\chapter{Second appendix name} <text of appendix> + +etc. + + +Bibliography Entry + +Unfortunately, the bibliography is also not included in the table of contents by +default. A command is provided to include the bibliography in the table of +contents and single space the list of references. The command is +\includebibliography{}. Unlike the other "include" commands, the +\includebibliography{} command takes an argument which is the bibliography +itself. This is for single space formatting. Simply include the bibliographic +entries as its argument to print out the bibliography. Using LATEX features is +fine, so the command would likely be + +\includebibliography{\bibliography{refs}} + +if BibTEX is used. The psuthesis.bst style file is included for producing a +bibliography with BibTEX. + + +Vita + +A command \vita{} is provided to include a vita/curriculum vitae at the end of +the thesis. It is not required by the thesis office, but many like to include +it. The argument is the vita itself, most likely an \input{} or \include command +linking to a file containing the vita. The macro provides a clean page and the +author name from the front matter. + + +UMI Abstract + +The UMI Abstract is required by the thesis office for PhD theses. UMI keeps your +thesis on file and if you read the fine print, keeps your royalties unless a lot +of people request your thesis in a given year. The UMI abstract is not bound +with the thesis, but it can be placed at the end so a whole separate document is +not required. The command \UMIabstract{} formats the specific header required by +UMI using information from the front matter and includes the abstract supplied +as the argument. The UMI abstract has a word limit (consult the thesis guide for +details), but if the thesis abstract falls within the word limit it can be the +same for both. The abstract is printed without a page number since it is not +bound with the thesis. + + +Numbering by Chapter + +The \numberbychapter command changes the numbering scheme for figures, tables, +and equations to follow the chapters so that they are numbered 1.1, 1.2, 1.3, +... in the first chapter, and 2.1, 2.2, 2.3, ... in the second chapter and so +forth. This command should always be included to follow thesis office +guidelines. Include it in the preamble to activate. + + +Other notes + +There may be other commands hiding in the style file that are not documented +here. These instructions and the sample files were thrown together to try to +make the package usable without people tracking down my email address and asking +me about them. The mssample and phdsample files are provided to show how many of +the features work in for MS and PhD theses. Feel free to look through the .sty +file itself and discover commands I forgot to document in these instructions. If +you know enough about TEX and LATEX to be using them to write a thesis, you can +figure it out. + +Finally, I put together much of the style file by piecing together parts of +other style files that I picked up from various people. Some of the macros +identify who wrote them, and I preserved the original author information if +present, even if I modified the macros. So if there is some piece of code in the +style file that you wrote but isn't credited to you, thank you for your +contribution and it wasn't me who took your name out. + +I hope you find the package helpful, if so, please tell the Thesis Office they +should support LATEX and/or tell your friends about this macro package. diff --git a/Master/texmf-dist/doc/latex/psu-thesis/manual.pdf b/Master/texmf-dist/doc/latex/psu-thesis/manual.pdf Binary files differnew file mode 100644 index 00000000000..dcbb462254e --- /dev/null +++ b/Master/texmf-dist/doc/latex/psu-thesis/manual.pdf diff --git a/Master/texmf-dist/doc/latex/psu-thesis/manual.tex b/Master/texmf-dist/doc/latex/psu-thesis/manual.tex new file mode 100644 index 00000000000..aee18ea39b9 --- /dev/null +++ b/Master/texmf-dist/doc/latex/psu-thesis/manual.tex @@ -0,0 +1,426 @@ +\documentclass[11pt]{article} +\usepackage{psu-thesis} +\usepackage{texnames} % only needed for \BibTeX macro +\setlength{\paperwidth}{8.5in} \setlength{\paperheight}{11in} +\setlength{\textwidth}{6.5in} \setlength{\textheight}{8.5in} +\setlength{\topmargin}{0in} \setlength{\oddsidemargin}{0in} +\setlength{\evensidemargin}{0in} +\begin{document} +\begin{singlespace} +\title{Manual for psu-thesis \LaTeX\ Style File} +\author{Matthew W. Floros} +\date{September 17, 2008} +\maketitle +\section*{Included Files} +\begin{verbatim} +manual.tex +manual.pdf +psu-thesis.sty +psu-thesis.bst +mssample.tex +mssample.pdf +phdsample.tex +phdsample.pdf +\end{verbatim} + +\section*{Introduction} + +The origin of this style file came directly from my horrible experience trying +to write a technical Master's thesis using ``a popular word processor.'' It +was at that time that I decided that it would be best to bite the bullet +and simply learn \TeX\ and not have to deal with that nightmare again for my +PhD thesis. + +Unfortunately, at the time I was writing my Ph.D. thesis, Penn State did not +provide any support for \TeX\ users. Although there were several style files +floating around different departments, they seemed to me as a novice user to +require quite a bit of effort to use them. The style file itself had to be +changed, i.e. lines commented out or uncommented, and there was no +documentation. My goal was to merge together parts of various style files and +make a single package whose features could all be accessed through issuing +simple \LaTeX\ commands in the document rather than editing the style file +itself. + +I received my PhD in December of 2000 and did the development work on this +package then. I wrote most of this documentation in 2002 and then came back to +it in 2008 when I realized I could upload it to CTAN and make it available to +other people. A fair amount of work went into it and I thought others could +benefit. As of 2000, the Penn State Thesis Office had no interest in +having anything to do with a \LaTeX\ style file and only maintained templates +for ``popular word processors.'' I'm sure they still feel the same way. + +{\bfseries Note that I have not reviewed the thesis guidelines since 2000 and +they may have changed. When I submitted my thesis in 2000, it passed Thesis +Office scrutiny using this package. The committee page was contributed from a +2004 thesis, and incorporated ``as-is,'' with appropriate logic to include it or +not.} + +There are few guidelines for the main body of the thesis, so nearly all of the +provided commands can be classified as either front matter or back matter. +These commands are used to set up the title page, abstract, appendices, and so +forth. There are some commands which do not fall into these two categories +which are provided at the end. A summary of the commands is provided below. + +Note that the setspace package is a separate \LaTeX package, not something +developed at PSU. It is a required package because the line spacing and some of +the commands in the psu-thesis style file rely on commands in the setspace style +file. + +To include the style file (and bibliographic style file psuthesis.bst) in your +thesis document, simply issue the command \verb+\usepackage{psu-thesis}+ in the +preamble \emph{after} the \verb+documentclass+ command and +\verb+\usepackage{doublespace}+ command since many of the psu-thesis commands +rely on the doublespace package. It is also intended to be used with the +\verb+report+ document class: + +\begin{verbatim} +\documentclass[dvips,11pt,twoside]{report} +\usepackage{doublespace} +\usepackage{psu-thesis} +\bibliographystyle{psuthesis} +\end{verbatim} + +The package was set up with both one-sided and two-sided printing in mind, so +the optional arguments \verb+oneside+ and \verb+twoside+ to the report document +class can be used and the macros provided in this package will adapt +accordingly. + +\section*{Package Options} + +The following options are available: +\begin{verbatim} +master +doctor +signature +draft +\end{verbatim} + +The first two package options, \verb+master+ and \verb+doctor+ are available +which set defaults for those thesis types: + +\begin{tabular}{ll} +\verb+master+ & \verb+doctor+ \\ \hline +Set degree to ``Master of Science'' & Set degree to ``Doctor of Philosophy'' \\ +Permission to Copy Page & Committee Page \\ +List of Tables & List of Tables \\ +List of Figures & List of Figures +\end{tabular} + +The \verb+signature+ option will include the signature page, which has since +been supplanted by the committee page. The \verb+\includesignature+ command in +the preamble produces the same effect. + +The \verb+draft+ option is useful for version control of drafts of your +thesis while it is being written. It produces a box with the date the document +was produced at the top of every page, + +\noindent\usebox{\draftbox} + +You can also place the \verb+\draft+ command in the preamble to activate this +feature. + +\section*{Front Matter} + +Most of the commands provided are related to the front matter. Commands can be +divided into three groups, commands which set information for the title page, +commands to set up the signature page, and commands to include and format the +other front matter items. + +The front matter definition commands can be issued either in the preamble or +within the document itself. The only command that is required to appear within +the document is the \verb+\makefrontmatter+ command which generates and outputs +all of the frontmatter material based on the other commands issued. Of course +if the commands to create the front matter parts are not in the preamble, they +must appear \emph{before} the \verb+\makefrontmatter+ command. + +\subsection*{Title Page Information} + +A variety of general information is required for the style file to format the +title page, signature page, and so forth. These commands to input the +information are straightforward. The appropriate information is simply the +argument of the command: + +\begin{tabular}{ll} +\verb+\title{}+ & thesis title (it should be in all caps; this is not automatic)\\ +\verb+\author{}+ & thesis author \\ +\verb+\dept{}+ & academic department in which thesis is earned \\ +\verb+\college{}+ & college the above department belongs to \\ +\verb+\submitdate{}+ & month and year of submission/publication of thesis \\ +\verb+\copyrightyear{}+ & year of publication of thesis (for title and copyright +pages) \\ +\verb+\degree{}+ & degree being obtained, e.g. ``Doctor of Philosophy'' +\end{tabular} + +The thesis type is set to produce ``A Thesis in...'' by default but can be +changed to ``A Thesis Proposal in...'' with the \verb+\proposal+ command or ``A +Dissertation in'' with the \verb+\dissertation+ command. + +Additionally, the \verb+\includecopyrightline+ command will include a copyright +line on the title page using the copyright year and author information supplied. +Alternatively, the command \verb+\includecopyrightpage+ will cause a separate +copyright page to be output immediately following the title page. Both the +title page line and separate page can be included, but only one is recommended. + +\subsection*{Signature/Committee Page Information} + +The signature and committee pages can be set up with up to six thesis readers +using the \verb+\includesignature+ and \verb+\includecommittee+ commands, +respectively. A suite of commands are included to aid in the formatting of the +signature and committee pages. Headings and spacing are set automatically. The +author information is taken from the \verb+\author{}+ command above. Each +reader is added with a consecutive command, i.e. + +\begin{verbatim} +\firstreader{}{} +\secondreader{}{} +\thirdreader{}{} +\fourthreader{}{} +\fifthreader{}{} +\sixthreader{}{} +\end{verbatim} + +Each reader command requires two arguments. The first is the reader's name, and +the second is the title and affiliation of that reader, for example + +\noindent\verb+\firstreader{Isaac Newton}{Professor of Mathematics}+ + +\noindent would produce \vspace{0.25in} + +\signature{Isaac Newton \\ Professor of Mathematics \\} + +\vspace{0.25in} + +\noindent for the signature page and similar without the lines for the committee +page. The signature page is optional, and can be included with +\verb+\includesignature+ in the preamble or the \verb+signature+ package option. +It is not numbered, so it can be bound with the author's personal copy and the +page numbers will not differ from the reference copy. + +Several macros have been defined to format the reader affiliations. First, +macros are defined to identify the professor as assistant, associate, or full +professor: +\begin{verbatim} +\assistprof{} +\assocprof{} +\prof{} +\end{verbatim} +\noindent Additionally, the macro \verb+head{}+ is defined to identify that the +reader is the head of the department. The Thesis Office likes to see both +\verb+\prof{}+ and \verb+\head{}+ for department heads. + +Macros are provided for additional information as follows: + +\begin{tabular}{ll} +Macro Command & Text Produced \\ \hline +\verb+\adviser+ & Thesis Adviser \\ +\verb+\coadviser+ & Thesis Co-Adviser \\ +\verb+\chair+ & Chair of Committee \\ +\verb+\cochair+ & Co-Chair of Committee \\ +\verb+\adviserchair+ & Thesis Adviser, Chair of Committee \\ +\verb+\coadviserchair+ & Thesis Co-Adviser, Co-Chair of Committee +\end{tabular} + +These macros are not necessarily of much value since it is nearly as easy to +simply type the appropriate information into the document rather than using the +macros, but several style files I came across contained such shortcuts, so they +were retained in this package. + +For example, either + +\begin{verbatim} +\secondreader{Isaac Newton}{\prof{Mathematics}\head{Mathematics} +\adviserchair} \end{verbatim} + +\noindent or + +\noindent\begin{verbatim} +\secondreader{Isaac Newton}{Professor of Physics \\ +Head of Department of Physics \\ Thesis Adviser, Chair of Committee} +\end{verbatim} + +\noindent would produce \vspace{0.25in} + +\signature{Isaac Newton \\ Professor of Physics \\ + Head of Department of Physics \\ Thesis Adviser, Chair of Committee} + +\vspace{0.25in} + + +\subsection*{Permission to Copy Page} + +The permission to copy page is produced with the \verb+\includepermission+ +command. The name is taken from the \verb+\author+ entry. No other input is +required since the required text is given in the thesis guide. + +\subsection*{List of Symbols} + +Three macros are included for the List of Symbols. The first, +\verb+\listofsymbols[width]{}+, causes the List of Symbols to be included in the +frontmatter. The List of Symbols itself is the required argument, which can of +course be entered directly or in a separate file and accessed with an +\verb+\input+ or similar command. + +The second macro is to aid in generating the symbol list and takes the form + +\noindent \verb+\symbolentry{symbol}{definition}+ + +The command outputs the symbol and definition in two columns. The definition +column is in paragraph form, so manual line breaking is not necessary. The +width of the symbol column is set by the optional argument \verb+[width]+ in +the \verb+\listofsymbols[width]{}+ command. The default is 1 inch. The +definition column will be the remainder of the page, i.e. +\verb+\textwidth-width+. To change the width in the middle of the list of +symbols, use the command \verb+\setsymwidth{width}+. It redefines the symbol +width and automatically adjusts the description width to the remainder of the +page. + +By default, the first argument is output in math mode, but plain +text symbols can be created with \verb+\mbox{}+. For example, +\verb+\symbolentry{g}{Acceleration due to Gravity}+ produces + +\symbolentry{g}{Acceleration due to gravity} + +\subsection*{Unformatted Front Matter Pages} + +The remaining frontmatter pages do not include any formatting, hence commands +are provided for the sole purpose of determining whether to include each page or +not, and placing them in the correct order. They can be defined in any order +but will appear in a specific order when the document is processed. These front +matter items can be included are in two groups, commands which merely include +the associated item, and commands which include the item and define its +contents. The items will be output in the following order if the corresponding +command is present: + +\begin{tabular}{ll} +Macro Command & Front Matter Item \\ \hline +\verb+\includecopyrightpage+ & Copyright Page \\ +\verb+\includepermission+ & Permission to Copy Page (For MS Theses) \\ +\verb+\includesignature+ & Signature Page (For PhD Theses) \\ +\verb+\includecommittee+ & Committee Page (For PhD Theses) \\ +\verb+\dedicationtext{content}+ & Dedication \\ +\verb+\abstracttext{content}+ & Abstract \\ +\multicolumn{2}{c}{(Table of Contents)} \\ +\verb+\includelistoffigures+ & List of Figures \\ +\verb+\includelistoftables+ & List of Tables \\ +\verb+\listofsymbols[wid]{content}+ & List of Symbols \\ +\verb+\dedicationtext{content}+ & Dedication \\ +\verb+\prefacetext{content}+ & Preface \\ +\verb+\acknowltext{content}+ & Acknowledgements \\ +\verb+\epigraphtext{content}+ & Epigraph \\ +\verb+\frontispiece{content}+ & Frontispiece +\end{tabular} +\vspace{12pt} + +For my thesis the content for each of these was an \verb+\include+ command to +include a separate file, but you can put your actual content in the braces if +you like. + +\section*{Back Matter} + +There is considerably less back matter than front matter, but unfortunately, the +thesis office wants some of the items to appear differently than the \LaTeX\ +defaults. The following macros are provided to format the back matter items +to the thesis office standards. + +\subsection*{Appendices} + +Two commands are provided for inclusion of appendices, \verb+\singleappendix+ +and \verb+\appendices+. The reason for these is that the thesis office wants a +single appendix to be called ``Appendix'' and \LaTeX\ treats it as a chapter and +by default if the \verb+\appendix+ command was issued, would call it ``Appendix +A'' and would put ``A'' in the table of contents. The provided macros +\verb+\singleappendix+ and \verb+\appendices+ format the appendix/appendices to +be called ``Appendix'' in both the text and the table of contents in the case of +a single appendix and have the letters prefaced by the word ``Appendix'' in the +table of contents in the case of multiple appendices. + +The appropriate command +should be issued, followed by a \verb+\chapter+ command to provide a title for +the appendix, + +\begin{verbatim} +\singleappendix \chapter{Appendix name} +<text of appendix> +\end{verbatim} + +\noindent or + +\begin{verbatim} +\appendices \chapter{First appendix name} +<text of appendix> + +\chapter{Second appendix name} +<text of appendix> +\end{verbatim} + +\noindent etc. + +\subsection*{Bibliography Entry} Unfortunately, the bibliography is also not +included in the table of contents by default. A command is provided to include +the bibliography in the table of contents and single space the list of +references. The command is \verb+\includebibliography{}+. Unlike the other +``include'' commands, the \verb+\includebibliography{}+ command takes an +argument which is the bibliography itself. This is for single space +formatting. Simply include the bibliographic entries as its argument to print +out the bibliography. Using \LaTeX features is fine, so the command would +likely be + +\noindent \verb+\includebibliography{\bibliography{refs}}+ + +\noindent if \BibTeX\ is used. The psuthesis.bst style file is included for +producing a bibliography with \BibTeX. + +\subsection*{Vita} + +A command \verb+\vita{}+ is provided to include a vita/\emph{curriculum vitae} +at the end of the thesis. It is not required by the thesis office, but many +like to include it. The argument is the vita itself, most likely an +\verb+\input{}+ or \verb+\include+ command linking to a file containing the +vita. The macro provides a clean page and the author name from the front +matter. + +\subsection*{UMI Abstract} + +The UMI Abstract is required by the thesis office for PhD theses. UMI keeps +your thesis on file and if you read the fine print, keeps your royalties unless +a lot of people request your thesis in a given year. The UMI abstract is not +bound with the thesis, but it can be placed at the end so a whole separate +document is not required. The command \verb+\UMIabstract{}+ formats the +specific header required by UMI using information from the front matter and +includes the abstract supplied as the argument. The UMI abstract has a word +limit (consult the thesis guide for details), but if the thesis abstract falls +within the word limit it can be the same for both. The abstract is printed +without a page number since it is not bound with the thesis. + +\section*{Numbering by Chapter} + +The \verb+\numberbychapter+ command changes the numbering scheme for figures, +tables, and equations to follow the chapters so that they are numbered 1.1, +1.2, 1.3, ... in the first chapter, and 2.1, 2.2, 2.3, ... in the second +chapter and so forth. This command should always be included to follow thesis +office guidelines. Include it in the preamble to activate. + + +\section*{Other notes} + +There may be other commands hiding in the style file that are not documented +here. These instructions and the sample files were thrown together to try to +make the package usable without people tracking down my email address and asking +me about them. The \verb+mssample+ and \verb+phdsample+ files are provided to +show how many of the features work in for MS and PhD theses. Feel free to look +through the .sty file itself and discover commands I forgot to document in these +instructions. If you know enough about \TeX\ and \LaTeX\ to be using them to +write a thesis, you can figure it out. + +Finally, I put together much of the style file by piecing together parts of +other style files that I picked up from various people. Some of the macros +identify who wrote them, and I preserved the original author information if +present, even if I modified the macros. So if there is some piece of code in +the style file that you wrote but isn't credited to you, thank you for your +contribution and it wasn't me who took your name out. + +I hope you find the package helpful, if so, please tell the Thesis Office they +should support \LaTeX\ and/or tell your friends about this macro package. + +\end{singlespace} +\end{document} diff --git a/Master/texmf-dist/doc/latex/psu-thesis/mssample.pdf b/Master/texmf-dist/doc/latex/psu-thesis/mssample.pdf Binary files differnew file mode 100644 index 00000000000..13683dec6bb --- /dev/null +++ b/Master/texmf-dist/doc/latex/psu-thesis/mssample.pdf diff --git a/Master/texmf-dist/doc/latex/psu-thesis/mssample.tex b/Master/texmf-dist/doc/latex/psu-thesis/mssample.tex new file mode 100644 index 00000000000..245e93d103d --- /dev/null +++ b/Master/texmf-dist/doc/latex/psu-thesis/mssample.tex @@ -0,0 +1,180 @@ +\documentclass[dvips,11pt,twoside]{report} +\usepackage[master]{psu-thesis} +\bibliographystyle{psuthesis} +\draft +\raggedbottom +\setstretch{1.5} + +\title{A NEW THEORY THAT WILL MAKE ME FAMOUS} + +\author{John Q. Doe} + +\firstreader{Albert Einstein}{\assocprof{Physics} \adviserchair} +\secondreader{Leonhard Euler}{\assistprof{Mathematics}} +\thirdreader{Rene Descartes}{\prof{Mathematics}} +\fourthreader{Isaac Newton}{\prof{Mathematics}} +\fifthreader{Leonardo DaVinci}{\prof{Physics} \head{Physics}} + +\dept{Physics}\college{Eberly College of Science} +\submitdate{May 2008} +\copyrightyear{2008} +\thesis +%\degree{Master of Science} +%\includepermission +\principaladviser{Albert Einstein} +\includecopyrightpage +\includecopyrightline +%\includelistoftables +%\includelistoffigures +\listofsymbols[0.75in]{ +\symbolentry{c}{Speed of light in a vacuum} +\symbolentry{e}{Euler Number} +\symbolentry{g}{Acceleration due to gravity. According to legend, one of my +readers had discovered gravity because an apple fell on his head. Of course +this is only shown to illustrate that multi-line variable descriptions remain in +the description column.} +\symbolentry{M_e}{Mass of Earth} +\symbolentry{G}{Universal gravitation constant. Following symbols will have +different column widths.} +\setsymwidth{0.5in} +\symbolentry{()'}{First derivative of a quantity. Notice that the columns have +moved and since the minipage environment is used, the description is wrapped to +the new column width. This might be used if both single character and longer +definitions such as integral expressions, are used in the list of symbols.} +\symbolentry{()''}{Second derivative of a quantity} +} + +\dedicationtext{This thesis is dedicated to my wife Mrs. Doe.} +\abstracttext{This thesis will no doubt be famous considering my committee.} +\acknowltext{I would like to thank H.G. Wells for lending me his time machine so +my committee could be present even though they lived over a span of hundreds of +years.} +\prefacetext{This is the preface} +\epigraphtext{This is the Epigraph} +\frontispiece{Insert Picture Here for Frontispiece} + +\begin{document} + +\makefrontmatter + +\chapter{Basic Considerations} + +This is a sample masters thesis. It has two skeleton chapters and two +appendices with simple figures and tables so that the lists and tables are +populated. There is no bibliography information. + +The body of the thesis would go here. Note that the placement of figures and +amount of figures and text per page is controlled by the \LaTeX commands: +\verb+\floatpagefraction+, \verb+\topfraction+, \verb+\bottomfraction,+ and +\verb+\textfraction+. + +\begin{table} \caption{Sample table in Chapter 1} \begin{center} +\begin{tabular}{|l|l|} \hline +Column 1, line 1 & Column 2, line 1 \\ \hline +Column 1, line 2 & Column 2, line 2 \\ \hline +Column 1, line 3 & Column 2, line 3 \\ \hline +Column 1, line 4 & Column 2, line 4 \\ \hline +\end{tabular} \end{center} \end{table} + +\begin{table} \caption{Second sample table in Chapter 1} \begin{center} +\begin{tabular}{|l|l|} \hline +Column 1, line 1 & Column 2, line 1 \\ \hline +Column 1, line 2 & Column 2, line 2 \\ \hline +Column 1, line 3 & Column 2, line 3 \\ \hline +Column 1, line 4 & Column 2, line 4 \\ \hline +\end{tabular} \end{center} \end{table} + +\begin{figure} \caption{Sample figure in Chapter 1} \begin{center} +\framebox{\begin{minipage}{5in} +\vspace{2in} \hfill \Huge A Figure would go here. \hfill \vspace{2in} +\end{minipage}} +\end{center} \end{figure} + +\begin{figure} \caption{Second sample figure in Chapter 1} \begin{center} +\framebox{\begin{minipage}{5in} +\vspace{2in} \hfill \Huge A Figure would go here. \hfill \vspace{2in} +\end{minipage}} +\end{center} \end{figure} + +\chapter{Advanced Considerations} + +A second chapter is included to illustrate the \verb+\numberbychapter+ feature, +which numbers tables and figures by the chapter number. + +\begin{figure} \caption{Sample figure in Chapter 2} \begin{center} +\framebox{\begin{minipage}{5in} +\vspace{2in} \hfill \Huge A Figure would go here. \hfill \vspace{2in} +\end{minipage}} +\end{center} \end{figure} + +\begin{figure} \caption{Second sample figure in Chapter 2} \begin{center} +\framebox{\begin{minipage}{5in} +\vspace{2in} \hfill \Huge A Figure would go here. \hfill \vspace{2in} +\end{minipage}} +\end{center} \end{figure} + +\begin{table} \caption{Sample table in Chapter 2} \begin{center} +\begin{tabular}{|l|l|} \hline +Column 1, line 1 & Column 2, line 1 \\ \hline +Column 1, line 2 & Column 2, line 2 \\ \hline +Column 1, line 3 & Column 2, line 3 \\ \hline +Column 1, line 4 & Column 2, line 4 \\ \hline +\end{tabular} \end{center} \end{table} + +\begin{table} \caption{Second sample table in Chapter 2} \begin{center} +\begin{tabular}{|l|l|} \hline +Column 1, line 1 & Column 2, line 1 \\ \hline +Column 1, line 2 & Column 2, line 2 \\ \hline +Column 1, line 3 & Column 2, line 3 \\ \hline +Column 1, line 4 & Column 2, line 4 \\ \hline +\end{tabular} \end{center} \end{table} + + +\includebibliography{ +\chapter*{Bibliography} +The bibliography would go here. It will not appear in the table of contents by +default. The \emph{includebibliography} command adds to the table of contents +and formats as single space. The built in \LaTeX\ bilbiography features can be +used inside and are automatically single spaced. +} + +\appendices \chapter{The First Appendix} + + +\begin{table} \caption{Sample table in first appendix} \begin{center} +\begin{tabular}{|l|l|} \hline +Column 1, line 1 & Column 2, line 1 \\ \hline +Column 1, line 2 & Column 2, line 2 \\ \hline +Column 1, line 3 & Column 2, line 3 \\ \hline +Column 1, line 4 & Column 2, line 4 \\ \hline +\end{tabular} \end{center} \end{table} + + +The first appendix goes here. The style file changes the chapter title to +"Appendix A" rather than ``A'' in the table of contents per the thesis +guidelines. The PhD example has a single appendix for illustration. + +A specific \verb+\chapter+ declaration is required for each appendix to specify +the title of the appendix. In that respect, it behaves like any other chapter +and the \verb+\appendices+ command merely reformats so it is called +``Appendix A'' in the table of contents + +\chapter{The Second Appendix} + +A second Appendix goes here. Two figures are included for inclusion in the +table of contents. + +\begin{figure} \caption{Sample figure in the second appendix} \begin{center} +\framebox{\begin{minipage}{5in} +\vspace{2in} \hfill \Huge A Figure would go here. \hfill \vspace{2in} +\end{minipage}} +\end{center} \end{figure} + +\begin{figure} \caption{Second sample figure in the second appendix} +\begin{center} +\framebox{\begin{minipage}{5in} +\vspace{2in} \hfill \Huge A Figure would go here. \hfill \vspace{2in} +\end{minipage}} +\end{center} \end{figure} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/psu-thesis/phdsample.pdf b/Master/texmf-dist/doc/latex/psu-thesis/phdsample.pdf Binary files differnew file mode 100644 index 00000000000..528231e413f --- /dev/null +++ b/Master/texmf-dist/doc/latex/psu-thesis/phdsample.pdf diff --git a/Master/texmf-dist/doc/latex/psu-thesis/phdsample.tex b/Master/texmf-dist/doc/latex/psu-thesis/phdsample.tex new file mode 100644 index 00000000000..f1f83ed68cb --- /dev/null +++ b/Master/texmf-dist/doc/latex/psu-thesis/phdsample.tex @@ -0,0 +1,185 @@ +\documentclass[dvips,11pt,oneside]{report} +\usepackage[doctor,signature]{psu-thesis} +\numberbychapter +\bibliographystyle{psuthesis} + +\raggedbottom +\setstretch{1.5} +\begin{document} + +\title{A NEW THEORY THAT WILL MAKE ME FAMOUS} + +\author{John Q. Doe} + +\firstreader{Albert Einstein}{\assocprof{Physics} \adviserchair} +\secondreader{Leonhard Euler}{\assistprof{Mathematics}} +\thirdreader{Rene Descartes}{\prof{Mathematics}} +\fourthreader{Isaac Newton}{\prof{Mathematics}} +\fifthreader{Leonardo DaVinci}{\prof{Physics} \head{Physics}} + +\dept{Physics}\college{Eberly College of Science} +\submitdate{May 2008} +\copyrightyear{2008} +\thesis +%\degree{Doctor of Philosophy} +\principaladviser{Albert Einstein} +\includecopyrightpage +\includecopyrightline +%\includecommittee +%\includelistoftables +%\includelistoffigures +\listofsymbols{ +\symbolentry{c}{Speed of light in a vacuum} +\symbolentry{e}{Euler Number} +\symbolentry{g}{Acceleration due to gravity. According to legend, one of my +readers had discovered gravity because an apple fell on his head. Of course +this is only shown to illustrate that multi-line variable descriptions remain in +the description column.} +\symbolentry{M_e}{Mass of Earth} +\symbolentry{G}{Universal gravitation constant. Following symbols will have +different column widths.} +\setsymwidth{0.5in} +\symbolentry{()'}{First derivative of a quantity. Notice that the columns have +moved and since the minipage environment is used, the description is wrapped to +the new column width. This might be used if both single character and longer +definitions such as integral expressions, are used in the list of symbols.} +\symbolentry{()''}{Second derivative of a quantity} +} + +\dedicationtext{This thesis is dedicated to my wife Mrs. Doe.} +\abstracttext{This thesis will no doubt be famous considering my committee.} +\acknowltext{I would like to thank H.G. Wells for lending me his time machine so +my committee could be present even though they lived over a span of hundreds of +years.} +\prefacetext{This is the preface} +\epigraphtext{This is the Epigraph} +\frontispiece{Insert Picture Here for Frontispiece} +\makefrontmatter + +\chapter{Basic Considerations} + +This is a sample masters thesis. It has two skeleton chapters and two +appendices with simple figures and tables so that the lists and tables are +populated. There is no bibliography information. + +The body of the thesis would go here. Note that the placement of figures and +amount of figures and text per page is controlled by the \LaTeX commands: +\verb+\floatpagefraction+, \verb+\topfraction+, \verb+\bottomfraction,+ and + +\begin{table} \caption{Sample table in Chapter 1} \begin{center} +\begin{tabular}{|l|l|} \hline +Column 1, line 1 & Column 2, line 1 \\ \hline +Column 1, line 2 & Column 2, line 2 \\ \hline +Column 1, line 3 & Column 2, line 3 \\ \hline +Column 1, line 4 & Column 2, line 4 \\ \hline +\end{tabular} \end{center} \end{table} + +\begin{table} \caption{Second sample table in Chapter 1} \begin{center} +\begin{tabular}{|l|l|} \hline +Column 1, line 1 & Column 2, line 1 \\ \hline +Column 1, line 2 & Column 2, line 2 \\ \hline +Column 1, line 3 & Column 2, line 3 \\ \hline +Column 1, line 4 & Column 2, line 4 \\ \hline +\end{tabular} \end{center} \end{table} + +\begin{figure} \caption{Sample figure in Chapter 1} \begin{center} +\framebox{\begin{minipage}{5in} +\vspace{2in} \hfill \Huge A Figure would go here. \hfill \vspace{2in} +\end{minipage}} +\end{center} \end{figure} + +\begin{figure} \caption{Second sample figure in Chapter 1} \begin{center} +\framebox{\begin{minipage}{5in} +\vspace{2in} \hfill \Huge A Figure would go here. \hfill \vspace{2in} +\end{minipage}} +\end{center} \end{figure} + +\chapter{Advanced Considerations} + +A second chapter is included to illustrate the \verb+\numberbychapter+ feature, +which numbers tables and figures by the chapter number. + +\begin{figure} \caption{Sample figure in Chapter 2} \begin{center} +\framebox{\begin{minipage}{5in} +\vspace{2in} \hfill \Huge A Figure would go here. \hfill \vspace{2in} +\end{minipage}} +\end{center} \end{figure} + +\begin{figure} \caption{Second sample figure in Chapter 2} \begin{center} +\framebox{\begin{minipage}{5in} +\vspace{2in} \hfill \Huge A Figure would go here. \hfill \vspace{2in} +\end{minipage}} +\end{center} \end{figure} + +\begin{table} \caption{Sample table in Chapter 2} \begin{center} +\begin{tabular}{|l|l|} \hline +Column 1, line 1 & Column 2, line 1 \\ \hline +Column 1, line 2 & Column 2, line 2 \\ \hline +Column 1, line 3 & Column 2, line 3 \\ \hline +Column 1, line 4 & Column 2, line 4 \\ \hline +\end{tabular} \end{center} \end{table} + +\begin{table} \caption{Second sample table in Chapter 2} \begin{center} +\begin{tabular}{|l|l|} \hline +Column 1, line 1 & Column 2, line 1 \\ \hline +Column 1, line 2 & Column 2, line 2 \\ \hline +Column 1, line 3 & Column 2, line 3 \\ \hline +Column 1, line 4 & Column 2, line 4 \\ \hline +\end{tabular} \end{center} \end{table} + + +\includebibliography{ +\chapter*{Bibliography} +The bibliography would go here. It will not appear in the table of contents by +default. The \emph{includebibliography} command adds to the table of contents +and formats as single space. The built in \LaTeX\ bilbiography features can be +used inside and are automatically single spaced. +} + +\singleappendix \chapter{There Can Be Only One} + + +\begin{table} \caption{Sample table in Appendix} \begin{center} +\begin{tabular}{|l|l|} \hline +Column 1, line 1 & Column 2, line 1 \\ \hline +Column 1, line 2 & Column 2, line 2 \\ \hline +Column 1, line 3 & Column 2, line 3 \\ \hline +Column 1, line 4 & Column 2, line 4 \\ \hline +\end{tabular} \end{center} \end{table} + + +A single appendix goes here. The style file changes +the chapter title to "Appendix" rather than ``Appendix A'' per the thesis +guidelines. The MS example has multiple appendices for illustration. + +A specific \verb+\chapter+ declaration is required to specify the title of the +appendix. In that respect, it behaves like any other chapter and the +\verb+\singleappendix+ command merely reformats so it is not called ``Appendix +A'' + +\begin{figure} \caption{Sample figure in the appendix} \begin{center} +\framebox{\begin{minipage}{5in} +\vspace{2in} \hfill \Huge A Figure would go here. \hfill \vspace{2in} +\end{minipage}} +\end{center} \end{figure} + +\begin{figure} \caption{Second sample figure in the appendix} \begin{center} +\framebox{\begin{minipage}{5in} +\vspace{2in} \hfill \Huge A Figure would go here. \hfill \vspace{2in} +\end{minipage}} +\end{center} \end{figure} + +\vita{The vita (or \emph{Curriculum vitae} for Latin enthusiasts) goes here. +There are no special formatting commands for the vita.} + +\UMIabstract{The UMI abstract goes here. There are no special formatting +commands for the UMI abstract, and it may be the same as the regular abstract +at the beginning. The above information is taken from the frontmatter +information and formatted automatically. + +Note that the UMI abstract is not bound with the thesis and hence has no page +number. It is printed at the end as a convenience. By default it is spaced the +same as the thesis but can be made a different spacing if desired. But for some +reason it complains if the abstract is not a single paragraph.} + +\end{document} |