Index of /teaching/SS06/tex-macro/template

Icon  Name                    Last modified      Size  Description
[DIR] Parent Directory                             -   
[   ] Makefile                05-Oct-2011 15:05  699   
[   ] aiptitle.bst            05-Oct-2011 15:05   19K  
[   ] example.tex             05-Oct-2011 15:05  1.4K  
[DIR] pics/                   05-Oct-2011 15:05    -   
[   ] proseminar.tex          05-Oct-2011 15:05  686   
[   ] refs.bib                05-Oct-2011 15:05  1.6K  


INSTRUCTIONS FOR THE PROSEMINAR CONTRIBUTION
H. G. Katzgraber June, 2006


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:

	aiptitle.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
	refs.bib		BibTex sample references

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

		\input{example}

	to

		\input{lastname}
                                                                                
        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 'proseminar.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.

	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 your abstract in the supplied field (starts with 'begin
	abstract').

	b) ONLY use \subsection and below, i.e., do NOT use \section
	or even worse \chapter.

	c) The example file contains also directives on how to cite
	papers from the refs.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'.

5. References:

	a) Use ONLY BibTeX for the references. For example entries see the
	supplied refs.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.

6. Miscelleanea:

	a) When you submit your blurb, just send me the RELEVANT files
	and not all possible versions you worked on...

	b) Make sure your blurb 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.

	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 20 pages (hard
	limit). Preferably it should be 10 - 15 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, otherwsie TeX will mess up the
	numbering.