RockefellerArchiveCenter / ATReference

The ATReference is an extended version of the Archivists' Toolkit that includes a reference module designed by the Rockefeller Archive Center
8 stars 2 forks source link

Bibliography Report #82

Closed mhudspeth closed 13 years ago

mhudspeth commented 13 years ago

Create Bibliography reports with full citations of the publications in PDF, RTF, and HTML format. Need 4 options, sort: Alphabetical by author last name, linked Subject, Publication Type, Year of Publication.Potential issues include foreign languages and symbols, capturing “trans.” or “ed.” notation, and proper formatting for title based on publication type (i.e. italics for book title versus quotations for article title). See RAC website for sample Bibliography: http://www.rockarch.org/publications/biblio/scholarship.pdf.

leemandell commented 13 years ago

This seems like a JIRA report.

StevensBrian commented 13 years ago

Is this MLA or Chicago form - Marisa, could you confirm that?

I'm not sure why foreign languages would be an issue.

The translated or edited notation is not in the data currently. Another issue that occurs to me; if the publication's primary author is not the patron you are crediting the publication to, the citation might make it appear that the patron is the primary author.

I think that rather than adding a bunch of fields to the publication record there could be a bucket to enter a citation for the publication. (I'm not sure that it's possible for the text entry box to store formatting like underlines and italics.) A publicationCitation field would preclude the need for us to design a citation machine and commit to a bib format.

Lee - I'm thinking that I will need to have a list of subjects linked to publications, so wouldn't this have to be a report in the Subjects functional area?

leemandell commented 13 years ago

I think what you will need is a method call that will give you a list of subject from the perspective of the publication record.

StevensBrian commented 13 years ago

It might also be nice to have a report that is just subjects and names that are linked to patronsVisits or patronPublications.

StevensBrian commented 13 years ago

I'm using http://citationmachine.net and http://www.easybib.com/ as models to determine the format for a bibliographic citation in Chicago style. They basically give you these publication types:

Book Journal Article Magazine Article Web Page or Other Online Posting Online Journal Article Film Thesis

So we could have these publication types by default in the dropdown menu. Any other publication type could get a "generic" format say like a journal article.

Here are some suggestions of fields we would need added to the patron publication table:

Volume Number
Issue Number
Page Number(s)
URL Date Accessed (by default - could this be the date the patron publication record is created?) Medium (For film, video, tv or radio) creator role

mhudspeth commented 13 years ago

Hi Brian,

I was referencing this page as a guide: http://www.chicagomanualofstyle.org/tools_citationguide.html. It breaks out the publication options a bit more.

I had come up with the same basic list of additional fields as you, except with the addition of Location of Publication, Publisher, and Publication Date as split into 3 separate fields. Some of the other publication types listed in this guide, such as blog posts, email, etc. look like they may need other information as well. Should I create a list that breaks out which fields would be needed for each publication type? Would the fields that would appear be specific to which type of publication you select?

StevensBrian commented 13 years ago

You're going to need a list of fields regardless of publication type. Lee should be consulted but I'd think that there would be a lot of programming overhead to have publication type driving what fields will be viewed for entry.

leemandell commented 13 years ago

Making the UI change based on publication type will probably be around 5 hours of additional programming time.

mhudspeth commented 13 years ago

2.0.13 test unsuccessful. Not all the publication information is appearing in the report. Only displays Publication Author, Publication Title, Publisher, and Publication Date.

StevensBrian commented 13 years ago

These fields are in the report for the next release. A bit of clarification - I have to design the report based on the last release; so this report was written for 2.0.12. When 2.0.13 came out, I was able to incorporate all the new fields.

beckyrobbins commented 13 years ago

Brian-- Marisa decided on these default values for publication type, based on Chicago Manual of Style:

Book Journal article Article in a newspaper or popular magazine Book review Thesis or dissertation Paper presented at a meeting or conference Website Audiovisual material

The style guide displays two options for journal article: Article in a print journal Article in an online journal We don't need these separated out in our report. Let us know if this is a reasonable list. Thanks

StevensBrian commented 13 years ago

Those seem fine to me. I need to write a routine for a conference paper, book review and AV citations. I will write the formulas in the report to look look for the above text to determine the type of publication.

I think you should break out Journal Article (print) and Journal Article (online) - They have slightly different citation styles. But if you don't want to, I can write logic into the report to determine that something is online if it contains URL data.

beckyrobbins commented 13 years ago

From Marisa:

No, I don't think breaking them out just because they have different citation styles makes sense, especially if he can build the logic into to account for it. I don't want to open this door - it could lead to then having to break out even more publication types additionally by format, like print versus online newspaper or even print versus online book....

Thanks, let us know if you have any issues.

StevensBrian commented 13 years ago

OK. I'll build the logic.

A few other things that I could use some clarification on:

Here is a sample citation for a film on DVD:

Lang, Fritz. Metropolis. 124 minutes. Universal Films A.G (UFA), 1927. DVD

We don't have buckets for: length and format but one could probably assume "Lang, Fritz" as publicationAuthor; "Metropolis" as publicationTitle and "Universal Films A.G. (UFA)" as publisher; and maybe "124 minutes" as pages; but it would not be very obvious to users where to enter this data given the current field labels.

The same kind of mapping issues exist for conference papers and book reviews (book reviews can have actual titles or just have the title of the piece being reviewed).