locdb / locdb-frend

Fr(ont-)end for the Linked Open Citation Database.
https://locdb.github.io
GNU General Public License v3.0
6 stars 2 forks source link

Short format for resources #186

Closed lgalke closed 6 years ago

lgalke commented 6 years ago

Striving for a unified short format for resources, we would like to adapt some commonly chosen reference format, such as ACM:

Sean M. McNee, Istvan Albert, Dan Cosley, Prateep Gopalkrishnan, Shyong K. Lam, Al Mamunur Rashid, Joseph A. Konstan, and John Riedl. 2002. On the recommending of citations for research papers. In Proceedings of the 2002 ACM conference on Computer supported cooperative work (CSCW '02). ACM, New York, NY, USA, 116-125. DOI=http://dx.doi.org/10.1145/587078.587096 

We are also open for suggestions regarding the exact format. For now it would be: <authors>. <year>. <title>. in <container-title>. <DOI>

zuphilip commented 6 years ago

The ACM format looks for me okay and it is somehow standardized. There is ISBD but this comes from (printed) card catalogues. Some library journals use CMoS, but personally I prefer to have the date information at the beginning. Thus, you can IMO continue with ACM style (maybe we can reconsider that if this new feature is in place).

chah3d commented 6 years ago

Shortform Entries: selection_058

Shortform Ressources: selection_059 (<authors>. <year>. <title>. in <container-title>. <DOI>)

lgalke commented 6 years ago

This looks already promising. We just need to take this one step further to align it with the new data model. @chah3d can we meet tomorrow regarding this?

zuphilip commented 6 years ago

(Nit: The in after a point should start with a capital letter, i.e. In.)

lgalke commented 6 years ago

Just to make sure: When there is a container resource ("In: ..."), the year should correspond to the publicationYear of the container. Is this correct, or does it also somewhat depend on the format (e.g. where the year is placed). Of course, most of the time, in theory, the two match, but our application is not theory and it is relevant for implementation. Would prefer to have a guideline here, rather than pick anything that is non-null. A clear preference of which publicationYear to pick would help already.

Regarding where to place the year, @zuphilip can you point us to some standardized format which has the publicationYear at the beginning and fits our needs also in other aspects?

lgalke commented 6 years ago

Starting from the 5 formats google scholar offers, there are two with year in front:

APA

Blom, H. A., & Bar-Shalom, Y. (1988). The interacting multiple model algorithm for systems with Markovian switching coefficients. IEEE transactions on Automatic Control, 33(8), 780-783.

or Harvard

Blom, H.A. and Bar-Shalom, Y., 1988. The interacting multiple model algorithm for systems with Markovian switching coefficients. IEEE transactions on Automatic Control, 33(8), pp.780-783.

The only differ in whether the year is braced or not and the and symbol/word. Would prefer to stick to some well-known style which fits, rather than adapt something slightly and thus, create our own style. When do you put the leading "In" and when not? I see it in the same style sometimes with and sometimes without In?

zuphilip commented 6 years ago

When there is a container resource ("In: ..."), the year should correspond to the publicationYear of the container. Is this correct, or does it also somewhat depend on the format (e.g. where the year is placed).

There is no different semantic when the year is placed before the title or after. Actually, there is not one Harvard style, but this is rather a synonym for any author-date style, i.e. a citation style starting with author and date information. Traditional journals are published as complete issues and therefore the publication date of the article is equal to the publication date of the issue it is in. Nowadays, there are also journals without issues where the articles are published on a continuous base. Anyway, in our process the date is coming either from the metadata in the catalog or from the OCR. --> There is no difference in where to place the date information. However, for our process, the year is IMO more important to see fast and compare with the suggestions and thus I would suggest to have this before the title.

Would prefer to have a guideline here, rather than pick anything that is non-null. A clear preference of which publicationYear to pick would help already.

I am not sure I understand the circumstances that we have two dates here, but given that this case occurs: We should prefer the date of the article over the date of the container.

Regarding where to place the year, @zuphilip can you point us to some standardized format which has the publicationYear at the beginning and fits our needs also in other aspects?

I really think we shouldn't care that much about a citation style here but rather take a simple enough rule to display the bibliographic information. It is fine to be inspired by some citation styles, but there is no need to follow them exactly.

More Details The APA style guide is a book containing at least 300 pages. The [CSL implemention of the APA style](https://github.com/citation-style-language/styles/commits/master/apa.csl) was steadily improved and this takes time we should spend to other tasks. However, it might be crucial to see the DOI as well, which GoogleScholar does not show and therefore their APA formated string is wrong. But you see that for journal articles the journal title is put into italics instead of using an 'in'. But for us it is for example not clear in this state whether we deal with a journal article or an article in a proceeding. Put always an ' in' or put the container title always in italics is for our purposes fine.
lgalke commented 6 years ago

Thanks for all these details. This helps.