TemplateNotes Comment | Log in | Print | Subscribe to this page

Below: CiteInPages templates - Journal templates - Other templates & scripts

CiteInPages default templates (v. 1.0)

There are a wide variety of reference types, with varying availability of information even within a particular reference type. Handling all these possibilities in a template is challenging and can lead to very complex templates. The templates currently provided with CiteInPages are starting points for development, though they should handle common reference types and will hopefully respond gracefully when information is incomplete. I'm happy to receive notifications about problems, suggestions for improvement, or recommended additions to the templates. This page will be a repository of commentary on templates and perhaps a link to additional templates as they become available. At the moment, this section contains brief notes on the current CiteInPages templates and the next section has links some additional templates and scripts that I find useful.

Some of the BibTeX reference types in BibDesk don't seem to have an optimal complement of default fields. Additional fields from the full available list can be added manually, and I have done that to get the data I want into the bibliographic records (as detailed in the notes below). These fields are used by the templates, so you also may need to add those fields for some types of bibliographic records, using the little gear menu at the bottom left of the reference details window in BibDesk, so that the templates will work as intended. You may also need to edit some imported references to get the information into the correct fields. This affects only some reference types, as outlined below, and if you don't use those, you don't need to pay attention to this. Without the field changes, CiteInPages and the templates will still work, but the bibliography list may be missing some data until you track down and edit those references. If there's anything particularly non-kosher about what I'm doing, I'm happy to receive suggestions for more appropriate strategies.

Notes:

  • For inbook I don't use the "chapter" field. I put the chapter or section title in the "title" field (which makes it appear as I wish in BibDesk's bibliography window) and I put the title of the book in the "booktitle" field, which I add manually to the inbook record.
  • For inproceedings I use "title" to hold the title of the article and "booktitle" to hold the title of the proceedings volume.
  • I use conference for conference presentations, as I don't have the need to refer to conferences as a whole. In that case the "title" is the presentation title and I use "booktitle" for the conference name. I've also added an "address" field that is the location of the conference.
  • Technical reports, electronic, web page and generic references are anticipated to have at least one link to an external electronic source for the reference. If so, its url will be displayed with appropriate text (such as "Available from:"). If you include a "lastchecked" field, the template will use that as the last checked date for the link. If a reference has multiple external links, the top-leftmost link in the thumbnails pane of the details window will be used, and the order of links can be changed by dragging in this pane. Local files such as PDFs on the local machine don't figure in to this, so their position among the thumbnails doesn't matter. Note that the order of display of thumbnails in the main window is fixed and does not respond to changes in the thumbnail order of the details window.
  • The template for electronic references can handle the usual complement of journal article fields as optional data, so it should be able to correctly format references to electronic journals that have a journal name, volume number, date or issue number and pages or article sequence number (the latter should go in a "pages" field).
  • For webpage references, I add authors (optional), title (page title) and booktitle (web site name) fields.
  • Fields that may have missing data have been made optional with associated optional formatting and punctuation as much as possible. I'm happy to receive notes about particular reference configurations that have problems.

More later...

Journal templates

Other templates

Preview template: previewTemplate.zip (8K zip file)

I use this RTF template, which is based on the CiteInPages AMAstyle template, for the preview pane in BibDesk. It compactly displays the things of greatest interest to me in a form that's easy to read. It includes the title in bold, a full citation, the cite key and reference type right aligned in small gray type, and optionally the abstract, any annotations and Skim notes. The font is Optima, which I like for easy reading on screen at small sizes. The hanging indent works well with multiple selections. An Applescript is included that uses the template to display lists of selected articles in TextEdit, including abstracts, annotations and Skim notes. The illustration below is scaled down; at full size it is quite readable. The Skim notes are the bullet points under the abstract and brief annotation, and they include the note type, PDF page of origin and for highlighted notes, the text highlighted.

To use, unzip and put the RTF file in ~/Library/Application Support/BibDesk/Templates. If you wish to use the Applescript, place it in ~/Library/Application Support/BibDesk/Scripts. The script should work from BibDesk's script menu with no configuration; to use the template in the preview pane, it must be installed as an RTF export template in BibDesk's Templates preference. Stepwise instructions for installing export templates are included in the readme file in the CiteInPages download and instructions are available from BibDesk's manual. Once the template is installed, go to the Display preference under Preview Pane Display, choose Template, then from the popup menu choose the name of the template you installed.

Template for printable summary view in Pages: SummarizeInPages.zip (8K zip file)

This template/Applescript uses a similar style to the template above to display lists of references and associated information, except that it's designed to work with the Pages word processor, the text is fully justified and sized for printing, and a two-inch margin is left down the right side for note-taking after printing. Unzip and place the template and script in BibDesk's Templates and Scripts folders, respectively, as above. The script should require no configuration.

This page was last edited 8 years ago by harrison. View page history
Subject:


Comment:


    with signature

Powered by Zwiki, Zope, Python, and Mac OSX