Reconcile Zotero item types with CSL schema

[stakats]

I've been creating a new Chicago Manual of Style CSL using the new schema. Here's what I've noticed so far:
Some Z item types are missing from CSL schema (e.g. blog entries, dictionary and encyclopedia entries, magazine articles), and others do not seem to be recognized (e.g. "thesis" falls back to "book" and ignores thesis layout type).

[simon]

If you have code such as:

      <choose>
        <if type="book">
          <!--Code for book here-->
        <else-if type="thesis">
          <!--Code for thesis here-->
        </else-if>
      </choose>

Then the code for book gets executed in any case, since all types have both an optional type (e.g., "thesis") and a fallback type ("book," "chapter," or "article"). So type="book" evaluates to true for a thesis. The way around this is to code:

      <choose>
        <if type="thesis">
          <!--Code for thesis here-->
        <else-if type="book">
          <!--Code for book here-->
        </else-if>
      </choose>

Alternatively, you could also use:

      <choose>
        <if type="book">
          <!--Code that applies to both a book and a thesis-->
          <choose><if type="thesis">
            <!--Code for a thesis-->
          </if><else>
            <!--Code for a book-->
          </else></choose>
        </if>
      </choose>

Bruce recommends that you try to base your <if>s on fields, rather than types, whenever possible, but when you do base your <if>s on types, this is something to keep in mind.

Also, there is an "article-magazine" type in the CSL schema. But, blog entries and dictionary/encyclopedia articles are missing. (Are blog entries in the Chicago Manual of Style now?)

[simon]

Oops, I forgot my </if> tags in the first two examples. But, I think the idea is clear, even if it's not valid XML.

[stakats]

Okay, I'll try those workarounds. While Bruce's field-level if statements might make for more compressed and logically sound (i.e. inheriting) CSLs, they will definitely impede human readability, which will in turn make authorship/editing more difficult. That said, the new CSL is a huge improvement over the old in this regard.

Sorry for missing article-magazine. As for blogPost, it is now in CMS:
​http://www.chicagomanualofstyle.org/tools_citationguide.html

[simon]

Re: readability, there shouldn't be any reason you can't include HTML/XML-style comments in your CSLs.

[simon]

We now have:

cs-types = "article"

| "article-magazine"
| "article-newspaper"
| "article-journal"
| "bill"
| "book"
| "chapter"
| "entry"
| "entry-dictionary"
| "entry-encylopedia"
| "figure"
| "graphic"
| "interview"
| "legislation"
| "legal_case"
| "manuscript"
| "map"
| "motion_picture"
| "musical score"
| "pamphlet"
| "paper-conference"
| "patent"
| "post"
| "post-weblog"
| "personal_communication"
| "report"
| "review"
| "review-book"
| "song"
| "speech"
| "thesis"
| "treaty"
| "webpage"

Are there any other types we need in CSL? Or is this good enough for 1.0?

[erazlogo]

Here are some suggestions.

1. Audio-visual sources seem to be underrepresented here:

Audio:

Are "song" and "speech" what used to be "audio_recording"?

If not, you'd need:
audio_recording (that would include CDs, home-made compilation tapes, podcasts, etc.)
If "speech" is supposed to encompass all of these, I think the name for item type is somewhat confusing and audio_recording would be better.

If yes, how would you deal with audio recordings that include both music and speech?
It would also be hard to enter and cite a CD or record album under "song" i think.

Video:

Is motion_picture what used to be film, with release date (The Shining. Dir. Stanley Kubrick. Warner Brothers, 1980.)?

If yes, you still need:
video_recording (for DVDs, home video, video podcasts, youtube videos, exercise videos, and so on)

If motion_picture encompasses all of these, the name for the item type is somewhat confusing and video_recording would be better.

2. These three have been requested many times by me and on forums--see ticket #661

serial (as a standalone item)

archival collection (as a standalone item; call it "archive" or "repository" if the word "collection" in an item type is cofusing)

person/biography (as an item type)

3. this one came up more recently on forums but would also be nice to add:

artifact

i assume "graphic" is like "artwork" but doesn't include sculpture, etc. then plastic arts need their own item type, "artifact," which could mean any "thing," art object or otherwise. Here is an example from Varnedoe & Gopnik, High & Low: Modern Art and Popular Culture (1990):
"Bunny" toy. Inflatable vinyl, approximately 46" (114.3 cm) high, deflated. Distributed by F. W. Woolworth Co., New York; manufactured in Taiwan.

see also ​http://forums.zotero.org/discussion/1274/how-might-the-artwork-type-be-expanded/#Item_8

[erazlogo]

Ok on whether there's enough in current CSL types to properly cite what we have in Zotero right now:

CSL for broadcasts may be missing (see #4). There are some cases where there is only one CSL type for several Zotero item types and I'm not sure whether the CSL can be properly formatted for all of them-if not, we would need extra types. I'm using footnote citation format CMS 15th ed. in all examples here--not sure about other styles.

1. conference_paper - check if it can cite both "conference paper" and "presentation"

Conference Paper:
papers in proceedings are cited as book sections in CMS
Deborah Winger, "Society in an Industrial Revolution," in _Immigrants in Industrial America, 1850-1920: Proceedings of the National Immigration Society held in Philadelphia, PA 1-3 November 1973_, edited by Richard L. Ehrlich (Oxford: Oxford University Press, 1997), 22-34.

Presentation:
Stacy D'Erasmo, "The Craft and Career of Writing" (lecture, Northwestern University, Evanston, IL, April 26, 2000).

2. motion_picture - should be able to cite "video recording" as well as "film:"

Video Recording:
North by Northwest, DVD, directed by Alfred Hitchcock, (1959; Burbank, CA; Warner Home Video, 2000)

Film:
North by Northwest, directed by Alfred Hitchock (Warner Brothers, 1959).

3. personal_communication - should be able to cite "letter," "e-mail," and "instant message"

Letter:
George Creel to Colonel House, 25 September 1918. Edward M. House Papers, Yale University Library.

Email (IM probably the same--no guidance, of course)
CMS suggests this (somewhat informal for a citation):
Constance Conlon, e-mail message to author, April 17, 2000.

4. I don't think we have a CSL for broadcasts - radio and tv broadcasts would be cited in the same way, and podcasts probably too, but with a uri (nothing on podcasts in CMS even online). No guidance on this in printed CMS, but here is what I was able to find online:

"Im John-il Releases a Summer Blockbuster," _Morning Edition_, WNPR Connecticut Public Radio (Meriden, CT: WPKT, August 14, 2006).

5. Not sure how one would distinguish between "song" and "speech" CSLs for citing "audio recording"--I assume we could just use "song" in all cases.

[simon]

Deferring this until we next revise item types, unless there are urgent issues that must be resolved before 1.5.

[erazlogo]

True that things don't need to be done in Zotero, but since bibliontology is pretty much done and will be the basis for the hierarchical item types, maybe CSL types could just catch up with bibliontology types in time for CSL 1.0 release?

[simon]

(In [6330]) addresses #699, Reconcile Zotero item types with CSL schema

maps dictionaryEntry and encyclopediaArticle to entry-dictionary and entry-encyclopedia respectively (instead of chapter)