Installation

You will need a few things in order to use this software:

• LaTeX (2e or 2.09)
• BibTeX (v0.99a or later)
• Perl
• Natbib (v5.3 or later; v6.8 style files included here)
• make (optional)

If you are not a local user, you will first need to download the latest version. You can get it from http://ads.harvard.edu/pubs/bibtex/astronat/ and unpack it using a command like

gunzip -c astronat.tar.gz | tar xvf -

The installation is a simple matter. You will need the natbib style file (natbib209.sty is the LaTeX 2.09 version); the ones included here have not been edited from their original forms. You will also need one of the bst files from the sub-directory with the appropriate journal name (apj for AAS, mnras for Monthly Notices). These sub-directories also contain bib files which define journal abbreviations for use in your bib database, which contains all your references. There are only two steps:

1. Put the appropriate sty, bst, and bib files where LaTeX/BibTeX can see them.
2. Put the Perl script nat2jour.pl somwhere in your PATH, and make sure it is executable (chmod +x nat2jour.pl).

There are two options for the first step:

• Keep all the necessary files in the same directory where you are processing your documents. (Or make symbolic links to them with the UNIX command ln -s.)
• OR Set the environment variables TEXINPUTS, BSTINPUTS, and BIBINPUTS.
  • TEXINPUTS tells LaTeX where to find sty (style) files.
  • BSTINPUTS tells BibTeX where to find bst (bibliography style) files.
  • BIBINPUTS tells BibTeX where to look for bib (bibliography database) files.

Local users at Berkeley should set their environment variables to include the directory ~jbaker/tex/inputs/astronat//, and do not need to copy any files, except that you will want to put then Perl script nat2jour.pl in your PATH.

Suppose you have all the files in sub-directories of /somewhere/tex/inputs/. Then the environment variables can be set as follows. For C-shell (put these in your .cshrc file):

setenv TEXINPUTS .:/somewhere/tex/inputs//:$TEXINPUTS

and for sh, ksh, or bash (put in .profile):

TEXINPUTS=.:/somewhere/tex/inputs//:$TEXINPUTS
export TEXINPUTS

and similarly for the other two variables. The trailing // means recurse through any sub-directories. Note that the directories in the colon-separated list are searched in order, so you'll want to have the path to these files ahead of any directories that have any files of the same name (otherwise the wrong ones will be used).

If you can become root you can install the files in a standard location where TEXINPUTS points. Even if you are able to do this, you may still need to explicitly set the other two variables. According to the BibTeX documentation it looks in TEXINPUTS by default, but in practice it doesn't actually seem to do this.

Go to the first, previous, next, last section, table of contents.