%
% This file contains examples of using the commands defined in apa.cls
% It is not recommended that you use this as a sample document because
% of its very short length, which makes for very awkward formatting.
% In fact this file will not compile right because of the commands that
% are embedded in the text (unescaped backslashes all over the place)
% Just use the examples of the commands you need.
%
% The class command goes at the top
%
\documentclass[fignum,jou]{apa}
%
% Change jou to man/doc for the other modes:
%
%\documentclass[fignum,man]{apa}
%
% If you have postscript graphics to include, load the graphicx package
%
\usepackage{graphicx}
%
% Define the various headings, names, and other required stuff
%
\title{Sample Title}
\twoauthors{Myself Author}{Second Author and Some Friend}
\twoaffiliations{My Department\\ Address ZIP}{The other place\\ Elsewhere}
\abstract{Text of the abstract}
\acknowledgements{Thanks to people and grants, and your new address maybe.}
\shorttitle{Short Title as per APA manual}
\rightheader{Odd-Numbered Page Header}
\leftheader{Even-Numbered Page Header}
%
% Optionally, for keeping track of stuff:
%\note{Draft of \today}
%
% Optional journal-like looking headers 
%
\journal{Journal of nothing}\volume{First and Last Volume}
\ccoppy{Copyright 1998 by Myself}\copnum{Some serial number}
%
% Optionally, use \helvetica for better-looking manuscripts
%
\helvetica
%
% End of definitions, begin document with title and then main text
%
\begin{document}
\maketitle
Here goes the text of the article. 

You can have some text appear differently in each mode, or only appear in
some mode(s).  You can also modify the appearance of tables, figures, or
equations between modes of compilation.  Here's an unexciting example:

\ifapamodeman{This is printed in man mode only}{This is not man mode}.  
You can also use the three-way switch: the current mode is \ifapamode{man}{jou}{doc}.

Sectioning commands are used as in regular \LaTeX.
It is very important that you use these sectioning commands.
Here's a typical example for an experimental psychology paper,
following the (untitled) introductory section:

\section{Experiment 1}
Introduction to this experiment.  When referring to it, type Experiment~1 (with 
capital E and a tie to the number so they won't separate).  However, when 
mentioning the first experiment the ``e'' is lowercase.
\subsection{Method}
You may need some general remarks on method here.  Then use the standard parts.
\subsubsection{Subjects}
Description of subjects.
\subsubsection{Apparatus}
Sometimes it is necessary to give the apparatus a special section.
\subsubsection{Stimuli}
What the subjects saw, heard, or felt.
\subsubsection{Procedure}
What happened to the poor subjects.
\subsection{Results}
Now the numbers: What your measurements showed and all the statistics of it.
\subsection{Discussion}
If your results mean anything, this is the place to talk about it.  In case 
there is little to discuss before the final section (e.g., \section{General 
Discussion} at the end) you may combine results and discussion in a single
\subsection{Results and Discussion} before you go on to the next
\section{Experiment 2}
and so on.

In case you have more than these three levels of headings (sectioning),
you can use the command \headinglevels (e.g., \headinglevels{four} for
four levels).  See the APA manual for how to handle more or fewer heading
levels (the appearance is, naturally, taken care of by apa.cls and you
only need concern yourself with the conceptual divisions).  In case of
more than three levels you'll need the \paragraph (for the fourth level)
and \subparagraph (for the fifth level) sectioning commands of \LaTeX.

\section{Floating things}
\subsection{Figures}
A figure can be included in any way you like, but this class
provides a way to deal automatically with fitting encapsulated 
postscript (EPS) files without worrying about dimensions or mode.
Start your figure or figure* environment as usual
(see the LaTeX book) and then instead of \verb|\epsfig| or 
\verb|\includegraphics| use the new command \verb|\fitfigure|:

An example of a figure that loads a postscript file.  You can use the
t and b options for selectively putting a figure at the top or bottom
of a page.  Always include p after t or b so that you won't risk running
out of space if a figure is too big.  The h option for inserted figures
is not recommended because it's not used in APA journals.

\begin{figure}[tp]
\fitfigure{fig1.eps}
\caption{This is the caption of the figure.}
\label{fig:fig1}
\end{figure}

At any point in the text, before or after the figure, you can
automatically refer to it with the \ref command, for example we can
refer to the above figure as Figure~\ref{fig:fig1}, where the tilde
keeps the word ``Figure'' (which is capitalized according to APA
instructions) together with the reference number.  Use names that are
easy to remember instead of ``fig1'' !  

Always put the \verb|\label| command after (and outside) \verb|\caption|, otherwise
you'll run into trouble with the man mode not finding any labels to
refer to.

\subsubsection{Bitmaps}
In case of a bitmap eps (as opposed to a graph or line drawing), you
probably don't want it scaled in man mode, for best reproduction, so
use \verb|\fitbitmap| instead:

\begin{figure}[tp]
\fitbitmap{bm1.eps}
\caption{This is the caption of the figure.}
\label{fig:fig2}
\end{figure}

\subsection{Tables}
What about a table?  Well, mostly no change from what you are used
to, except that you can use \verb|\thickline| for the top separator
to match the APA-journal look.  Here's an example:

\begin{table}[tbp]
\caption{Some numbers that could be experimental data.}
\label{tab:tab1}
\begin{tabular}{lcc}\thickline
          & \multicolumn{2}{c}{Factor 2} \\ \cline{2-3}
Factor 1  & Condition~A  & Condition~B   \\ \hline
First     & 586 (231)    & 649 (255)     \\
          &    2.2       &    7.5        \\
Second    & 590 (195)    & 623 (231)     \\
          &    2.8       &    2.5        \\ \hline
\end{tabular}
\end{table}

In case of a wide table you would use table* instead of table.
Here's an example:

\begin{table*}[tbp]
\caption{Some more numbers that could be experimental data and are
the same as the previous ones, only more of them.}
\label{tab:tab2}
\begin{tabular}{lccccc}\thickline
          & \multicolumn{5}{c}{Factor 2} \\ \cline{2-6}
Factor 1  & Condition~A & Condition~B & Condition~C & Condition~D & Condition~E \\ \hline
First     & 586 (231) & 649 (255) & 586 (231) & 649 (255) & 586 (231) \\
          &    2.2    &    7.5    &    2.2    &    7.5    &    2.2    \\
Second    & 590 (195) & 623 (231) & 590 (195) & 623 (231) & 590 (195) \\
          &    2.8    &    2.5    &    2.8    &    2.5    &    2.8    \\ \hline
\end{tabular}
\end{table*}

You can get as fancy as you want with tables, just remember not
to use any vertical lines, and to group columns with \verb|\cline| when
they are described by a common header (using \verb|\multicolumn|).  

Use figure* instead of figure for figures that are too wide to
fit comfortably in a single column. 

\section{Section Header}
More text can go here.\footnote{And this is a footnote, used in just
the regular LaTeX way}

\end{document}
