1 Introduction

Some citation packages like Patrick Daly’s natbib provide alternative forms of the \cite command: for example, there’s a cite-as-noun style using the macro \citet whereby \citet{viton:2000} would appear in the text as Viton (2000) while \cite{viton:2000) would appear as (Viton, 2000). Other forms may also be provided, for example one in which \citename{viton:2000) produces just Viton, or \citeyear{viton:2000) which produces just the year, 2000 (these last two are not available in natbib but do appear in Peter Williams’ harvard system; in this system the noun form is called \citeasnoun) . SWP has no facilities to support these directly, but there is a way to use them, as I’ll show here.

2 What do you want to do?

There are two situations you might encounter.

2.1 Changing all citations

First, you want all the citations to in your document to be of a given form, for example noun-like. This is extremely easy to set up: you just redefine the meaning of the \cite command. Suppose you want to use natbib’s cite-as-noun form throughout your document. Then just put the following line in the document preamble (if you load the natbib package in the preamble, as opposed to the Typeset -> Options and packages dialog, be sure that this command comes after loading the package):

\let\cite=\citet

where \citet is the macro you want to use for all your citations. You can now write your document as usual, and when you typeset it, all the citations will come out in the changed (here, \citet) form.

2.2 Mixing citation types

If you want to mix citation forms in your document, it’s a bit more complicated. The solution I’ve come up with is to create a series of Fragments, each one of which redefines the meaning of the \cite command. Then when you want to use one of the non-standard forms, you insert the appropriate fragment, followed by the \cite command generated by SWP. The only downside to this is that you must be consistent, and use one of the Fragments each time you enter a \cite: if you don’t do this, then \cite will be translated to whatever form you used last, which may not be what you want. In particular, if you want to use the standard \cite after you’ve used one of the additional forms, you’ll need to define a Fragment for it, too.

The new Fragments are very simple. Suppose you want to create a fragment for the \citet macro.

• Create a TeX field either from the Typeset toolbar, or do Insert -> Typeset object -> TeX Field (this is for SWP5: earlier versions may not have the Typeset object choice).
• In the resulting dialog,
  • Check Encapsulated
  • Give the fragment a descriptive name, like NounCite
  • In the body of the dialog enter

    \def\cite#1{\citet{#1}}

  • Click OK.
  • Now save it as an SWP Fragment: with the field selected, do File -> Save fragment and give the fragment a name.

Repeat this for any other cite forms you plan to use.

Next, you should create a fragment for the standard form of the \cite command. Just how you do this depends on the facilities provided by the citation package you’re using. There are two possibilities.

• The citation package provides its own alias for the standard form. For example, natbib provides \citep for a parenthesized citation, where \citep{viton:2000} produces (Viton, 2000). In this case, all you need to do is define a Fragment for this macro, too, following the model above.
• Some citation packages — eg, harvard — do not. In this case you need to set one up for yourself. Here’s how:
  • First, decide what to call it: I suggest \citeOrg, which is not, so far as I know, used by any of the citation packages. So create a fragment for this, just as before: the operative line would be

    \def\cite#1{\citeOrg{#1}}

    Then, when you need to use the original form of the citation, you’d place the CiteOrg fragment before SWP’s cite field.

  • Finally, you must arrange for \citeOrg — or whatever you decided to call it — to be aliased to \cite. In the document’s Preamble — and after you’ve loaded the citation package (eg, harvard) if you load it in this dialog — add the following line:

    \let\citeOrg=\cite

  If you plan to use this facility regularly, you can add this line to the shell documents which already load the citation package (in our example, harvard). If you never actually use the new Fragments, nothing will change.