Skip to content

Instantly share code, notes, and snippets.

@rmzelle
Created June 16, 2011 18:30
Show Gist options
  • Save rmzelle/1029888 to your computer and use it in GitHub Desktop.
Save rmzelle/1029888 to your computer and use it in GitHub Desktop.
NEW
``disambiguate-add-year-suffix`` [Step (4)]
If set to "true" ("false" is the default), an alphabetic year-suffix is
added to ambiguous cites (e.g. "Doe 2007, Doe 2007" becomes "Doe 2007a, Doe
2007b") and to their corresponding bibliographic entries. The assignment of
the year-suffixes follows the order of the bibliographies entries, and
additional letters are used once "z" is reached ("z", "aa", "ab", ..., "az",
"ba", etc.). By default the year-suffix is appended to the cite, and to the
first year rendered through ``cs:date`` in the bibliographic entry, but its
location can be controlled by explicitly rendering the "year-suffix" variable
using ``cs:text``. If "year-suffix" is rendered through ``cs:text`` in the
scope of ``cs:citation``, it is suppressed for ``cs:bibliography``, unless
it is also rendered through ``cs:text`` in the scope of ``cs:bibliography``,
and vice versa.
OLD
``disambiguate-add-year-suffix`` [Step (4)]
If set to "true" ("false" is the default), a year-suffix is added to
ambiguous cites (e.g. "Doe 2007, Doe 2007" becomes "Doe 2007a, Doe 2007b").
The placement of the year-suffix, by default appended to each cite, can be
controlled by explictly rendering the "year-suffix" variable using
``cs:text``.
@rmzelle
Copy link
Author

rmzelle commented Jun 18, 2011

I'll have to think about it a bit more.

@rmzelle
Copy link
Author

rmzelle commented Jun 20, 2011

The description of "disambiguate-add-year-suffix" should only discuss the reason for disambiguation if it differs from the reason for the other disambiguation options. Any shared requirements that activate disambiguation should be discussed in the introduction of the disambiguation section of the spec.

Would it be correct to say that, for all disambiguation methods, except for "disambiguate-add-givenname" with "givenname-disambiguation-rule" set to "all-names", "all-names-with-initials", "primary-name", or "primary-name-with-initials", disambiguation is performed to create an unambiguous link between the cite and the target bibliographic entry?

@fbennett
Copy link

Yes. In those four cases, adding initials or full given names is more aggressive than strictly necessary for resolving cite/bib ambiguities. If one were to be picky, it would be a little more accurate to say "disambiguation is performed only when needed to create an unambiguous link between the cite and the target bibliographic entry".

@bdarcus
Copy link

bdarcus commented Jun 20, 2011 via email

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment