diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/apa/apacls.txt')
-rw-r--r-- | Master/texmf-dist/doc/latex/apa/apacls.txt | 284 |
1 files changed, 284 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/apa/apacls.txt b/Master/texmf-dist/doc/latex/apa/apacls.txt new file mode 100644 index 00000000000..c05f8ae7b00 --- /dev/null +++ b/Master/texmf-dist/doc/latex/apa/apacls.txt @@ -0,0 +1,284 @@ +This is file apacls.txt, which contains instructions for using the +APA LaTeX2e class file apa.cls + + Athanassios Protopapas ******* Version 1.3.0 August 2002 + + +Introduction + + apa.cls is a LaTeX2e class file that makes your document conform to + the APA Publication Manual (Fifth Edition, 2002) specifications for + manuscripts or to the APA journal look found in journals like the + Journal of Experimental Psychology etc. In addition, it provides a + regular LaTeX-like output with a few enhancements and APA-motivated + changes. The headings and enumeration/seriation code is taken from + theapa.sty by Young U. Ryu. + + +Description + + a) Manuscript mode (man) + + apa.cls typesets a title page, abstract page, text body, then + references, author notes, footnotes, tables, figure captions, and + figures. All text is double spaced. The title page contains + (centered) the title, author name, affiliation, short title, and the + running head (automatically capitalized). A note is inserted in + place of each table and figure in the text. + + The title is printed as a heading at the beginning of the text (don't + include an extra \section, because the introduction is not supposed + to be titled in printed articles). \leftheader is ignored in + manuscript mode. The contents of \note are printed under the author + names and affiliations, typically the date of submission. The "Author + Notes" page contains the contents of \acknowledgements. A footnote + page is only produced if there is at least one footnote in the text. + + b) Journal mode (jou) + + apa.cls typesets the text in double-sided, double column format, with + an appropriately centered title, author names, affiliations, note, + and abstract. The contents of acknowledgements are printed as + footnotes in a box at the lower left corner of the first page. + Journal-like headers can also be produced on the first page. + Dimensions and overall "look" are modeled after JEP:HPP. The purpose + of this mode is to produce readable and reasonably condensed output + for double-sided xeroxing and distribution. + + c) Document mode (doc) + + apa.cls typesets the text in single-sided, single-column format, with + an appropriately centered title, author names, affiliations, note, + and abstract on the first page. The contents of acknowledgements are + printed at the bottom of the first page. Section headings and + enumeration follow the APA guidelines and floats (figures and tables) + are inserted in the text where they are defined, as in regular LaTeX + articles. + + The purpose of this format is to provide hardcopies during the + development of articles that are later going to be submitted (using + the manuscript format) and distrubuted (using the journal + format). The advantage over using a regular article class is that all + the extra definitions are supported and no changes need thus be made + to the text other than the format parameter. + + +Known bugs and restrictions: + + - Up to four affiliations (for article author(s)) are supported. + - There seems to be an incompatibility between apacite and babel. + Since apacite is necessary, you may not be able to use babel. + - No provision for A4 paper. See examples for a workaround. + + +Other necessary files: + + For all modes you need apacite.sty and apacite.bst. + + For manuscript mode, you need endnotes.sty and endfloat.sty + + For journal mode, you need, optionally, pslatex.sty (or times.sty and + mathptm.sty), ftnright.sty, fancyhdr.sty (for first page headers), + and flushend.sty + + +To use this class, include one of the following + + \documentclass[jou]{apa} for the two-column output (Times-Roman default) + \documentclass[man}{apa} for the manuscript (double-spaced) output + \documentclass[doc]{apa} for regular document (in computer modern) + + at the beginning of your file (instead of {article}), then define the + title, author, etc. (see below), and start with + + \maketitle + + right after \begin{document}, immediately followed by the first + paragraph of you text (no blank line). Do not use a + \bibliographystyle command, because apacite is selected automatically + (for backwards compatibility, any existing \bibliographystyle command + is ignored and a warning is issued). + + The journal format uses Times Roman by default (it does look like + published after all); if you don't have pslatex.sty or times.sty, or + if you just prefer computer modern, add notimes after the jou option + in the class line: \documentclass[jou,notimes]{apa} (notimes has no + effect in modes other than jou and may be left in when switching) + + Manuscript format uses Computer Modern by default but can use + Helvetica or typewriter look by using the options helv or tt, + respectively. I find the result with either of these much more + "manuscript"-like but that's a matter of taste. These options have + no effect in modes other than man and may be left in when switching. + + +The following commands are defined and should/may be used: + + 1. Required for document compilation + + \title{Title} + \author{Author Name(s)} + or \twoauthors{First Author(s)}{Second Author(s)} + or \threeauthors{John and Jim}{Mary and Sue}{Nick} + or \fourauthors{Helen}{Dick}{Tracy and Larry}{James Bond} + \affiliation{Department\\ University} + or \twoaffiliations{Affiliation of 1st Author(s)}{Affil. of 2nd Author(s)} + or \threeaffiliations{U of A}{U of B}{U of C} + or \fouraffiliations{My Company}{Your Department}{Heaven}{Earth} + + \maketitle % right after \begin{document} + + 2. Strongly recommended (required by APA) + + \abstract{Abstract} + \acknowledgements{Author notes etc.} + \rightheader{Running head} % defaults to title + \shorttitle{Short title} % defaults to title + \leftheader{Authors} % defaults to author + + 3. Optional, possibly helpful + + \note{Draft/submission date, etc.} % To add notes on first page + \thickline % Use in tables for the top line + \centeredcaption{width}{caption-text} % Used with double-column figures + % to create centered captions + % narrower than \textwidth + + \fitfigure[optional-height]{eps-filename} % Automatically fit a postscript + % figure; load graphicx and use + % instead of \includegraphics + \fitbitmap[optional-height]{eps-filename} % Same as \fitfigure but won't scale + % figure in man mode for best + % reproduction of bitmap figures + + \ifapamode{man-code}{jou-code}{doc-code} % Do different things depending on + \ifapamodeman{man-mode-code}{doc-or-jou-code} % mode---you shouldn't have to use + \ifapamodejou{jou-mode-code}{doc-or-man-code} % any of these but they're here if + \ifapamodedoc{doc-mode-code}{man-or-jou-code} % you want them. Parameters can + % be left empty to do nothing + + \journal{Journal name or other note} % Top left header on page one in + % jou/doc mode, ignored in man mode + \volume{Volume, number, pages} % Top left, under content of \journal + \ccoppy{Copyright notice etc.} % Top right header in jou/doc p. 1 + \copnum{Your hovercraft is full of eels} % Top right, under content of \ccoppy + + \tabfnm{a} % Put a note mark inside a table cell + \tabfnt{a}{Note text} % Put the mark and text for a table note + \apavector{A} % Format a symbol as vector by APA rules + \appendix % Standard LaTeX usage, starts off + % appendix section(s) + + +The following options are available: + + These options must be combined with one of jou, man, doc. + + notimes : Effective in jou mode, cancels loading pslatex (or times) and + uses computer modern fonts. + nosf : Effective in man mode, neutralizes the \helvetica command. + fignum : Effective in man mode, adds figure numbering to the figure pages. + Makes it easier to refer to figures and I recommend it for the + reviewers' copies, but for the original figures you need to have + them printed without this and write the number with pencil on the back. + notab : Effective in jou mode, cancels the automatic stretching of tabular + environments to the width of their enclosing float. + nobf : Effective in man mode, turns off boldface in section headers + helv : Effective in man mode, uses Helvetica as the base typeface + tt : Effective in man mode, uses a typewriter base typeface + longtable: Only usable in man mode, loads longtable.sty if you *really* must + use long tables in your manuscript. See special note below + floatmark: Effective in man mode, inserts placeholders for floats in text + ("Insert Figure X about here" -- no longer required by APA) + +Notes on usage: + + If there is more than one author but all in the same department, use + the \author command with all names and the \affiliation command. If + there are people from two different departments, use the \twoauthors + and \twoaffiliations commands to group them appropriately. For three + affiliations use \threeauthors and \threeaffiliations, and guess what + for four. + + Default sectioning maps \section, \subsection, and \subsubsection to + the three-level heading definitions of the APA manual. If you need + more/fewer heading levels, you can use the command + \headinglevels{four} (or any number between one and five---spelled + out---instead of four) and then use \paragraph and \subparagraph for + the lower-level sectioning. Don't bother to \label your sections + because they can't be \ref'd since they are not numbered in APA style. + + When a figure is too wide for a single column, use a double-column + figure (\begin and \end {figure*} instead of {figure}). When using + double column figures, it looks better if you use \centeredcaption + instead of caption, with the first parameter about equal to the width + of the float (table or figure). This makes no difference in + manuscript mode. + + It is still *your* responsibility to format the tables in accordance + with the APA guidelines (e.g., no vertical lines, and so on) and + precede the actual table body with its caption (i.e., use \caption + *before* \begin{tabular} in tables, or the results won't be + conforming to the APA requirements for tables). Because a paragraph + break is inserted in manuscript mode (along with the "insert + table/figure" note), don't define tables in the middle of a + paragraph. + + Remember to use \label for floats *after* the caption (and not inside it!) + + For instructions on using the various citation forms get apacite.tex, + testAPA.tex, and readme.apa from the CTAN mirror near you. For + instruction on using APA enumeration and seriation read apaenum.txt + in this distribution. + + If you need to use additional options for article.cls, use them with + the apa.cls options and they will be automatically passed along to + article.cls + + Notes in tables: There is a semi-automatic way to include notes in + tables such as, for example, to indicate levels of significance. The + command \tabfnm{X} inside a table cell (tabular environment) produces + the note mark. Use \tabfnt{X}{Note text} immediately before or after + \end{tabular} inside the table environment to produce the note text. + See example file. + + Appendices: Use the command \appendix only once, at the point where + your (first) appendix starts. Then use \section{Appendix Title} to + start each appendix section (even if there is only one). You may use + cross-references to appendixes, because they are numbered, if there + are more than one. The command \label{app:xxx} after the appendix + \section sets the label. Refer to it with "Appendix~\ref{app:xxx}" + anywhere in the article. + + If you use vectors, the command \apavector{X} will make your life easier. + + Long tables: By popular demand, longtable now (sort of) works with + apa.cls. You must *not* load the longtable package yourself; + instead, pass the longtable option to apa.cls (due to precedence + requirements for proper endfloat function and cross-definitions). + Since longtable only works in single-column documents it can only be + used with man mode. Unfortunately the ifapamode commands won't work + to keep a single table body and apply a mode-specific (table or + longtable) environment because of illegal cross-nesting with + environment begin/end. In fact the table environment won't even work + inside in ifapamode argument, which makes it impossible to have a + single file that can be processed for both man and jou. This defeats + the purpose of apa.cls, so only resort to longtable if you absolutely + have to. You will need the supplied endfloat.cfg to use it. + + +Feedback: + + Send me comments or bug reports (preferably with fixes) at: + protopap@ilsp.gr + + +Example of usage: + + See file examples.txt... + PLEASE, read file examples.txt, it will probably solve your problems. + + +Thanassi Protopapas +August 30, 2002 + |