Differences
This shows you the differences between two versions of the page.
|
thesis_lore [2012/06/01 11:58] nmcc [Filing in the Summer] |
thesis_lore [2012/08/23 21:04] (current) peterwilliams Reference ucastrothesis! |
||
|---|---|---|---|
| Line 57: | Line 57: | ||
| ======LaTeXing Your Dissertation====== | ======LaTeXing Your Dissertation====== | ||
| - | You will need the following files in your latex directory (on a Mac, it's often ~/Library/texmf/tex/latex/misc/ -- if that directory doesn't exist, you can make it) or main thesis directory: | + | To get a bomb of all the files you need to start LaTeXing your dissertation, |
| - | * {{thesis_lore:ucthesis.cls.txt|ucthesis.cls}} | + | use [[https://github.com/pkgw/ucastrothesis|the ucastrothesis Git repository]] created |
| - | * {{thesis_lore:tweak_ucthesis.sty.new.txt|tweak_ucthesis.sty}} | + | by Peter Williams. You don't need to know how to use Git to use this: [[https://github.com/pkgw/ucastrothesis/zipball/master|this link]] will give you a Zip of the most recent version, for instance. (Although Peter suggests that you both learn [[http://git-scm.com/|Git]] and use it to version-control your thesis!) You can then follow the directions in that repository |
| - | * {{thesis_lore:bibsetup.sty.txt|bibsetup.sty}} | + | and start reading the main files to figure out how the pieces fit together. |
| - | * {{thesis_lore:aasmacros.tex.txt|aasmacros.tex}} | + | |
| - | * [[http://nuclear.ucdavis.edu/~rpicha/sample/|the uct1x.clo and uct1x.sty]] files, where x={0,1,2} -- if this has moved, google the file names. | + | |
| - | Chop off the ".txt" (and ".new") at the ends of these filenames. Then, use this {{thesis_lore:thesis.tex.txt|thesis.tex}} file as a template for the overall thesis document, which uses the UC Thesis environment and imports individual chapter tex documents from appropriate subfolders. Modify this {{thesis_lore:frontmatter.tex.txt|frontmatter.tex}} file to make your appropriate preliminary pages. Use this {{thesis_lore:topic.tex.txt|topic.tex}} file as a template for individual chapter files (and put it in a folder called "topic"). Also, use this {{thesis_lore:approvalpage.tex.txt|approvalpage.tex}} file as a template for your dissertation approval page, which your committee signs. These files should have enough stuff to make typesetting your thesis possible without having to learn too much of the guts of LaTeX. | + | Old instructions for getting the LaTeX files are farther below. |
| - | + | ||
| - | If you have two co-chairs, then some of the files need to be altered to note this. In this case, use these modified versions of {{thesis_lore:ucthesis.cls.cochairs.txt|ucthesis.cls}}, {{thesis_lore:tweak_ucthesis.sty.cochairs.txt|tweak_ucthesis.sty}}, and {{thesis_lore:frontmatter.tex.cochairs.txt|frontmatter.tex}}. Just cut the ".cochairs.txt" off the filenames. | + | |
| ====Margins==== | ====Margins==== | ||
| Line 72: | Line 68: | ||
| They will reject your dissertation if it does not have the right margins. The limits are 1 inch all around, and the page number must be no closer than 3/4 inch from the edge (and consistently placed and on every single page, even chapter pages). These are minimums, so you cannot go wrong if you give yourself some buffer room. | They will reject your dissertation if it does not have the right margins. The limits are 1 inch all around, and the page number must be no closer than 3/4 inch from the edge (and consistently placed and on every single page, even chapter pages). These are minimums, so you cannot go wrong if you give yourself some buffer room. | ||
| - | The margins set up in the above files should be correct (they have been accepted for at least two dissertations as of May 2010). If for some reason you want/need to tweak your margins, there is a command in ucthesis.cls, for instance, which reads "\topmargin xxxxin" where xxxx is some number of inches for the top column -- change that until you have at least 1 inch. If you are using a Mac with Preview, you can measure the PDF margins by using the "select" tool in conjunction with "show inspector". | + | Don't use the "twoside" option in the ucthesis style for your submitted version. The Dissertation Guidelines state that page numbers should be in a "consistent" location in your dissertation, but since the move to electronically submitted theses, this location is what you see scanning through the PDF, **not** what you'd get printing out the thesis with a duplexing printer. The "twoside" option makes things look nicer if you're going to be printing the PDF out yourself on a capable printer, though. |
| + | |||
| + | If you run into problems with your margins, tweak the options given to the "geometry" package. The "showframe" option prints out the margins it's using making it relatively easy to spot overflows -- though this option only works on all pages for geometry version >= 5.0. If you are using a Mac with Preview, you can measure the PDF margins by using the "select" tool in conjunction with "show inspector". | ||
| The most common problems with margins come from formulae, tables, and figures. Tables and Figures are discussed below. Check all of your formulae (especially in-line formulae!) and make sure they conform! You may need to re-format some of them, or shrink the font. | The most common problems with margins come from formulae, tables, and figures. Tables and Figures are discussed below. Check all of your formulae (especially in-line formulae!) and make sure they conform! You may need to re-format some of them, or shrink the font. | ||
| Line 78: | Line 76: | ||
| ====Tables==== | ====Tables==== | ||
| - | If you use deluxetable because you have a huge table than runs over many pages, it won't play nice with the ucthesis class file. The biggest problem is that it creates a new table on each page, so the list of tables after the table of contents will list the table multiple times. It also has a habit of putting the last page of the table a page late, leaving text interrupting the table. To fix this, use [[http://www.astro.psu.edu/gradinfo/psuthesis/longtable.html|longtable]], a package included with latex. The linked website has all of the details. | + | The deluxetable package sometimes works in theses but breaks down other times, especially for very long tables. Try using the [[http://www.astro.psu.edu/gradinfo/psuthesis/longtable.html|longtable]] package instead. |
| If your tables run wide (which happens a lot with these fat margins) there are a few tricks you can try to get them to fit. The first is to make your columns closer together with this command: | If your tables run wide (which happens a lot with these fat margins) there are a few tricks you can try to get them to fit. The first is to make your columns closer together with this command: | ||
| Line 84: | Line 82: | ||
| \setlength{\tabcolsep}{0.05in} | \setlength{\tabcolsep}{0.05in} | ||
| - | Adjust to taste. If that's not enough, you can use the lscape package and invoke the landscape environment to make your tables landscaped (don't use the \rotate command; it's flaky). Here's how a table might begin: | + | Adjust to taste. If that's not enough, you can use the pdflscape package and invoke the landscape environment to make your tables landscaped. (Don't use \rotate command.) Here's how a table might begin: |
| \begin{landscape} | \begin{landscape} | ||
| Line 91: | Line 89: | ||
| \begin{longtable}{l@{ }rccccccccccr} | \begin{longtable}{l@{ }rccccccccccr} | ||
| - | It's all on the longtable website. A nice PDF with a description of the longtable package is at [[http://www.cs.brown.edu/system/software/latex/doc/longtable.pdf|this link]]. | + | It's all on the longtable website. A nice PDF with a description of the longtable package is [[http://www.cs.brown.edu/system/software/latex/doc/longtable.pdf|here]]. |
| - | The downside to using the landscape environment is that you have to put it outside of the floating table environment. This results in LaTeX putting the table in that exact place relative to the text, meaning you could end up with half the page before the table being empty. Another alternative, at least for tables that are wide, but short, is to use the sidewaystable environment in the "rotating" package. Whether or not this would suffer the same problems as deluxetable when also dealing with very long tables is unknown. | + | The downside to using the landscape environment is that you have to put it outside of the floating table environment. This results in LaTeX putting the table in that exact place relative to the text, meaning you could end up with half the page before the table being empty. Another alternative, at least for tables that are wide, but short, is to use the "sidewaystable" environment in the "rotating" package. Whether or not this would suffer the same problems as deluxetable when also dealing with very long tables is unknown. |
| ====Figures==== | ====Figures==== | ||
| - | For figures, make sure your figures are not too big. If you have played with axes and such you might find the figures are pushing your captions out beyond the margins. If this happens, open up the actual eps file in a text editor and play with the line that reads "BoundingBox:" and play with the numbers there. These numbers tell LaTeX where the edges of the figure are, so by tweaking them you can trick LaTeX into making the figure take up less room. | + | For figures, make sure your figures are not too big. If you have played with axes and such you might find the figures are pushing your captions out beyond the margins. If this happens, the "pdfcrop" tool is great for removing extraneous whitespace. (If you're generating figures from EPS files, you can open up the file in a text editor and play with the line that reads "BoundingBox:" and play with the numbers there.) |
| The default LaTeX effect on figures will be to put large-ish figures on their own page (even when text could easily fit around them on the page) and smaller figures on the top of pages, with text underneath. Feel free to have all figures take up their own page by making them fill the page: | The default LaTeX effect on figures will be to put large-ish figures on their own page (even when text could easily fit around them on the page) and smaller figures on the top of pages, with text underneath. Feel free to have all figures take up their own page by making them fill the page: | ||
| - | \includegraphics[width=13cm]{figure.eps} | + | \includegraphics[width=13cm]{intro/figure1} |
| though this is by no means a requirement. You can also force your figures to be on a "page of floats" (= no text) in the figure command: | though this is by no means a requirement. You can also force your figures to be on a "page of floats" (= no text) in the figure command: | ||
| Line 116: | Line 114: | ||
| though again, there is no formal rule requiring a figure to be on its own page. | though again, there is no formal rule requiring a figure to be on its own page. | ||
| - | If you have wide figures that you want to have rotated sideways, you could use the landscape environment, but it may not be ideal. The problem is that you have to put it outside of the floating figure environment. This results in LaTeX putting the figure in that exact place relative to the text, meaning you could end up with half the page before the figure being empty. Another alternative is to use the sidewaysfigure environment in the "rotating" package. | + | If you have wide figures that you want to have rotated sideways, you could use the landscape environment, but it may not be ideal. The problem is that you have to put it outside of the floating figure environment. This results in LaTeX putting the figure in that exact place relative to the text, meaning you could end up with half the page before the figure being empty. Another alternative is to use the sidewaysfigure environment in the "rotating" package. |
| ====Captions==== | ====Captions==== | ||
| + | |||
| The captions of your tables and figures will appear in the lists of figures and tables after the table of contents. If you'd like shorter table and figure (or even chapter!) names, use the optional argument in the caption (or chapter!) command: | The captions of your tables and figures will appear in the lists of figures and tables after the table of contents. If you'd like shorter table and figure (or even chapter!) names, use the optional argument in the caption (or chapter!) command: | ||
| Line 139: | Line 138: | ||
| If your dissertation contains previously published material, you will need to obtain a signed letter from your committee chair (adviser) stating that this constitutes dissertation-level work. You will also need a letter from every co-author stating that it is okay for you to reproduce this material in your dissertation. Alternatively, a printed email from each co-author stating the same thing can be included with the application, sent to Graduate Services along with copies of the published material. If you have a very large number of co-authors, a letter from your adviser to the dean stating that this requirement is a hardship for you since all of the many co-authors can not be reached and that your adviser speaks for all of them in approving the use of this material may be sufficient. This has worked in at least one case (Dexter has a copy of the letter that worked in her records), but it has also been known to fail, so if you want to try this, start several months in advance. | If your dissertation contains previously published material, you will need to obtain a signed letter from your committee chair (adviser) stating that this constitutes dissertation-level work. You will also need a letter from every co-author stating that it is okay for you to reproduce this material in your dissertation. Alternatively, a printed email from each co-author stating the same thing can be included with the application, sent to Graduate Services along with copies of the published material. If you have a very large number of co-authors, a letter from your adviser to the dean stating that this requirement is a hardship for you since all of the many co-authors can not be reached and that your adviser speaks for all of them in approving the use of this material may be sufficient. This has worked in at least one case (Dexter has a copy of the letter that worked in her records), but it has also been known to fail, so if you want to try this, start several months in advance. | ||
| + | |||
| + | ====== Old LaTeX File Links ====== | ||
| + | |||
| + | (Peter Williams suggests you check out the ucastrothesis files mentioned above rather than these, but here's the info for posterity.) You will need the following files in your latex directory (on a Mac, it's often ~/Library/texmf/tex/latex/misc/ -- if that directory doesn't exist, you can make it) or main thesis directory: | ||
| + | * {{thesis_lore:ucthesis.cls.txt|ucthesis.cls}} | ||
| + | * {{thesis_lore:tweak_ucthesis.sty.new.txt|tweak_ucthesis.sty}} | ||
| + | * {{thesis_lore:bibsetup.sty.txt|bibsetup.sty}} | ||
| + | * {{thesis_lore:aasmacros.tex.txt|aasmacros.tex}} | ||
| + | * [[http://nuclear.ucdavis.edu/~rpicha/sample/|the uct1x.clo and uct1x.sty]] files, where x={0,1,2} -- if this has moved, google the file names. | ||
| + | |||
| + | Chop off the ".txt" (and ".new") at the ends of these filenames. Then, use this {{thesis_lore:thesis.tex.txt|thesis.tex}} file as a template for the overall thesis document, which uses the UC Thesis environment and imports individual chapter tex documents from appropriate subfolders. Modify this {{thesis_lore:frontmatter.tex.txt|frontmatter.tex}} file to make your appropriate preliminary pages. Use this {{thesis_lore:topic.tex.txt|topic.tex}} file as a template for individual chapter files (and put it in a folder called "topic"). Also, use this {{thesis_lore:approvalpage.tex.txt|approvalpage.tex}} file as a template for your dissertation approval page, which your committee signs. These files should have enough stuff to make typesetting your thesis possible without having to learn too much of the guts of LaTeX. | ||
| + | |||
| + | If you have two co-chairs, then some of the files need to be altered to note this. In this case, use these modified versions of {{thesis_lore:ucthesis.cls.cochairs.txt|ucthesis.cls}}, {{thesis_lore:tweak_ucthesis.sty.cochairs.txt|tweak_ucthesis.sty}}, and {{thesis_lore:frontmatter.tex.cochairs.txt|frontmatter.tex}}. Just cut the ".cochairs.txt" off the filenames. | ||
| + | |||
| + | tweak_ucthesis.sty is the one that sets the margins. Warning: the newest version of TeXShop for Macs is currently off on the left hand margin by 1mm. You'll need to change the textwidth, etc... in this file if you find you are having this problem. | ||
| + | |||
| + | The margins set up in the above files should be correct (they have been accepted for at least two dissertations as of May 2010). If for some reason you want/need to tweak your margins, there is a command in ucthesis.cls, for instance, which reads "\topmargin xxxxin" where xxxx is some number of inches for the top column -- change that until you have at least 1 inch. If you are using a Mac with Preview, you can measure the PDF margins by using the "select" tool in conjunction with "show inspector". | ||
| + | |||
