file: Readme-author.txt = Rob Rutten ASP-CS author instructions init: Oct 18 2006 last: Sep 21 2007 site: http://www.astro.uu.nl/~rutten/rrtex/manuals/publishers/aspcs note: use en, type ESC 64 CNTRL-X f introduction ------------ These are the author instructions for the ASP-CS proceedings of the Coimbra Solar Physics Meeting held in October 2006. They were reworked and improved at the end of the editing process to serve as example for future ASP-CS book productions. The parallel directory ../editors contains corresponding recipes for ASP-CS editors. I do not maintain these files unless I will become ASP-CS editor again. LaTeX and BibTeX ---------------- You must use LaTeX. If you know it already then just stick to this file and the template and example files in this directory. If you have not used LaTeX before then file aspauthor2005.pdf (Terry Mahoney's ASP latex manual) is a good read except on reference list production. In addition, you may consult the ASP information at http://www.aspbooks.org/author_information. I myself usually stick to Lamport's original and excellent LaTeX book. You must also use BibTeX. If you have not done so before then writing this paper is your chance to switch to BibTeX for all your future scientific writing. You will come to love it. Instructions, example, template, style files -------------------------------------------- Do NOT use the ASP style and template files but use my files at http://www.astro.uu.nl/~rutten/rrtex/manuals/publishers/aspcs/rjr-recipes/authors (or Google > Rob Rutten > Recipes .. > .. for ASP > authors) These files are: Readme-author.txt = this file, read and obey all! rjr-asp-template.tex = LaTeX template to use rjr-asp.sty = LaTeX style file to use rjr-asp-bib.bst = BibTex style file to use rjr-asp-example.tex = example latex input file to inspect aspauthor2005.pdf = ASP manual for style and coding matters upload-astro-ph.txt = recipe to put your paper on Astro-ph The rjr-asp-xx files are my improvements of the standard ASP files. Publication length and content ------------------------------ Consider seriously whether to submit: - a brief 2-page summary if your work is (or will soon be) published elsewhere, for example as extended abstract refering to the upcoming formal paper. Cut-and-paste assembly from another manuscript is unacceptable except for its abstract if already accepted. If you plan to publish the full work elsewhere, then give a summary specifying the intended authors and journal. - a full writeup of original work, with target page limits: poster 4 pages contributed talk 6 pages keynote talk 10-20 pages (longer for more review type) It is important to appreciate that thanks to ADS these proceedings will have wider reach and larger longevity than conference proceedings used to have. All papers will be directly accessible via ADS, initially to ASP susbscribers and the conference attendees but after three years to anybody. And you may put your manuscript as preprint on Astro-ph as well, to which ADS links also. Thus, it is now more worthwhile to put effort into an extended writeup of your work and to include discussions, explanations, speculations etc. that cannot easily be put into a journal paper (for example cartoon clarifications). Similarly, reviews may now gain larger impact and longer citation life than used to be the case for reviews in conference proceedings. The above page limits are therefore negotiable for those of you who want to spend effort on producing a better paper than standard conference papers. Especially the keynote speakers are invited to exploit this opportunity to spread insight and background. Please inform the pertinent editor early what your plan is. Submission ---------- Send the pertinent editor the following files as email attachment (with "yourname" standing for the first author's family name): yourname.tex the LaTeX input file yourname-figname.eps etc for the figures, which must be .eps yourname-orig.ps your own output to check what you got for example collected as yourname.tar.gz or yourname.zip. File names and label names -------------------------- To ensure uniqueness when all papers are LaTeXxed together in the book production, you MUST add your family name as prefix to all file names and to all LaTeX labels: figure file: yourname-fig1.eps \includegraphics[with=10cm]{\figspath/yourname-fig1} \caption[]{\label{yourname-fig:theoryofeverything} as evident from Fig.~\ref{yourname-fig:theoryofeverything} Definitions ----------- ASP does not accept any private latex definitions or macros: - do NOT use \newcommand or \renewcommand - employ the \def definitions at the start of file rjr-asp.sty - suggest additions to those but ONLY if useful for other authors Cites and references -------------------- You MUST use proper \cite commands: ... (see e.g., \cite{biblabel1}, cf.\ \cite{biblabel2}). ... as shown by \citet{biblabel1} and \citet{biblabel2}. You MUST use BibTeX to produce the corresponding \bibitems in a "thebibliography" environment. Use your existing .bib files if you are already a BibTeX user, or make a "yourname.bib" BibTeX database input file, preferably by pasting the entry you get when hitting "Bibtex entry for this abstract" on ADS into your yourname.bib file. Or copy the relevant author.bib files from my website and concatenate these into one file. Then use BibTex with the commands at the end of file "rjr-asp-template.tex" (latex, bibtex, latex, latex). See file "rjr-asp-example.tex", and if need be my simple manual for student reports at http://www.astro.uu.nl/~rutten/rrweb/rjr-material/latex (or Google > Rob Rutten > Latex and bibtex > simple manual). I myself maintain name.bib files containing all ADS papers by many authors of interest to me, all linked at http://www.astro.uu.nl/~rutten/rrtex/bibfiles/ads/bib and the corresponding abstracts (to find the ADS label) at http://www.astro.uu.nl/~rutten/rrtex/bibfiles/ads/abs. I just paste the label from the abstract into the \cite in my manuscript, the rest is fully automatic. There are also nice ADS-pull-over scripts on my website. Note that ASP wants normal fonts for latin abbreviations: e.g., Rutten et al.\ found \eg\ Rutten \etal\ (using the commands in "rjr-asp.sty"). At manuscript completion copy the resulting .bbl file into your manuscript, and comment out the bibliography command. Bibtex labels ------------- Either use standard ADS \cite labels such as {2006A&A...452L..15L} or invent your own, then adding your surname as prefix: {rutten-DOT1}. Your editor may desire you to make all labels unique by adding your surname (such as rutten- for me) to all bibtex labels, both in the \cite commands in the main text and after all ]{ symbol combinations in the "thebibliography" part. Otherwise identical labels from other authors with worse \bibitems then yours may muck up your good work. Then: comment out the commands %%\bibliographystyle{rjr-asp-bib} %%\bibliography{/tmp/adsfiles.bib} insert your .bbl file instead adapt labels everywhere: \cite{yourname-2005ASPC..336...25A} replace ]{ by ]{yourname- in all \bibitems Figures ------- The proceedings book will be printed in high-density grayscale without any color. If you want your color figures to be readable in the printed book then make sure that they are so, and avoid explanations such as "the red curve shows". However, the pdf file that will become available and will also go to ADS will retain full color. So ADS readers may inspect color figures on their screen and/or print your paper on their color printer. Consider also that small images, too small to be well visible in the book, can be blown up on-screen with the pdf reader, so that you may choose to insert them rather small to gain space. You may also gain space for text by putting much stuff in the figure captions since these are set in small font. Do not use figure placement commands (no [!ht] or such) Figure conversion ----------------- If you include figures from others, do so at full vector resolution (cut and paste pdf with Acrobat Reader/Writer or Preview in MacOS). Unix/Linux command to convert images to full-resolution .eps: > convert -crop 0x0 -geometry XxY file.tif file.eps (XxY = image size in pixels, measure with e.g. xv) or to cut down a too large existing eps file: > convert -density 300 -crop 0x0 -geometry 1000 fig.eps aux.ps > mv aux.ps fig-small.eps Good utility: http://arxiv.org/help/bitmap/software#jpeg2ps For example: > convert -geometry 2000 fig-large.eps fig-small.jpg > jpeg2ps -h fig-small.jpg > fig-small.ps Final checking and editing before you submit your manuscript ------------------------------------------------------------ no "Overfull" error messages in the yourname.log file? no "Missing character" error messages in the yourname.log file? title and running title have nouns etc capitalized? no commma before "and" in the author list? ``....'' instead of "...."? space declarations? et al.\ \AA\ cf.\ e.g., units in roman? $c_{\rm EM}=3\times10^5~$~km$^2$s${-1}$ non-variable indices in roman? electron mass $m_{\rm e}$ more roman: ${\rm e}^x$ $\int f(x)\,{\rm d}x$ $T_{\rm eff}$? punctuation added after equations? Figure~\ref{fig:..} shows this but Fig.~\ref{fig:..} shows that \url{http://www.astro.uu.nl/~rutten} figure, table, equation, section labels unique? {rutten-fig:HRD} Submission to Astro-ph ---------------------- When the editorial efforts are complete you may upload your manuscript to the Astro-ph preprint server. An important advantage of doing so is that it then automaticlly becomes accessible via ADS and that it remains accessible on ADS to anybody anywhere also when the book is out and ADS changes the entry to an ASPC one. In order to do so you must get back your input latex file from the book editor, including all the modifications made by the editor. See my file upload-astro-ph.txt for a recipe including figure-compression hints. Latex do's and don't's ---------------------- The remainder of this file is a segment from my student manual at http://www.astro.uu.nl/~rutten/rrweb/rjr-material/latex (or Google > Rob Rutten > latex & bibtex > student-report). This segment points out common fallacies in coding LaTeX. (The rest, not copied here, is a brief instruction into using LaTeX and BibTex with an A&A-like template for student reports.) - use WinEdt or a Unix/Linux editor to type the LaTeX input text (Emacs has special features and hooks for LaTeX and BibTeX). Type pure ASCII: generate accents etc with LaTeX \ commands. Good typing habits: - indent equations and environments as in programming - add comments to clarify your layout and what you are doing; LaTeX skips the remainder of a line after %, type \% to get % - use hard returns to maintain the layout - new paragraph = 1 or more blank lines, not ....\\[1ex] - spaces: multiple spaces is same as single space no-line-break-space: ~ R.J.~Rutten, 1083.0~nm line (otherwise you may get the unit nm on the next line) code space after period after small character: Prof.\ Dr.\ C.~Zwaan (cf.\ \cite{Rutten1978}) (otherwise LaTeX adds more space taking it to be sentence end) code space after LaTeX command: 4554~\AA\ line, but \AA. Nordlund (otherwise LaTeX eats up the space as command delimiter) - dashes: hyphen = - magneto-acoustic longer dash = -- 5--min oscillation longest dash = --- 399.3---399.6~nm wavelength region he said---but I think (ApJ habit) he said -- but I think (A&A habit) - quotation marks: use ``......'', never use "...." - math: $...$ for in-text math never use \frac in in-text math (too small), only use $a/b$ \begin{equation} ........ for displayed & numbered equation (indent!) \label{yourname-eq:whatever} \end{equation} Use \sin, \cos, \exp etc ($sin$ means product s i n) Use roman alphabet for non-mathematical indices (code only math variables in math notation ($x$): $T_{\rm eff}$ %% ($T_{eff}$ makes eff = product e f f) \begin{equation} B_\nu(T) = \frac{2\pi m_{\rm e} c^2}{h^3} %% e = electron = non-variable proper name \frac{1}{\exp{-h\nu/kT}-1} \label{eq:Planck} \end{equation} Use {\rm d} or \partial for differential d Add space with \, before differential d, {\rm e}^{..} etc Add punctuation after equations, just as in normal text - numbers and units: $B_\nu = 5\,10^12$~erg\,cm$^{-2}$s$^{-1}$sterad$^{-1}$ $v=50$~km\,s$^{-1}$ velocity 180~s 10~mHz a $40 \times 30$~arcsec$^2$ field alternative is to use smaller blank space with \,: 50\,km\,s$^{-1}$ velocity the Ba\,II\,4554\,\AA\ line (NB: \ after \AA for normal space) 10\,mHz frequency at $\lambda \approx 160$\,nm one observes - crossreferences: keep all references to figures, tables, equations, sections dynamic by adding labels to them: \label{yourname-fig:power images} \label{yourname-tab:lines} \label{yourname-eq:mass conservation} \label{yourname-sec:discuss} and refering to these as: in Sect.~\ref{yourname-sec:discuss} we discuss Figure~\ref{yourname-fig:power images} shows power spectra (see Figs.~\ref{yourname-fig:xx}, \ref{yourname-fig:xx}---\ref{yourname-fig:xx}) inserting this result into eq.~(\ref{yourname-eq:mass}) use Figure in full at the start of a sentence NB: LaTeX needs to be run twice to get all crossreferences right. - literature \cites and References Use BibTex with ADS labels. Pull the BibTex entry per paper over from ADS and put it in your yourname.bib file, or do it my way (large ADS name.bib and name.abs collection with linux pull-over scripts on my website). Use \cite{label}, \citep{label}, \citet{label} in your text. Running latex, bibtex, latex, latex produces the .bbl file.