Hi Rintze,
Thank you for your good summary of my proposal, and I am sorry for not using the mailing list properly. This is my first time working on a mailing list.
- Is it ever necessary to be able to cite a subset of the reports?
Not every journal requires parallel citations - a citation to the primary reporter may be all that it required. However, within a single document, the citation convention must be consistent. If the first citation contains parallel references, then every subsequent citation must also contain the parallel references.
- Is it ever necessary to control the order of the reports?
Publications should be listed according to their relative weight of authority. Within a single document, the ordering of the publications must be consistent. I think that ordering of elements in the containers array
- Concerning Hierarchical Item types
I don’t have a good handle on the nuances of hierarchical item types. However, I had given the subject some thought when formulating my proposal. These are my initial thoughts.
My current proposal only allows elements to hold simple fields - it does not allow name fields, date fields, or nested . This limitation makes it much simpler to implement - not only for the CSL processor, but also for user interfaces. But, perhaps it strikes the wrong compromise between simplicity and functionality?
In order to accommodate hierarchical items types, the element would have to at least accommodate name fields. The initial in the array could represent the smallest level of container, and each subsequent element represents the next larger container. For an example of an article cited within a textbook:
<title>The Nature and Value of Rights</title> <!-- title of the work -->
<issued>2006</issued>
<authors>
<author>
<family>Feinberg</family> <!-- author of excerpt -->
</author>
</authors>
<containers>
<container>
<container-title>Chapter 7: the Nature and Significance of Rights</container-title> <!-- title of the subcontainer -->
</container>
<container>
<container-title>Jurisprudence: Introduction to the Philosophy of Law</container-title> <!-- title of book or database -->
<authors>
<author>
<family>Gottlieb</family> <!-- author of text book -->
</author>
</authors>
</container>
</containers>
To preserve the compatibility between styles to render the same bibliographic information, the CSL specification would have to include sub-rules about which fields should or should not be included in elements. For instance, does the element become a child element of or should it be a child element of a element?
(I personally think that and elements should always occur under ).
- Tom________________________________
From: xbiblio-devel-request@lists.sourceforge.net xbiblio-devel-request@lists.sourceforge.net
Sent: Thursday, February 2, 2017 4:58 PM
To: xbiblio-devel@lists.sourceforge.net
Subject: xbiblio-devel Digest, Vol 118, Issue 1
Send xbiblio-devel mailing list submissions to
xbiblio-devel@lists.sourceforge.net
To subscribe or unsubscribe via the World Wide Web, visit
xbiblio-devel List Signup and Options
xbiblio-devel Info Page - SourceForgehttps://lists.sourceforge.net/lists/listinfo/xbiblio-devel
lists.sourceforge.net
This list is for development discussion around the xbiblio project, including schema design for the citation style language (CSL) and implementation discussion.
or, via email, send a message with subject or body ‘help’ to
xbiblio-devel-request@lists.sourceforge.net
You can reach the person managing the list at
xbiblio-devel-owner@lists.sourceforge.net
When replying, please edit your Subject line so it is more specific
than “Re: Contents of xbiblio-devel digest…”
Today’s Topics:
- Re: Proposed change to CSL input XML (Rintze Zelle)
- Job posting: Citation Specialist / CSL Expert (Darshan Somashekar)
Message: 1
Date: Thu, 5 Jan 2017 00:52:13 -0500
From: Rintze Zelle <rintze.zelle@…25…>
Subject: Re: [xbiblio-devel] Proposed change to CSL input XML
To: development discussion for xbiblio
xbiblio-devel@lists.sourceforge.net
Message-ID:
<CA+pmmQR=ygg_Th=oZCpvw60Sp23k+Anh7AW8f_9X1ogwJS84iw@…26…>
Content-Type: text/plain; charset=“utf-8”
Hi Tom,
So, to briefly condense your posts on this topic (for myself and others):
Juris-M (formerly Multilingual Zotero, MLZ) extends the official CSL
specification in a number of ways to improve support for legal citations.
One of these extensions is the support for parallel citations, where a
single document is published redundantly in multiple outlets. Juris-M
assumes that each so-called report is stored as a separate item, and
automatically collapses reports to the same document if they are cited
directly next to each other. See pages 6 and 78 of
http://citationstylist.org/public/mlzbook.pdf for more context and examples.
Citations, Out of the Box (PDF) - CitationStylisthttp://citationstylist.org/public/mlzbook.pdf
citationstylist.org
viii Foreword Getting to that day will not be simple. No doubt, there will be some who fight to preserve their particular bit of the inefficiency of today’s …
Your proposal is to store these separate reports as a single item, and to
make it possible in CSL to properly render the information from the various
reporters of each item (each report will have its own values for fields
like “container-title”, “volume”, “section”, etc.).
After reading your proposal, I have a few questions:
- assuming that we store all the publication information from the various
publishers/reporters in a single item, in some form of ordered array, what
are the exact formatting requirements for parallel citations? For example,
for an item with multiple reports, is it ever necessary to be able to:- cite a subset of the reports?
- control the order of the reports?
- for the old-timers here: does anybody know if there are any good
discussions here or on the Zotero forums about hierarchical item types? Do
we have an overview of the various cases where hierarchical item types
would help? E.g. requested_features [Zotero Documentation] only
requested_features [Zotero Documentation]https://www.zotero.org/support/requested_features
www.zotero.org
This page serves as an overview of the status of some of the most frequently requested features for Zotero. This list is unofficial and is principally maintained by …
mentions “chapters as sub-items of an edited volume”. I’m wondering if
there is a lot of functional overlap between hierarchical item types and
parallel legal citations.
Rintze
P.S. Tom, it looks like every time you respond you start a new thread in
this mailing list, which makes this discussion harder to follow (this
discussion is a continuation of
http://xbiblio-devel.2463403.n2.nabble.com/Proposed-change-to-CSL-input-XML-specification-tp7579492.html
xbiblio-devel - Proposed change to CSL input XML specificationhttp://xbiblio-devel.2463403.n2.nabble.com/Proposed-change-to-CSL-input-XML-specification-tp7579492.html
xbiblio-devel.2463403.n2.nabble.com
Proposed change to CSL input XML specification. I have a suggestion for adding a data type to the CSL specification. Overview Some of the design goals of a bibliography system are (1)…
and
http://xbiblio-devel.2463403.n2.nabble.com/Proposed-change-to-CSL-input-XML-tp7579502.html).
xbiblio-devel - Proposed change to CSL input XMLhttp://xbiblio-devel.2463403.n2.nabble.com/Proposed-change-to-CSL-input-XML-tp7579502.html
xbiblio-devel.2463403.n2.nabble.com
Proposed change to CSL input XML. Sebastian seems to have a solid grasp on the issues. I also often share his frustration with legal citations. Just so that everyone in the conversation knows what the…
Could you try to reply directly next time? You should be able to do this by
replying to the thread via http://xbiblio-devel.2463403.n2.nabble.com/, or
xbiblio-devel | Mailing List Archivehttp://xbiblio-devel.2463403.n2.nabble.com/
xbiblio-devel.2463403.n2.nabble.com
xbiblio-devel forum and mailing list archive. This list is for development discussion around the xbiblio project, including schema design for the citation style language (CSL) and implementation…
by subscribing to the mailing list at
xbiblio-devel List Signup and Options, after which you
xbiblio-devel Info Page - SourceForgehttps://lists.sourceforge.net/lists/listinfo/xbiblio-devel
lists.sourceforge.net
This list is for development discussion around the xbiblio project, including schema design for the citation style language (CSL) and implementation discussion.
should receive future mailing list emails in your inbox.
On Tue, Jan 3, 2017 at 7:29 PM, Thomas O’Reilly <iamio@…231…> wrote:
After giving more thought to my proposed CSL element, I would like to
modify the proposal. I would to rename the proposed element from
to . Other changes will be listed in my answer to the questions
that Bruce raises.Bruce brings up 2 important concerns with my previous proposal:
QUESTIONS
Is the proposal necessary?
Could the solution be solved by extending the features of the
element?Could the proposal be generalized beyond its niche applicability?
ANSWERS
(1) The proposal is necessary in my opinion.Frank Bennett has done a lot of incredible work with citeproc-js and
Multi-lingual Zotero. In addition to maintaining the processor, he added
experimental support for parallel citations for legal users. However, the
lengths that he has had to go to achieve that support demonstrate why the
construct should be adopted.“In CSL-M, parallel citations are produced when the item types of two
adjacent citations match, the items are of a legal type, and their titles
and dates also match.” (Bennett, F. “Citations out of the Box”, p. 78).This approach introduces several problems. First, storing information
about the same item in two different citations allows the possibility of
storing inconsistent information. Second, it relies upon the processor to
imply a relationship between two citations, instead of relying upon an
explicit data structure. This means that CSL Processors need to have
complicated code in order to support parallel citations - which limits
adoption of the feature. Third - from my understanding - the style creators
don’t have the ability give instructions about how parallel citations
should be styled.In contrast, supporting a element will ensure data integrity,
it is easier for processors to implement, and it gives style creators the
flexibility to target users of parallel citations, if they choose.(2) Extending the element to support the proposed features would
NOT be an advisable solution.Just like the proposed element, the element is
primarily used for item data that is logically related. However, it’s
primary function is that it “implicitly acts as a conditional.” (
CSL 1.0.2 Specification — Citation Style Language 1.0.1-dev documentation).
elements are not rendered if it contains a variable, and the
variables are empty. When a element is rendered, it can apply
prefix before the content, apply a suffix after the content, and apply
delimiters in between its variables.The element has a clearly defined, useful role in styling data.
However, there are several features that the element lacks compared
to the proposed element.
First, the element does not have a variable name. The
element acts as a collection of variables, but it is not a variable itself.
Second, because the element does not correspond to a variable, it
also does not support iterating through complex data. The element
and element are examples of elements that supported complex data -
data that is represented in a nested structure. A element will
iterate through every name that is associated with that variable. The
proposed element is functionally closer to the element
than to the element. In fact, the element is fairly
be described as a more flexible element. Just you would not want to
extend the element to directly render names, I think that it would
be just as unwise to use to directly render information that a
element should render.(3) The proposal could be generalized beyond supporting only parallel
citations for legal users.I think that the element should be named a element, instead
of being named . The allowed sub-elements of would be
elements. This would indicate to style designers that the
element is to be used as a “container” for any pieces of information that
are logically related and that are repeatable.Each element would be composed of elements.
The elements are directly analogous to elements of
a CSL style. elements should follow the variable-naming
conventions for Standard Variables from Appendix IV of the CSL
specification. (http://docs.citationstyles.org/en/stable/specification.
html#standard-variables).EXAMPLE REPRESENTATION
<container> <container-part name="text-variable-name" /> ..... </container>
ADDITIONAL THOUGHTS
- THE PROPOSAL IS PARTIALLY BACKWARDS COMPATIBLE
If adopted, new CSL styles would be able to process old data. I have
already written a patch for citeproc-js that would support
elements in a CSL style sheet. (81 lines of pretty simple code). My
implementation first looks for item data under the variable-name of the
element. If that variable-name is not found, the processor
then looks for item data using the variable names of the
elements. This means that styles that use elements can still
fully process item data, even if that data was not encoded to explicitly
support elements.
- THE PROPOSAL IS NOT FULLY BACKWARDS COMPATIBLE, AND IS NOT COMPATIBLE
BETWEEN STYLES. THE POSSIBLE VARIABLE NAMES FOR ELEMENTS
SHOULD BE SPECIFIEDOld style sheets would not be able to process new data that would target
the features of CSL - unless the possible variable names for
elements are constrained. Constraining the variable names
would also required for compatibility between new CSL styles.It is hard to work out which variable names should be allowed for
elements, without anticipating every use case. If I could
speculate about a possible solution. . . Drawing inspiration from
Bibframe’s model (Overview of the BIBFRAME 2.0 Model (BIBFRAME - Bibliographic Framework Initiative, Library of Congress)),
perhaps the variable name for elements should be limited to
names such “Instances”, “Events”, and “Subjects”.
- Tom
-------------- next part --------------
An HTML attachment was scrubbed…
Message: 2
Date: Thu, 2 Feb 2017 17:25:11 +0000
From: Darshan Somashekar <darshan@…393…>
Subject: [xbiblio-devel] Job posting: Citation Specialist / CSL Expert
To: “xbiblio-devel@lists.sourceforge.net”
xbiblio-devel@lists.sourceforge.net
Message-ID: <753C3296-D2B3-47F2-9AA9-CA7FEF4487FE@…393…>
Content-Type: text/plain; charset=“utf-8”
Hi everyone,
I co-founded EasyBib, which is an online citation platform used by over 30M students. We are looking for a citation specialist that can work with CSL and address citation related issues amongst our customers. You?d make a huge impact to our product and to the majority of students across the United States that use our tools.
The pay is competitive and our goal is to contribute back to the community. Responsibilities include and will not be limited to:
-
Continually, thoroughly and objectively assessing the performance and quality of our citation formatting services
-
Updating citation formatting rules based on latest styles and user feedback
-
Being the resident citation guru, fielding customer support questions around issues related to citation formatting and quality
-
Communicating with partners (3rd party companies) that utilize our citation formatting APIs
-
Mapping out projects, deadlines, and managing citation product roadmap
-
Ensuring our commitment to continuous improvement and world-class customer service levels
EasyBib and our other citation products are part of Chegg, an educational company focused on improving students? lives.
Further details and application for the job are here: https://jobs.chegg.com/job/CHEGA0056405/Citation-Specialist---Product-Manager
Looking forward to hearing from you!
Best,
Darshan
-------------- next part --------------
An HTML attachment was scrubbed…
Check out the vibrant tech community on one of the world’s most
engaging tech sites, SlashDot.org! http://sdm.link/slashdot
xbiblio-devel mailing list
xbiblio-devel@lists.sourceforge.net
End of xbiblio-devel Digest, Vol 118, Issue 1