INSTRUCTIONS FOR THE PROSEMINAR CONTRIBUTION H. G. Katzgraber 14/05/2007 In order to be able to compile all contributions in a book format, it is necessary for all students to follow the set of rules below. If you have any questions, please send me an email before I get your contribution. Here is what you have to do: 1. Download the files: template.tgz all files README.txt this file Unpack the template.tgz file with tar xvzf template.tgz This should create a directory with the files: apsrevtitle.bst style file for the references example.tex where your contribution will go Makefile needed to easy compiling proseminar.tex main file -- do not change preamble.tex some commands -- do not change example.bib BibTex sample references pics a directory for your pictures 2. List of BIG no-nos: a) Do not under any circumstance change anything in the 'proseminar.tex' file. This is only intended to help you compile your contribution. Exception: call your contribution 'lastname.tex', where lastname is your last name and replace the line in the proseminar.tex file \include{example} to \include{lastname} In addition, rename the file example.bib to lastname.bib. Otherwise things will not compile. b) Do not use pdflatex. Just use plain vanilla LaTeX (see provided Makefile). Thus all your figures should be eps files with bounding boxes. c) Use only eps figures: Do not use any other format, in particular do not draw them using LaTeX directives as these seem to act different depending on the LaTeX compiler you use. d) Do not include any special packages in the LaTeX environment. You should be able to do everything you need with the packages supplied in 'preamble.tex'. If you need something special send me an email before you have to do the job twice. e) Do not use the 'thebibliography' environment. All references have to be supplied in BibTex format. Also: look carefully at the sample BibTex file for the syntax in author names, titles, ... f) Do not use Windows... This tends to mess up things. Rather, use a MAC or Linux (for example, the student workstations). g) Do not use color in your figures. The book will be printed in B&W. 3. Compilation: Once you have the files, you can compile them with the following commands: make compiles the paper with LaTeX once make bib run twice to get references included make dvi compiles and starts dvi viewer (on Linux) make ps compiles and generates PostScript make pdf compiles and generates PDF make clean removes temporary TeX files make tidy removes temporary files, .bbl .ps and .pdf files 4. In 'example.tex': a) Write the title of your contribution in the designated field. Write your name and the name of the supervisor at the obvious places. b) Write your abstract in the supplied field (starts with 'begin abstract'). Of course also add your name and the name of your supervisor. c) The example file contains also directives on how to cite papers from the example.bib file as well as an example on how you must bind in figures. These must be placed in a directory called pics. d) For your figures and equations always use good tags in \label{}. For example \label{lastname_hamiltonian} where 'lastname' is your last name. As you can imagine, there will be many people using a Hamiltonian... e) Use also good names for the figures, for example lastname_ham.eps, to avoid collisions. Also use UNIQUE names for defined macros, such as '\lastname-d' instead of '\d'. f) If you use macros for commands then use UNIQUE versions of them. This is very important since more than one person can likely define '\A' for something, which will cause compilation failure. A good idea would be to use '\Aww' if your name happens to be Willi Wiberg. g) Rename the line with 'example.bib' to 'lastname.bib' where 'lastname' is your last name. 5. References: a) Use ONLY BibTeX for the references. For example entries see the supplied example.bib file. Use also the different environment for the different types of citations: 'Article' for an article, 'Book' for a book, ... b) It is important to use a consistent notation for the labels of the references in the bibtex file. Thus we have the following convention: The label is the last name of the first author : last two digits of publication year. Example: M. Koerner, H. G. Katzgraber, and Alexander K. Hartmann, J. Stat. Mech. P04005 (2006). would have a label koerner:06 i.e., the entry in the bibtex file would be @Article{ koerner:06, author = {{K{\"o}rner}, M. and {Katzgraber}, H. G. and {Hartmann}, A. K. }, title = "{Probing tails of energy distributions using importance-sampling in the disorder with a guiding function}", journal = {JSTAT}, eprint = {cond-mat/0603290}, year = {2006}, volume = {4}, pages = {5} } Note that special characters such as umlauts need to be paraphrased. If an author has more than one paper per year: koerner:06, koerner:06a, koerner:06b, ... Note also the notation for the author's names: Katzgraber, H. G., i.e., "last name, initials". Do NOT use "et al." in the bibfile. The LaTeX system will do this automatically if needed. Yes, there are papers with 100 authors. We can negotiate about those... 6. Miscellanea: a) When you submit your contribution, just send me the RELEVANT files and not all possible versions you worked on... b) Make sure your contribution compiles under Linux before you send it to me. I do not have time to iron out compilation errors. The idea is that you learn it and it is your responsibility that it compiles. c) Spellcheck your contribution on any department machine with the following command (make a backup just in case before): ispell lastname.tex You can read more about this command with 'man ispell'. d) Make sure your contribution is no longer than 15 pages (hard limit). Preferably it should be 10 pages. e) It is imperative that you include the figures as shown in the example. In particular, the label to the figure should be at the end right after the caption, otherwise TeX will mess up the numbering. 7. If you have problems or questions, please contact your assistant. Otherwise please come and see me.