Reference sheet for natbib usage

1 Reference sheet fornatbibusage(Describing version from 2007/10/30)For a more detailed description of thenatbibpackage, LATEX the source is a reimplementation of the LATEX\citecommand, to work with both author yearand numerical citations. It is compatible with the standard bibliographic style files, such , aswell as with those forharvard,apalike,chicago,astron,author date, and of with\usepackage[options]{ natbib }. See list ofoptionsat the bibliography stylesI provide three to replace the standard LATEX numerical commandsThenatbibpackage has two basic citation commands,\citetand\citepfortextualandpar entheticalcitations, respectively. There also exist the starred versions\citet*and\citep*that print the full authorlist, and not just the abbreviated one. All of these may take one or two optional arguments to add sometext before and after the citation.\citet{jon90} Jones et al.

2 (1990)\citet[chap.~2]{jon90} Jones et al. (1990, chap. 2)\citep{jon90} (Jones et al., 1990)\citep[chap.~2]{jon90} (Jones et al., 1990, chap. 2)\citep[see][]{jon90} (see Jones et al., 1990)\citep[see][chap.~2]{jon90} (see Jones et al., 1990, chap. 2)\citet*{jon90} Jones, Baker, and Williams (1990)\citep*{jon90} (Jones, Baker, and Williams, 1990)Multiple citationsMultiple citations may be made by including more than one citation key in the\citecommand argument.\citet{jon90,jam91} Jones et al. (1990); James et al. (1991)\citep{jon90,jam91} (Jones et al., 1990; James et al. 1991)\citep{jon90,jon91} (Jones et al., 1990, 1991)\citep{jon90a,jon90b} (Jones et al., 1990a,b)1 Reference sheet :natbib2 Numerical modeThese examples are for author year citation mode. In numerical mode, the results are different.\citet{jon90} Jones et al. [21]\citet[chap.~2]{jon90} Jones et al. [21, chap. 2]\citep{jon90} [21]\citep[chap.]

3 ~2]{jon90} [21, chap. 2]\citep[see][]{jon90} [see 21]\citep[see][chap.~2]{jon90} [see 21, chap. 2]\citep{jon90a,jon90b} [21, 32]Suppressed parenthesesAs an alternative form of citation,\citealtis the same as\citetbutwithout parentheses. Similarly,\citealpis\citepwithout \citenumcommand prints the citation number, without parentheses, even in author year mode, andwithout raising it in superscript mode. This is intended to be able to refer to citation numbers withoutsuperscripting them.\citealt{jon90} Jones et al. 1990\citealt*{jon90} Jones, Baker, and Williams 1990\citealp{jon90} Jones et al., 1990\citealp*{jon90} Jones, Baker, and Williams, 1990\citealp{jon90,jam91} Jones et al., 1990; James et al., 1991\citealp[pg.~32]{jon90} Jones et al., 1990, pg. 32\citenum{jon90} 11\citetext{priv.\ comm.} (priv. comm.)The\citetextcommand allows arbitrary text to be placed in the current citation parentheses.

4 This maybe used in combination with\ citationsIn author year schemes, it is sometimes desirable to be able to refer to the authors without the year, or viceversa. This is provided with the extra commands\citeauthor{jon90} Jones et al.\citeauthor*{jon90} Jones, Baker, and Williams\citeyear{jon90} 1990\citeyearpar{jon90} (1990)Forcing upper cased namesIf the first author s name contains avonpart, such as della Robbia , then\citet{dRob98}produces dellaRobbia (1998) , even at the beginning of a sentence. One can force the first letter to be in upper case withthe command\Citetinstead. Other upper case commands also sheet :natbib3when\citet{dRob98} della Robbia (1998)then\Citet{dRob98} Della Robbia (1998)\Citep{dRob98} (Della Robbia, 1998)\Citealt{dRob98} Della Robbia 1998\Citealp{dRob98} Della Robbia, 1998\Citeauthor{dRob98} Della RobbiaThese commands also exist in starred versions for full author aliasingSometimes one wants to refer to a Reference with a special designation, rather than by the authors, asPaper I, Paper II.

5 Such aliases can be defined and used, textual and/or parenthetical with:\defcitealias{jon90}{Paper~I}\citet alias{jon90} Paper I\citepalias{jon90} (Paper I)These citation commands function much like\citetand\citep: they may take multiple keys in theargument, may contain notes, and are marked as citation style and punctuationUse the command\setcitestylewith a list of comma-separated keywords (without spaces) as mode:authoryearornumbersorsuperBraces:ro undorsquareoropen={char},close={char}Bet ween citations:semicolonorcommaorcitesep={cha r}Between author and year:aysep={char}Between years with common author:yysep={char}Text before post-note:notesep={text}Defaults areauthoryear,round,comma,aysep={;},yyse p={,},notesep={, }Example 1,\setcitestyle{square,aysep={},yysep={; }}changes the author year output of\citep{jon90,jon91,jam92}into [Jones et al. 1990; 1991, James et al. 1992].

6 Example 2,\setcitestyle{notesep={; },round,aysep={},yysep={;}}changes the output of\citep[and references therein]{jon90}into (Jones et al. 1990; and references therein).Other formatting optionsRedefine\bibsectionto the desired sectioning command for introducing the list of references. This isnormally\section*or\chapter*.Define\bi bpreambleto be any text that is to be printed after the heading but before the actual list \bibfontto be a font declaration, \smallto apply to the list of sheet :natbib4 Define\citenumfontto be a font declaration or command like\itshapeor\ \bibnumfmtas a command with an argument to format the numbers in the list of references. Thedefault definition is[#1].The indentation after the first line of each Reference is given by\bibhang; change this with the\ vertical spacing between references is set by\bibsep; change this with the\ indexing of citationsIf one wishes to have the citations entered in file, it is only necessary to issue\citeindextrueat any point in the document.

7 All following\citecommands, of all variations, then insert the correspondingentry to that file. With\citeindexfalse, these entries will no longer be withchapterbibpackageThenatbibpackage is compatible with thechapterbibpackage which makes it possible to have severalbibliographies in one package makes use of the\includecommand, and each\included file has its own order in which thechapterbibandnatbibpackages are loaded is provides an optionsectionbibthat puts the bibliography in a\section*insteadof\chapter*, something that makes sense if there is a bibliography in each chapter. This option will notwork whennatbibis also loaded; instead, add the option \included file must contain its own\bibliographycommand where the bibliography is to database files listed as arguments to this command can be different in each file, of course. However,what is not so obvious, is that each file must also contain a\bibliographystylecommand, with possiblydiffering of version , the citation style, including mode (author year or numerical) may also differ betweenchapters.

8 The\setcitestylecommand can be issued at any point in the document, in particular indifferent and compressing citationsDo not use thecitepackage withnatbib; rather use one of the optionssort,compress, orsort& also work with author year citations, making multiple citations appear in their order in the author list on first citationUse optionlongnamesfirstto have first citation automatically give the full list of this for certain citations with\shortcites{key-list}, given before the first sheet :natbib5 Local configurationAny local recoding or definitions can be put is read in after the main package that can be added to\usepackageround(default) for round parentheses;squarefor square brackets;curlyfor curly braces;anglefor angle brackets;semicolon(default) to separate multiple citations with semi-colons;colonthe same assemicolon, an earlier mistake in terminology;commato use commas as separators;authoryear(default) for author year citations;numbersfor numerical citations;superfor superscripted numerical citations, as inNature;sortorders multiple citations into the sequence in which they appear in the list of references;sort&compressassortbut in addition multiple numerical citations are compressed if possible (as 3 6, 15);compressto compress without sorting, so compression only occurs when the given citations would producean ascending sequence of numbers;longnamesfirstmakes the first citation of any Reference the equivalent of the starred variant (full authorlist) and subsequent citations normal (abbreviated list);sectionbibredefines\thebibliograph yto issue\section*instead of\chapter*; valid only for classeswith a\chaptercommand; to be used with thechapterbibpackage;nonamebreakkeeps all the authors names in a citation on one line.

9 Causes overfull hboxes but helps withsomehyperrefproblems.