tapas

The name stands for to APA, and the s is for added deliciousness. It's a small program used for compiling refer output into the APA reference format for groff or alike.

The program reads refer output from stdin and prints the compiled result to stdout.

Note that tapas doesn't currently fully implement APA. I wrote this program because I needed to reference articles using APA instead of MLA, and in time I intend to fully implement APA.

Installation

Edit config.mk to match your local setup (tapas is installed into the /usr/local namespace by default), then simply enter the following command to install (if necessary as root):

 make clean install

Customization

tapas can be customized by creating a custom config.h and (re)compiling the source code.

Usage

Tapas is intended to run in a pipe chain directly after refer, like so:

 ... | refer | tapas | ... | troff

I've added some customization using ds-strings for tapas. These are the following:

  • .ds APA_IN ...
    Used for specifying the word for "In" when referring to articles in books.
  • .ds APA_AN ...
    Used for specifying the word or symbol for "and/&" when concatenating authors.
  • .ds APA_MS ...
    Used for specifying the macro set output e.g. 'ms'. This is not currently fully developed, and only has support for 'ms'.
  • .ds APA_HE ...
    Used for specifying the heading text e.g. 'References'.

License

The program is licensed under the MIT license.

get source here.