After going through all the dependent styles, I decided to also touch
up the metadata of the independent styles. The most notable changes:
- All independent styles now have a documentation link, and this
should be a requirement going forward. - All styles, dependent and independent, now have a default-locale,
except those that belong to one of two categories: first, some CSL
styles are used with more than one locale, such as those of
multilingual journals. These now carry an XML comment, like
( https://github.com/citation-style-language/styles/blob/master/studii-teologice.csl
)
The second category are the “popular” styles, such as the APA,
Chicago, IEEE and Vancouver styles.
A complete list of the styles without a default-locale (currently 50),
together with a frequency count of the locale codes in use with
"default-locale", can be found at
https://gist.github.com/rmzelle/5485798. Also here I would like to
require each new style to have a default-locale set, unless the style
should localize.
All styles that have a non-English default-locale now have the
language appended to the style title, e.g.
( https://github.com/citation-style-language/styles/blob/master/juristische-zitierweise.csl
)
We probably need to figure out a way to mark the styles without a
default-locale, so that users know that these styles can automatically
localize. Perhaps we should add something to the titles, like
"(International)"?
- I further modified
https://github.com/citation-style-language/schema/blob/master/csl-repository.rnc,
which can be used for validation instead of csl.rnc. It only validates
styles that have the elements in cs:info in a particular order (every
now and then I reorder the elements in cs:info for all repository
styles, using https://github.com/citation-style-language/utilities/blob/master/csl-reindenting-and-info-reordering.py
). While slightly inconvenient, this schema is more strict: e.g. for
independent styles it requires one “self” link, allows any number of
"template" links, and requires at least one “documentation” link. We
can’t test things like this with the regular schema. All styles now
validate against this stricter schema. - Dan Stillman recently expressed some concern over my abundant
renaming of file names and IDs of independent styles (having finished
my trawl of the repository this should now be mostly a thing of the
past). To allow CSL clients to redirect users to renamed styles, I
introduced https://github.com/citation-style-language/styles/blob/master/renamed-styles.json
. This simple JSON file uses the format “[old style file name]”: “[new
style file name]” (without “.csl” extensions), and uses a single
namespace for both dependent and independent styles.
(I have been a bit picky about including “The” in the title of journal
styles; when in doubt, I look at journal cover. If the cover uses
"The", I include it in the style title and style ID) - I removed the “generic-base” field from a bunch of styles. IMHO it
should only be used for journals that are not specific to any
particular field of study. - I plan to remove a few of the “law” styles once Frank has released
his MLZ book and his MLZ styles come into use. It seems to me that the
"law" styles for Zotero are generally of limited use, and it would
probably be better to steer folks who need legal citation support to
MLZ.
We still have some curating to do for the Elsevier and Springer
styles, but otherwise the house is pretty much put in order.
Rintze