AASTeX Hints - AAS Journals
SUBMIT
Author Tools
About AAS Journals
Policies
Author Instructions
The AASTeX Package for Manuscript Preparation
AASTeX Hints
AASTeX Hints
Some Helpful TeX Hints
LaTeX is a complicated typesetting program. Here are some hints and links to other macros or programs to make writing a LaTeX document easier.
1 Running text
2 Math
3 Cross-referencing
4 Useful External Packages
5 Online collaborative writing tools
6 Including Chinese, Japaneses and Korean characters in author lists
Running text
In TeX, the ends of words and sentences are marked by spaces, and it does not matter how many spaces are typed; one is as good as 100. TeX treats the end of a line in the input file as a space. Paragraphs are separated by blank lines.
TeX will automatically take care of hyphenating and breaking words at the end of lines, so you do not need to break words with hyphens. Do, however, hyphenate modifiers within a line of text, e.g., “author-prepared copy.”
Quotation marks should be typed as pairs of opening and closing single quotes, e.g., ”quoted text”; do not use double quotes (“bad form”).
Do not underline. In printing, text is emphasized by changing the type style, usually to
slanted
or
italic
type.
A number of common characters are interpreted as commands; therefore, if you want to use them in text, they must be preceded by a backslash (\): $ & % # { and } must be typed \$ \& \% \# \{ and \}.
Refrain from adding vertical or horizontal space. Concentrate on the content of the document and identifying its components with the structural markup commands rather than worrying about producing perfectly formatted pages.
Math
Mathematical expressions that are part of the running text are delimited by a single dollar sign ($), e.g., $\pi r^2$ yields
. To get the appropriately sized superscript or subscript in the roman font, use the \rm command, e.g., $J_{\rm HF}(t)$ produces
HF
).
Displayed equations can be delimited in several ways. See the User Guide for details on display equation markup.
While it is possible for authors to assign their own equation numbers, it is easier to let LaTeX number them automatically. By default, LaTeX will number equations sequentially from the beginning of the manuscript to the end.
Cross-referencing
Cross-referencing equations, tables, and figures in text depends upon the use of “keys,” which are defined by the user. The
\label
command is used to define cross-reference keys for LaTeX;
\ref
is used to refer to them. Keys are simply text strings that serve to label equations, tables, and figures, so that they may be referred to symbolically in the text. For sections and the like, place
\label
commands immediately after the markup command that starts the structure being referenced. For figure and table captions, place the
\label
command
\caption, \tablecaption,
or
\figcaption
, e.g.,
\tablecaption{This is a caption.\label{tab1}}
Do
not
put references to page numbers in your manuscript.
LaTeX keeps track of auto-numbered counters and cross-reference information by maintaining an auxiliary file in the same working directory as the source file. The auxiliary file will have an extension of .aux. This file should not be deleted, since subsequent LaTeX processing uses the auxiliary data to resolve references, etc.
The auxiliary file mechanism makes it necessary to run LaTeX on a given source file more than once to ensure that the cross-reference information has been properly resolved. When changes are made that affect the number or the placement of equations, tables, and the like. LaTeX will issue a warning message that advises the user to “rerun to get cross-references right,” in which case, LaTeX should be run again.
Useful External Packages
latexdiff
Please note:
latexdiff
LaTeX output files should not be submitted to the AAS Journals. You may decide that
latexdiff
PDFs can be useful for helping the editor and reviewer understand the changes made to a manuscript. However, in the example below, the
“new.tex”
LaTeX file, sans markup must also be submitted. Further all final, accepted LaTeX/PDF files submitted must be free of track-changes markup, especially deleted or strikethrough text.
The Perl tool
latexdiff
, which can be found in
CTAN
or common TeXLive distributions, helps you identify and catalog changes you made to your manuscript during revisions. It can also be used on input files or bibliographies.
latexdiff
is run from the command line. The following command line call will produce output that has all new text highlighted in bold.
> latexdiff -t BOLD old.tex new.tex > diff.tex
where
“old.tex”
is the original latex file and
“new.tex”
is the revised copy. The output is sent to the
“diff.tex”
file. Compile this
“diff.tex”
file to produce the PDF copy with the bold text.
Do not submit the
“diff.tex”
file to the AAS Journals under any circumstances. If using
latexdiff
you must upload the
“new.tex”
version to our peer review system along with the
“diff.pdf”
copy at revision, including notes about the reason for including the
latexdiff
PDF document. Note that if you do not use the “-t BOLD” argument, the default will show the added text as wavy-underlined and blue while removed text will be struck out and red. PDF revisions showing blue, red, or struckthrough text may be rejected by the editors and reviewers as too confusing for their use.
Please see the online
documentation
for more details.
Merge multiple postscript files into a single file
The
assemble
perl script by Robert Lupton will merge multiple postscript files into a single postscript file. K.Z. Stanek provides some documentation on its use
here
. Stanek’s main use of assemble.pl is to create meeting posters but the code can also be used to make more compact figures by merging multiple component figures into a single one.
Merge multiple latex components into a single file
For authors who use the
\input
and
\include
commands to reference external latex files such as tables and sections, it is sometimes necessary to “flatten” the LaTeX structure by merging all the external files into one. A strong advantage of the single, flat LaTeX file is that the AAS journal’s metric counters (e.g.
ApJL
manuscript length calculator
) only accepted a single, combined LaTeX manuscript. Two source codes are available to merge LaTeX structures. One is a C code called
flatten
and the other is a Perl script called
latexexpand
Excel to LaTeX tables converters
Two programs are available to covert Microsoft Excel tables into LaTeX tabular format:
excel2latex
and
xl2latex
Word to latex manuscripts converters
Similarly, many programs are available to convert Microsoft Word files into LaTeX format. The programs are
WordML2LaTeX
catdoc
, and
word2latex
Online collaborative writing tools
Overleaf
You can use the collaborative writing platform
Overleaf
to collaboratively write a manuscript with AASTeX classfiles and then directly submit the latex and figures to the AAS peer review system. More information can be found
here
Including Chinese, Japaneses and Korean characters in author lists
Authors have the option to include names in Chinese, Japanese, or Korean (CJK) characters in addition to the English name. Information on how to set this up in a latex manuscript is available
here
Policy News
Read more about the AAS journals ethics policy.
AAS | IOP Astronomy
The American Astronomical Society (AAS) have partnered with IOP Publishing to create an
exciting new collection of astronomy and astrophysics ebooks
to further the AAS mission: "to enhance and share humanity's scientific understanding of the universe."
Announcement
AAS Journals Fully Open Access in 2022
In keeping with our mission, the entire AAS journals portfolio was made freely accessible as of 1 January 2022.
Read more.