Not signed in (Sign In)
Quick Links
Vanilla 1.1.10 is a product of Lussumo. More Information: Documentation, Community Support.
General: [Sticky] Changes to fields and item types for Zotero 3.1+
Bottom of Page-
- CommentAuthorajlyon
- CommentTimeDec 20th 2010 edited
[edited: These changes will be in the next major release to succeed Zotero 3.0, not 2.1 or 3.0.]
The upcoming release of Zotero 2.1 final is likely to include several (minor) additions and changes to the current set of Zotero item types (e.g. "Book Section") and fields (e.g. "Book Title"). These changes require careful consideration, since they not only affect how bibliographic data is imported, exported and synced, but also how this data can be formatted with Citation Style Language (CSL) styles.
Several members of the Zotero and CSL communities have written up a preliminary list of changes, available at https://github.com/ajlyon/zotero-bits/wiki/Zotero-types-whiteboard. At this point, we would like to call for feedback from Zotero developers and users. Ideally, in the next few weeks, we would like to expand and refine this list so we end up with a collection of well-documented requests that increase the usability of Zotero while minimizing the disruption for existing users.
In considering changes to item types and fields, it is important to remember that item types in Zotero are best understood as a set of fields and a set of ways they tend to be styled. That means that the best argument for new fields or types is that a certain type of data or citation is presently impossible to represent in Zotero. In addition, it is important to note that CSL has its own set of fields (called CSL variables) and item types, and that a mapping is used to make Zotero data accessible to CSL styles. Finally, a small update to CSL 1.0 might be released along Zotero 2.1, which would allow for the addition of new CSL variables.
Comments and contributions can be posted in this thread or in the relevant existing forum threads that discuss changes to item types. You can also request direct access to the wiki on GitHub (see the wiki for details).
[edited for clarity per Rintze's suggestions] -
- CommentAuthorGreg
- CommentTimeDec 20th 2010
Two comments:
- I like the dataset type
- What is the difference between 'book author' and 'editor' for book sections?
Maybe more later...
Generally, I think that it's more important to make two changes (I know, this is kind of unrelated):
- possibility to define which fields are shown by default whereas the others are only visible after pressing an extend button (the list is to long and it would be nice to have a better overview without the rarely used fields auch as 'Rights' or 'Language')
- quicker way to copy paste list of authors into item. That always takes a long time when I have to do that (for example for book sections) -
- CommentAuthorDan Stillman
- CommentTimeDec 20th 2010
Greg: This isn't the place for feature requests. -
- CommentAuthoradamsmith
- CommentTimeDec 20th 2010
What is the difference between 'book author' and 'editor' for book sections?
Not all book sections are in edited volumes. One typical example would be an introduction written by someone different then the book's author.
And to clarify - the reason this needs to be discussed with community involvement is that changes to the overall data model are only going to happen very, very rarely and can't really be reverted once they're implemented so we need to get this right. Other features (e.g. the ones requested by Greg) can just be added whenever, because they don't affect the underlying data structure. -
- CommentAuthorajlyon
- CommentTimeDec 20th 2010
- I like the dataset type
Then can you help to fill out the set of fields we'd need for such a type? I really don't know what the type will need. -
- CommentAuthornoksagt
- CommentTimeDec 21st 2010
There has been a semi-frequently expressed to desire to make 'document' as generic as possible. That is somewhat better-reflected in ticket 867 than the whiteboard. To make a strong generic type, should document just have every field possible? Similarly, should other "mother types" have all fields of types that seem to be a subset (webpage to blog post would be one example). -
- CommentAuthorGreg
- CommentTimeDec 22nd 2010
dataset type - I have been using webpages for that type sofar and I like the idea of not doing it anymore. Attaching stuff such as the survey-instrument or the user-manual is very convenient. I guess important fields are title, creator, distributing institution, abstract, URL, date/collection period, citation required for publications with this dataset, abbreviation...
I am not sure how the citation required for publications with this dataset should work because sometimes these are books, sometimes, articles. It would be nice to have a dataset type though and when you cite this the correct citation is used. -
- CommentAuthorajlyon
- CommentTimeDec 23rd 2010 edited
Honestly, if we can't nail down meaningful data that ought to be kept on datasets, or if they are treated as books, articles, etc., then there shouldn't be a dataset item type in Zotero, because it follows that datasets are not a coherent category, bibliographically speaking.
Perhaps you can look at style guides and author guides and compile the rules for datasets in your field's leading journals?
Edit: Rintze has started work on fleshing out the dataset type proposal: https://github.com/ajlyon/zotero-bits/wiki/DatasetType
That page also has links to some style guides and previous discussion. Consider what else might be needed to make the type useful. -
- CommentAuthorajlyon
- CommentTimeDec 23rd 2010
There has been a semi-frequently expressed to desire to make 'document' as generic as possible. That is somewhat better-reflected in ticket 867 than the whiteboard. To make a strong generic type, should document just have every field possible?
I would like to see this happen. -
- CommentAuthorwpwend42
- CommentTimeDec 23rd 2010
Something I'd like to see is the addition of some new item types. One thing I keep running into is "plays." For example, if I want to add an item for Othello with my lecture notes, video links, articles, etc, I have to add it as something else ("book," perhaps). -
- CommentAuthoradamsmith
- CommentTimeDec 23rd 2010
wpwend - thanks for contributing but that's not yet specific enough to be helpful.
As per ajlyon's post above:In considering changes to item types and fields, it is important to remember that item types in Zotero are best understood as a set of fields and a set of ways they tend to be styled. That means that the best argument for new fields or types is that a certain type of data or citation is presently impossible to represent in Zotero.
The question is - can you currently cite a play correctly in your preferred citation styles? If yes, we don't need a new item type. If not, why not? -
- CommentAuthorwpwend42
- CommentTimeDec 23rd 2010
Oh, sorry. As far as I can see, you cannot cite them properly. I might be missing something, please point it out if I am, but I don't see a way to export a citation for a play in the correct manner. Please point it out if I am missing something.
Also, as a matter of "certain type of data," as I tell my students constantly, plays are not books or novels, so I think it would make sense to deferentiate them with a separate item type as a matter of clarity. That might be me just being nit picky, but I think that kind of clarity is important. However, I also understand that may open the floodgates for numerous other things too. -
- CommentAuthoradamsmith
- CommentTimeDec 23rd 2010
Well, how should they be cited?
The purpose of types in Zotero is not to distinguish between different items analytically, unless that's relevant for citation purposes.
You can use tags etc. for that purpose. -
- CommentAuthorGreg
- CommentTimeDec 23rd 2010
okay, I see what you are saying about dataset type and I agree. There are no guidelines to cite datasets from journals in my discipline I know about. This is done by citing a certain book, article or user-guide... -
- CommentAuthoradamsmith
- CommentTimeDec 23rd 2010
Back to Dataset - using the things Rintze links to, I see three issues that might make a dataset category worthwhile:
1. The hdl and UNF handlers - so fart those aren't very common - they're a project of Gary King out of Harvard that has, so far, not really caught up - not even in PoliSci, which is Gary's main discipline. In any case - hdl's are a form of URL and should go in that field - I'd add the UNF - so this doesn't really require an item type
2. Separate info for producer and distributor - APSA requires this for ICPSR (the largest data repository for the social sciences) - and I'd assume that's also the case for sociologyEldersveld, Samuel J., John E. Jackson, M. Kent Jennings, Kenneth Lieberthal, Melanie Manion, Michael Oksenberg, Zhefu Chen, Hefeng He, Mingming Shen, Qingkui Xie, Ming Yang, and Fengchun Yang. 1996. Four-County Study of Chinese Local Government and Political Economy, 1990 [computer file] (Study #6805). ICPSR version. Ann Arbor, MI: University of Michigan/Beijing, China: Beijing University [producers], 1994. Ann Arbor, MI: Inter-university Consortium for Political and Social Research [distributor], 1996.
I have no thoughts on this - but this might require a separate field.
3. Data Sets are given a different status - in some styles they are treated like monographs with the title in italics (e.g. APA). In some styles (such as the one given on http://thedata.org/citation/standard ) they are treated as articles and put in quotation marks. In the third set of styles (such as the APSA style) they are treated as neither and given in normal font without quotation marks, although monographs are in italics and articles in quotation marks otherwise.
At least in the disciplines I know - PoliSci, Sociology, and Economics - I have never seen any of the other requested information on the various data set threads (such as sampling group etc.) in any citation.
Imho so far this doesn't look like a separate data set type is needed. It would be good to hear from some other disciplines, though - I'm thinking geography, psych, maybe some of the statistically oriented life-sciences like epidemiology etc. -
-
CommentAuthorRintze
- CommentTimeDec 23rd 2010
The hdl and UNF are respectively a stable URI (which in the example at http://thedata.org/citation/standard is not a URL, but more like a DOI) and a hash value. Both seem useful. -
-
- CommentAuthoradamsmith
- CommentTimeDec 23rd 2010
New issue:
I would like to see a "type" variable included in book. That would help e.g. for styles that want things like "ebook" "digital image" or even "kindle book" listed. I'll dig up the links when I get the chance - erazlogo once said she didn't like the idea, so I wanted to open that for discussion rather than just adding it to the list on github -
-
CommentAuthorRintze
- CommentTimeDec 23rd 2010 edited
"Format", mapped to the CSL variable "medium", could perhaps work for that as well. -
-
- CommentAuthoradamsmith
- CommentTimeDec 24th 2010
ah yes, I had forgotten about the medium variable - that would be better, I think. -
- CommentAuthorajlyon
- CommentTimeDec 24th 2010
@wpwend42: Since I told you on Twitter to post here, I ought to be more clear. Zotero's data model is built around ways we record metadata about publications and other produced or performed works. I'm not sure what problems you currently are having as you try to use Zotero to work effectively with plays, but I can imagine some possibilities. It is, for example, not very straightforward (or not possible?) to represent the play Hamlet in Zotero. There are ways to represent printed editions of it (manuscript, book, book section) and ways to represent specific perfomances of it (presentation, video recording), but the underlying creative work doesn't really fit into this model.
Of course, it's obvious to any theater scholar that there isn't a single underlying Hamlet-- we can only talk about print, stage, screen manifestations. This is something that will some day be addressed by the long-discussed hierarchical item model, but it's a hard problem theoretically and practically.
For now, we have a window of opportunity to make changes to the specific fields and types at our disposal -- to see if plays need something Zotero can't do, just explain what data you need to keep on plays and what citations look like.
We'll try to figure out whether the current model can handle it and propose changes if it can't. The current system is more flexible than it looks. -
- CommentAuthorajlyon
- CommentTimeDec 24th 2010
@Rintze & adamsmith: I agree that Format should be added to Book/Book Section -- but I worry that we might need to add it to even more formats. I went ahead and added it to the whiteboard. -
- CommentAuthorajlyon
- CommentTimeDec 24th 2010 edited
It appears that the book review discussion had been overlooked in preparing the proposal. Fortunately, the thread has been revived. In that thread, erazlogo wrote:The easiest way to add book reviews is to add "reviewed title" field and "reviewed author"/"reviewed editor" author types to all article item types--this allows for correct bibliographic formatting for journal/magazine/newspaper books reviews.
That sounds good to me. -
-
CommentAuthorRintze
- CommentTimeDec 24th 2010
That would require changes to CSL as well, as there is currently nothing to map "reviewed title" and "reviewed author"/"reviewed editor" to. -
-
- CommentAuthorajlyon
- CommentTimeDec 24th 2010
So reviewed author is currently just ignored? -
-
CommentAuthorRintze
- CommentTimeDec 24th 2010
Frank's mapping overview ( http://gsl-nagoya-u.net/http/pub/csl-fields/index.html ) doesn't include creator roles, so I'm not sure. -
-
- CommentAuthorwpwend42
- CommentTimeDec 26th 2010
I can imagine some possibilities. It is, for example, not very straightforward (or not possible?) to represent the play Hamlet in Zotero. There are ways to represent printed editions of it (manuscript, book, book section) and ways to represent specific perfomances of it (presentation, video recording), but the underlying creative work doesn't really fit into this model.
This is more or less what I am trying to get at here. Thanks! -
- CommentAuthorajlyon
- CommentTimeDec 27th 2010
So reviewed author is currently just ignored?
It turns out that reviewed author is used in Bibliontology RDF export, import from the Bryn Mawr Classical Review, and that's all. It is item type "reviewedAuthor" (id 27), but it doesn't look like Zotero maps it to anything for CSL, unlessed I've missed something in my code-diving. -
-
CommentAuthorRintze
- CommentTimeDec 31st 2010 edited
A current limitation of Zotero/CSL is their inability to graciously handle label-type styles. CSL contains a "citation-label" variable, but it isn't accessible through Zotero. Instead, some people use the "Extra"/*extra* field that maps to *note*: http://forums.zotero.org/discussion/5239/first-letter-of-author-as-citation/
Would it make sense to add a "Citation Label" field to all item types, or would this clutter the UI too much? -
-
- CommentAuthorajlyon
- CommentTimeJan 17th 2011
I think that this discussion has pretty much ended; if anyone has additional proposals that are not reflected on the whiteboard, now would be the time to add them. Otherwise, it's probably time to clean up the present proposals and make a final list of specific changes.
As we do so, we still need clarification on:
* Artwork. The whiteboard has no concrete proposals on what can or should be changed with that type. Without some clarification and justification, it's not going to happen for 2.1.
* Music Score. Older discussions acknowledges the need, but we have no details on necessary fields.
* Exhibition Catalogue
* Series Titles and Series Text. These fields are unclear to begin with-- the whiteboard includes a proposal to repurpose one as "section"; see the whiteboard.
Between these changes, standalone, and multilingual, the 2.1 release of Zotero is going to be a very exciting one. -
- CommentAuthorajlyon
- CommentTimeJan 17th 2011
@Rintze: I'm leaning in favor of supporting Citation Label, but I'd like to see field hiding as well, since it (and the present proposal in general) threaten to really clog up the metadata pane, especially for small-screen users like me. -
-
CommentAuthorRintze
- CommentTimeJan 17th 2011
@ajlyon: agreed that field hiding would be very nice. There will be other fields that many users won't use, like the proposed original-date/original-publisher/original-publisher-place fields. -
-
- CommentAuthorjacktanner
- CommentTimeJan 18th 2011
I was going to request a type for a special issue of a journal, but I see Periodical Type is already on the list! That's great.
What's the best I can do to cite a special issue in Zotero 2.0? -
-
CommentAuthorRintze
- CommentTimeJan 18th 2011
I created tickets for most of the things discussed on the zotero-bits github wiki:
https://github.com/ajlyon/zotero-bits/issues
There are still a few open questions, so comments are welcome. -
-
- CommentAuthorjmac62
- CommentTimeJan 19th 2011
I am not sure if these 2 issues should be addressed with new fields or some other way.
1. In English departments MLA and APA are both often used. Title capitalization is different - MLA (Title Case) and APA (Sentence case). Zotero does not now change title capitalization automatically. Thus however the title is entered is how it will display - which makes it impossible to use the same title entry for MLA and APA - without going in and changing the capitalization. It seems this could be handled in one of two ways: somehow change between Title Case and Sentence case automatically; or have two fields for title - one for each case.
2. see my previous comment and discussion at
http://forums.zotero.org/discussion/15445/mla-not-showing-online-database-source-in-bibliography/
it seemed there was some thought that this might call for a new field. -
- CommentAuthorajlyon
- CommentTimeJan 19th 2011
1. Right-click on the title to use the very limited transformation options. You should generally use sentence case in Zotero, since styles can force title case if necessary (right?)
2. See https://github.com/ajlyon/zotero-bits/issues#issue/8 -
- CommentAuthoradamsmith
- CommentTimeJan 19th 2011 edited
1. Zotero can in fact change title capitalization in styles. This works almost perfectly from sentence case to title case, but has lots of problems in the other direction (and there is no viable solution for that - no way Zotero can distinguish proper nouns). The solution is to save all of your items with sentence case and then have them converted to title case by the respective style (this might not be implemented in all styles requiring title case - let us know when you find an instance where it's missing). There are a number of threads on this, please find one and continue the discussion there if needed, separate fields are most certainly not going to the the solution here.
2. Thanks for bringing that back up - I do think we need to find a solution to citing the database used. I think Rintze's suggestion of using a csl "catalog" variable makes most sense, but we haven't thought this through very much.
Edit: so yeah, what ajlyon says - thoughts on the catalog/source issue are welcome - either here or on the wiki. -
- CommentAuthorjmac62
- CommentTimeJan 19th 2011
Thanks for the info ajlyon and adamsmith. good plan to use sentence case as default.
Sorry to post 1. here. (FYI, MLA and MLA with URL styles are not Title Case-ing Sentence cased titles - i will try to find another place to post that.) -
- CommentAuthorerazlogo
- CommentTimeJan 25th 2011
What about the archival collection type? Here are discussion and ticket:
https://www.zotero.org/trac/ticket/661
https://www.zotero.org/trac/ticket/1023
http://forums.zotero.org/discussion/2981/styling-archival-material/
http://forums.zotero.org/discussion/391/1/hierarchical-item-relationships/#Item_48
These are now included in library catalogs and can be imported into Zotero. It would be a great aid in research, archives need to be cited in bibliographies, and this would need to be implemented in the hierarchical item types structure anyway. -
- CommentAuthorasallen
- CommentTimeJan 27th 2011
Okay, I'm a musicologist but not a librarian (I'll contact a librarian for input), but here's the big difference: a music score is basically a book, for item type, but instead of "author" there needs to be a "composer" field. The other features of the "book" item are useful (such as publisher, editor, etc, etc.), but other useful features would be something like "orchestration" or "parts" and then maybe a work index number, such as "opus" (but not all composers use opus numbers, so that could just be part of the title.
I imagine just modeling it on book, adding the tweak of a composer field, and we'd be in good shape... but more when I hear back from a librarian!
Thanks. -
- CommentAuthorasallen
- CommentTimeJan 27th 2011
Another field, for opera "musical scores" would be "librettist" (so instead of author, we'd need "composer" and "librettist" to be added). That makes me realize that also "lyricist" or "words by" or "text by" might make sense too. -
- CommentAuthoradamsmith
- CommentTimeJan 27th 2011 edited
asallen - that sounds reasonable, thanks for the input - could you provide some examples of how various such works (I guess an opera, a lied, an orchestral score, and maybe an arranged piece would cover most usage cases) would would be cited in a style common in musicology?
edit: and please just use actual works (i.e. Schubert, Franz. Winterreise...) rather than abstractions (Composerlastname, Firstname. Lied) - much easier to understand an actual citation. -
- CommentAuthorcanarik
- CommentTimeJan 27th 2011
I am not sure this is the right place but I would like to see an item type related functionality in 2.1.
In a typical scholarly article several sources that are under different item types are cited. While using "insert bibliography" button it would be great to have the "option" of auto-grouping based on item type. Thus, each resource will be listed alphabetically under the item type heading which it belongs to. -
- CommentAuthoradamsmith
- CommentTimeJan 28th 2011
not going to happen in 2.1 and a good deal more complex, but it's something that's on the radar and will come eventually. -
- CommentAuthorjgeorgia
- CommentTimeJan 28th 2011
"it is important to remember that item types in Zotero are best understood as a set of fields and a set of ways they tend to be styled."
I would prefer if item types were best understood as a way of classifying citations, which is at least part of what we use them for. In short, I'd like to see working paper as an option, regardless of how identical its required fields may be to some of the other formats. Working paper is a very widely used term and implies a paper in progress, which is not aptly reflected by classifying it as a 'manuscript' or 'conference paper'.
If the overlap is problematic for some people, it folds right into my related suggestion, which is to allow users (via the preferences menu) to select the various classifications they would like to see available in the drop down menu. Many of us see at least a couple options we know we'll never use, and being able to keep the list tidy would speed up work flow and improve consistency for the end user. At the bottom of the list could be an option to 'Add more citation types' which would open up the aforementioned options menu.
Sorry for the slightly off-topic feature request, but since it ties into argument for the working paper classification, I hope it's fair to include it here. -
- CommentAuthoradamsmith
- CommentTimeJan 28th 2011
The point is that Zotero offers you numerous other ways to "classify" items - tags and collections most notably. The former will eventually include some version of a visual component.
Creating more and more item types that won't export to other citation managers and won't be reflected in what's possible to adjust in citation styles is, I believe (and, I gather, the developers believe), not a good idea.
The other feature request is a quite separate GUI request - sounds good to me, but I don't know how hard a more customizable GUI would be to write. -
- CommentAuthorPhilippe_T
- CommentTimeJan 28th 2011 edited
@canarik and jgeorgia,
To classify all your items, there are tags and connexions as adamsmith mentionned. You may also want to create folder and sub-folders depending on document real type, and so on.
However there is something more when it comes to produce a bibliography organised by sources types, examples...
1. Jurisprudence
-
-
-
2. Legislation
-
3. etc.
I simply use a tag for every type of classification, "4- Articles" which is put on scientific papers, law review or case law chronicles, or "6- Gouvernmental papers" for reports, conference, etc.
Then, I research within Zotero and use the tag as a criteria.
So I end up with as many research-report as categories I need and simply "extract bibliograhpy" from these items afterward. Then again, it might be annoying to this when you use only 10-20 documents, but as I use 100-150, it's more than usefull.
----
As a general question, is there a place to check on metadata? (Some sort of "CSL Metadate Field Index" like this old one: http://gsl-nagoya-u.net/http/pub/csl-fields/index.html )
I'm trying to find out if "session" is going to be there for legislation and such. -
- CommentAuthorasallen
- CommentTimeJan 28th 2011
My librarian friend is not a cataloger, so she's getting in touch with someone who's got better details.
Here are a few examples from one the main journals in musicology, the Journal of the American Musicological Society:
Igor Stravinsky, _The Rite of Spring: Sketches 1911-13_, edited and with commentaries by Robert Craft (London: Faber and Faber, 1969).
Igor Stravinsky, _"Petrushka" and "The Rite of Spring" for Piano Four Hands or Two Pianos_ (Mineloa, N.Y.: Dover, 1990).
And here are a few examples from the bibliography of Susan Youens, _Retracing a Winter's Journey: Schubert's Winterreise_ (Ithaca and London: Cornell University Press, 1991). All brackets and details are as printed in the book.
Schubert, Franz. [Autograph manuscript] "Winterreise von Wilh. Mueller." Part I. 21 folios. [Dated at the beginning] "Febr. 1827 Frz. Schubert mpia [manu propria]." In the Mary Flagler Cary Music Collection of the Pierpont Morgan Library, New York City.
Schubert, Franz. [Engraver's fair copy] "Winterreise / von Wilh. Mueller / in Musik gesetzt / von / Franz Schubert / A[nn]o 1827." Part I. 32 folios. In the Vienna Stadt- und Landesbibliothek, Musiksammlung, MH 5391/c.
Schubert, Franz. _Neue Ausgabe saemtlicher Werke_. 4th ser.: Lieder. Vols. 4a and 4b, 242-5, 260-78. Ed. Walther Duerr. Kassel: Baerenreiter, 1979.
And I'll provide some more specifics when I get them. Thanks! -
- CommentAuthorajlyon
- CommentTimeJan 29th 2011
@Philippe_T There has been some discussion of adding support for splitting biographies by type. In other fields, people sometimes need to separately list published and unpublished literature, primary and secondary literature, or literature by language of publication. When solution to this comes, it will hopefully cover your case as well.
The site you mention is the best place to look for information on Zotero/CSL mappings and for the fields in each Zotero type. It is correct and not out of date. -
- CommentAuthorPhilippe_T
- CommentTimeJan 29th 2011
@ajlyon Thanks for your answer about the web-site and the other point as well. ^_^
Yeah, I basicly need 9 to 12 different types too, sometime a pain to organise... but as I always say... it's better than handwritten stuff or a list within a simple doc. So far, "research" been usefull to organise the type of docs... but yeah, if something else comes out, joy! -
- CommentAuthorPhilippe_T
- CommentTimeJan 29th 2011
Bill, legislation/statute and case law could have "publisher-place" / "place"
Bill, legislation/statute and case law could have "report-year" as well, if possible
Those very often have to be link to a State, province, region and a container (report) which has its own edition information, but which are currently not fully present, as I point out.
As regards to "book/article/law/jurisprudence review, an additionnal fields, mapping to something similar like for "book chapter" could be used...
Zotero label -> Zotero fieldname -> CSL fieldname
Title -> Title -> Title
Book title -> bookTitle -> container-title
And as ajlyon mentioned, "reviewedAuthor" already exist, so we would simply need a map.

Upgrade Storage