summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/apa/examples.txt
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/apa/examples.txt
Initial commit
Diffstat (limited to 'macros/latex/contrib/apa/examples.txt')
-rw-r--r--macros/latex/contrib/apa/examples.txt367
1 files changed, 367 insertions, 0 deletions
diff --git a/macros/latex/contrib/apa/examples.txt b/macros/latex/contrib/apa/examples.txt
new file mode 100644
index 0000000000..a9566e228f
--- /dev/null
+++ b/macros/latex/contrib/apa/examples.txt
@@ -0,0 +1,367 @@
+%
+% Athanassios Protopapas, January 2006
+% Examples for using apa.cls v1.3.2
+%
+% This file contains examples of using the commands defined in apa.cls
+% Do not use this file as a sample document! It is only meant to show
+% how to use the macros appropriately, and will not even pass through
+% LaTeX successfully, because of many commands that are embedded in
+% the text (unescaped backslashes all over the place).
+% Just use the examples of the commands you need.
+%
+% See apaexample.tex if you want a file that will run through LaTeX and
+% produce sample output compatible with APA style.
+%
+% The class command goes at the top
+%
+\documentclass[man]{apa}
+%
+% Change jou to man/doc for the other modes:
+%
+%\documentclass[jou]{apa}
+%\documentclass[doc]{apa}
+%
+% Here's what I use:
+%\documentclass[nobf,fignum,tt,man]{apa}
+%
+%If you need support for languages other than English, use babel.
+% Do not load babel with \usepackage from your document, because it will
+% clash with apacite. Pass the "babel" option to apa.cls to load along with
+% the language(s) you need.
+% If the main language of your document is different from English,
+% then list it last in the options list. For example, if the paper is in Dutch:
+%\documentclass[man,babel,english,dutch]{apa} % text in Dutch; English available
+% If the main language of your document is English but you need support
+% for another language (e.g., for short passages in Greek using \textgreek):
+%\documentclass[man,babel,greek,english]{apa} % text in English; Greek available
+%
+% 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}
+%
+% John Vokey uses something like this
+\ifapamodeman{%
+\note{\begin{flushleft}
+ Dr.\ Your Whole Name\\
+ Department of Psychology\\
+ At Some University\\
+ Some City, Some Province or State\\
+ Country Postal Code\\
+ e-mail: name@someu.ca\\
+ fax: (area)exchange-number
+ \end{flushleft}}}
+{% else, i.e., in jou and doc mode
+\note{Draft of \today}}
+%
+% If you use A4 paper and care to make a point of it in man mode,
+% use this, courtesy of John Vokey:
+%\ifapamodeman{\setlength{\textwidth}{5.76772in}%
+% \setlength{\textheight}{9.19291in}}{}
+%
+% Optional journal-like looking headers
+%
+\journal{Journal of nothing}\volume{First and Last Volume}
+\ccoppy{Copyright 2006 by Myself}\copnum{Some serial number}
+%
+% End of definitions, begin document with title and then main text
+%
+\begin{document}
+\maketitle %% First thing after \begin{document}
+Here goes the text of the article. %% Start immediately after \maketitle
+ %% no blank line between title & text
+
+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
+\includegraphics use the new command \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. Don't forget \usepackage{graphicx} in your preamble!
+(not epsfig, not graphics).
+
+\begin{figure}[tp]
+\fitfigure{fig1} %% You could use {fig1.eps} here but see note below
+\caption{This is the caption of the figure.}
+\label{fig:fig1}
+\end{figure}
+
+There is absolutely no reason to complicate your figures any further
+than this simple example. Just insert your nice and descriptive
+caption text and the filename. If you omit the .eps extension for the
+filename (as in the example), then if you happen to use pdflatex it
+will automatically load the corresponding .pdf graphic file (assuming
+you have made one with eps2pdf), while "regular" dvips will load the
+.eps file.
+
+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 \label command after (and outside) \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 \fitbitmap instead:
+
+\begin{figure}[tp]
+\fitbitmap{bm1.eps} %% ".eps" not necessary -- see note above
+\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 \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\tabfnm{a}\\
+Second & 590 (195) & 623 (231) \\
+ & 2.8 & 2.5\tabfnm{b}\\ \hline
+\end{tabular}
+\tabfnt{a}{Notes to table material are easy.}
+\tabfnt{b}{Use as many as you like, just remember to number them.}
+\end{table}
+
+In case your data won't fit in a single column (in jou mode) use a
+wide table (environment 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 \cline when they are
+described by a common header (using \multicolumn). There's rarely a
+need to get more complicated than these examples. Avoid nesting
+tabular environments, it's a mess and you'll have to use the notab
+option to make it work (so that internal tabulars don't stretch to the
+line width). Be creative with \multicolumn instead.
+
+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}
+
+Suppose this is the end of our document, and there are appendices.
+Remember, appendices come *after* the bibliography. But there's no
+text between the bibliography and the appendix part. Don't use
+a \bibliographystyle because apa.cls automatically loads apacite.
+
+\bibliography{mybibfile}
+
+% Now the appendices. First we have to signal the pass into the
+% appendix part. Then you'll have to give each appendix a title
+% thinking of it as a section.
+
+\appendix %% Just like that, in LaTeX spirit. No parameters or titles.
+
+\section{Title of first Appendix}
+This is the text of the first appendix. You can present your
+mathematical derivations, raw materials, or whatever. You are free to
+use figures and tables in the usual way. apa.cls will number them
+correctly and include them in the table and figure lists where they
+belong. Isn't apa.cls wonderful?
+
+\section{List of stimuli}
+Just to show that another appendix is really just another section.
+Also, it's a good opportunity to show how longtable should be used.
+Remember, you must include the longtable option with the apa class if
+you need to use longtable, and copy the special endfloat.cfg supplied
+with apa.cls to the working document directory. Also, keep in mind,
+it only works in man mode.
+
+\begin{longtable}{lcc}
+\caption{One sample caption for the sample long table.}
+\label{tab:ltab}
+\\ \thickline
+ & \multicolumn{2}{c}{Type} \\ \cline{2-3}
+Condition & Cond-A & Cond-B \\ \hline
+\endfirsthead
+\\ \thickline
+ & \multicolumn{2}{c}{Type} \\ \cline{2-3}
+Condition & Cond-A & Cond-B \\ \hline
+\endhead
+\endfoot
+\thickline
+\endlastfoot
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+Cond-A & Stim-1 & Stim-2 \\
+ & 1.0 & 2.0 \\
+Cond-B & Stim-3 & Stim-4 \\
+ & 3.0 & 4.0 \\ \hline
+\end{longtable}
+
+\end{document}