final version?

classic Classic list List threaded Threaded
3 messages Options
Reply | Threaded
Open this post in threaded view
|

final version?

Bruce D'Arcus-3
OK, I'm getting close to feeling I'm done with the CSL mods I want to  
make (e.g. calling it 1.0).

Please let me know if you have any suggestions.  Below is an example.  
It's about 30% or so more compact, with more features.

There are a couple issues to clear up, though:

1)  cs:locator-config is a little inconsistent with the other config  
elements (because it configures a caption, rather that a full  
replacement). [shrug]

2)  I have added cs:contributor to handle things like translators. But  
as I've looked into this, it can get a little tricky.  For example, say  
you have an edited collected of someone's original writings; like the  
Walter Benjamin book I just ordered. In that case, Benjamin is the  
primary creator, and the editors then are secondary contributors. E.g  
the hierarchy is somewhat conditional. Indeed, one might say editors  
are always secondary, but they serve as if they were primary in the  
absence of a proper author. Am not really sure how to deal with this  
one. One option is to just list some rules that implementers ought to  
follow; e.g. a hierarchy of contributorship.

I might also need to allow chained alterate-sortkeys: creator -->  
contributor --> title.

<?xml version="1.0" encoding="UTF-8"?>
<?oxygen  
RNGSchema="file:/Users/darcusb/projects/citeproc/schemas/
citationstyle.rnc" type="compact"?>
<citationstyle xmlns="http://purl.org/NET/xbiblio/csl" xml:lang="en"  
class="author-year">
   <info>
     <title>American Psychological Association</title>
     <title-short>APA</title-short>
     <edition>5</edition>
     <author>
       <name>Bruce D’Arcus</name>
       <email>[hidden email]</email>
     </author>
     <dateCreated>2005-05-18</dateCreated>
     <dateModified>2005-12-09</dateModified>
     <sources>
       <source  
type="uri">http://www.english.uiuc.edu/cws/wworkshop/writer_resources/ 
citation_styles/apa/apa.htm</source>
     </sources>
     <field>psychology</field>
     <description>Style for the American Psychological  
Association.</description>
   </info>
   <content>
     <general>
       <name-config and-as="and" et-al="et al."/>
       <date-config jan="January" feb="February" mar="March" apr="April"  
may="May" jun="June" jul="July"
         aug="August" oct="October" nov="November" dec="December"/>
       <locator-config type="page" renderas-single="p"  
renderas-multiple="pp"/>
       <genre-config type="letter" renderas="letter"/>
       <medium-config type="CD" renderas="CD"/>
     </general>
     <citation delimiter=";" prefix="(" suffix=")">
       <use-et_al min-authors="6" use-first="6" position="first"/>
       <use-et_al min-authors="6" use-first="1" position="subsequent"/>
       <item-layout>
         <creator suffix=" ">
           <names-short/>
         </creator>
         <year/>
         <point prefix=": "/>
       </item-layout>
     </citation>
     <bibliography author-as-sort-order="first-author"  
author-shorten-with="———.">
       <use-et_al min-authors="4" use-first="3"/>
       <list-layout>
         <heading>References</heading>
         <section group-by="named group" group-name="primary">
           <heading>Primary Sources</heading>
           <subsection>
             <heading>Published Sources</heading>
           </subsection>
           <subsection group-by="named group" group-name="unpublished">
             <heading>Unpublished Sources</heading>
           </subsection>
         </section>
         <section>
           <heading>Secondary Sources</heading>
         </section>
       </list-layout>
       <item-layout>
         <reftype name="book">
           <creator>
             <names/>
             <role prefix=" (" suffix=")."/>
           </creator>
           <date>
             <year prefix=" (" suffix=") "/>
           </date>
           <title font-style="italic" suffix="."/>
           <contributor>
             <names/>
             <role prefix=" (" suffix=")."/>
           </contributor>
           <origin>
             <place/>
             <publisher prefix=": "/>
           </origin>
           <genre suffix=", "/>
           <medium/>
           <availability prefix=", ">
             <physicalLocation/>
             <url prefix=", "/>
           </availability>
         </reftype>
         <reftype name="chapter">
           <creator>
             <names/>
             <role prefix=" (" suffix=")."/>
           </creator>
           <date>
             <year prefix=" (" suffix=") "/>
           </date>
           <title/>
           <container prefix=", In " suffix=".">
             <creator>
               <names/>
               <role prefix=" (" suffix=")"/>
             </creator>
             <title font-style="italic" suffix="."/>
             <series>
               <title prefix=", "/>
             </series>
             <origin>
               <place/>
               <publisher prefix=": "/>
             </origin>
             <locators>
               <file prefix=", file number "/>
               <pages prefix=", "/>
             </locators>
           </container>
           <availability prefix=", ">
             <physicalLocation prefix=", "/>
             <url/>
           </availability>
         </reftype>
         <reftype name="article">
           <creator alternate-sortkey="container-title">
             <names/>
           </creator>
           <date prefix=" (" suffix=") ">
             <year/>
             <month prefix=", "/>
             <day prefix=" "/>
           </date>
           <title suffix=", "/>
           <container>
             <title font-style="italic" suffix=", "/>
             <series>
               <title/>
               <locators>
                 <series/>
               </locators>
             </series>
             <locators>
               <volume/>
               <issue prefix="(" suffix=")"/>
               <pages prefix=", "/>
             </locators>
           </container>
           <genre suffix=", "/>
           <medium prefix=" (" suffix=")"/>
           <availability prefix=", available from: ">
             <physicalLocation prefix=", "/>
             <url prefix=", "/>
           </availability>
         </reftype>
         <reftype name="legal case">
           <title/>
           <date>
             <year prefix=" (" suffix=") "/>
           </date>
           <container>
             <title font-style="italic" suffix=", "/>
             <origin/>
             <locators>
               <date>
                 <month/>
                 <day prefix=" "/>
               </date>
               <volume prefix=", "/>
               <issue prefix="(" suffix=")"/>
               <pages/>
             </locators>
           </container>
           <genre suffix=", "/>
           <medium prefix=" (" suffix="), "/>
           <availability prefix="available from: ">
             <physicalLocation prefix=", "/>
             <url prefix=", "/>
           </availability>
         </reftype>
         <reftype name="conference paper">
           <creator>
             <names/>
           </creator>
           <date>
             <year prefix=" (" suffix=") "/>
           </date>
           <title suffix=", "/>
           <container>
             <conference font-style="italic" suffix=", "/>
             <origin>
               <place prefix=", "/>
             </origin>
           </container>
         </reftype>
       </item-layout>
     </bibliography>
   </content>
</citationstyle>



Reply | Threaded
Open this post in threaded view
|

Re: final version?

David Wilson

--

-------------------

David N. Wilson

Co-Project Lead for the Bibliographic

OpenOffice Project

http://bibliographic.openoffice.org


comments.html (8K) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: final version?

Bruce D'Arcus-3
Hi David,

On Dec 30, 2005, at 8:04 PM, David Wilson wrote:

> I have looked up my Chicago based style guide regarding the handling
> of editors. I have notice that these book are not good at providing a
> set of principles or rules or rather that rules are somewhat arbitrary
> and have exceptions. Anyway some relevant examples it discuses -
>
> .... an edited or translated work in which the author's name is
> mentioned in the tile. Here the author's name as the first item is
> omitted, although tit might properly be inserted even through it is
> not on the title page -
>
> 1. The works of Shakespear, ed Alexander Pope (London: printed for
> Jacob Tonson in the Stand, 1725), 6:20
>
> Although the foregoing arrangement , which gives the editor's name
> following the title, is most commonly used for this kind of work, in a
> paper dealing with the work of Pope it would be permissable to give
> his name first, followed by ed.:
>
> 1. Alexander Pope, ed. The works of Shakespear (London: printed for
> Jacob Tonson in the Stand, 1725), 6:20
>
> Now these are Chicago 'rules' so they might not apply to APA.

Some styles do have these brain-dead details that were obviously
designed for people who manually create their references. I can't help
but feel these are corner cases. Note that the first rule above is a
suggestion, rather than a requirement.

> But these question remains how to deal with it in CSL? If this record
> has been downloaded from the library and you do nothing to it ‘William
> Shakespeare’ would appear as author. And you would not want to remove
> William Shakespeare’ as author form you DB entry.

Correct.  I wouldn't feel bad if it rendered like this though.

> It seems to me that you need some flags or settings with either, or
> both, the document version of the database reference, or for
> individual citations, like 'Suppress Author', 'Place Editor as first
> element'. I think you have expressed the desire to dispense with such
> flags if possible.

Yes, just because I hate needless complexity, where the experience for
the 99% of standard cases get more complex to accommodate edge cases.

My goal is to get as far as we can get without relying on that, and
then only add it if it becomes a practical problem. These details would
probably be independent of CSL anyway.

> Some options that do not use flags.
>
> Allow the user to to modify the render-as field of Author for the
> document version of the reference. This would generally just be copied
> from the database Author field. If the user deletes the text so the
> entry is blank. Have rule if render-as is blank do not insert the
> element.
>
> However 'Place Editor as first element' seems to be a genuine user
> selection for how they reference is formatted so I do not see how you
> can escape the use of a user set flag.

Maybe. But I did explain there are options to avoid that.  One is:

<creator alternate="contributor" secondary-alternate="title"/>

So if there is no author, it first looks for a contributor (like
editor).  If that's not there, it uses the title. That's currently how
formatting of periodical articles is configured. If there is no
"author" it uses the periodical title instead ("New York Times", say).

The other option is just an informal (but documented) rule in the
processor.

Bruce