Langenscheiss / bibitnow

Site adjustors for browser plugin "bibitnow"
100 stars 16 forks source link

RFC handling #33

Open rugk opened 4 years ago

rugk commented 4 years ago

They are already quoted in a quite good way, thanks to metadata I guess.

However taking https://tools.ietf.org/html/rfc7230 as an example, it e.g. misses the ISSN.

This is how it is currently done:

@online{Reschke2009Jul,
    author = {Reschke, Julian F. and Fielding, Roy T.},
    title = {{Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing}},
    date = {2009-07-27},
    urldate = {2020-07-30},
    language = {english},
    url = {https://tools.ietf.org/html/rfc7230}
}

Also, I guess, standards are quoted quite heavily, so it is worth it… :blush:

Also note, of course :wink:, there is an RFC for how to quote them:


Using this generator I get this for the example:

@techreport{RFC7230,
  author = {R. Fielding and J. Reschke},
  title = {Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing},
  howpublished = {Internet Requests for Comments},
  type = {RFC},
  number = {7230},
  year = {2014},
  month = {June},
  issn = {2070-1721},
  publisher = {RFC Editor},
  institution = {RFC Editor},
  url = {http://www.rfc-editor.org/rfc/rfc7230.txt},
  note = {\url{http://www.rfc-editor.org/rfc/rfc7230.txt}},
}

Note, I personally would like some changes:

So in my case, I ended up with:

@techreport{rfc7230,
  author = {R. Fielding and J. Reschke},
  title = {Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing},
  howpublished = {Internet Requests for Comments},
  type = {RFC},
  number = {7230},
  year = {2014},
  month = {June},
  issn = {2070-1721},
  publisher = {RFC Editor},
    institution = {{Internet Engineering Task Force}},
    shorthand = {RFC7230},
    note = {RFC7230},
    date = {2014-06},
    urldate = {2020-07-30},
    language = {english},
    url = {https://tools.ietf.org/html/rfc7230}
}
Langenscheiss commented 4 years ago

Hi. That's a new citation type and a lot of new data fields that websites typically do not provide much information about (e.g. howpublished or institution). But since your request is so far limited to rfcs and since technical reports have to be supported at some point anyhow, I guess I can introduce those fields and leave them blank except for ietf sites. At the moment, I am implementing book chapters which already takes quite a bit of time. But I will put it on the list. I agree quoting standards has some relevance so I should look at it at some point. For the moment, I guess you can use the generator and maybe run the output through a script to get your desired result. Once it is supported, you can of course configure all the fields the way you want as usual.

P.S.: Missing ISSN might soon be a much alleviated issue, since I am experimenting with analyzing human-readable website contents for things such as dates etc.. Now ISSN/ISBN is one of the easiest things to detect, so there is hope that such misses can be avoided in the future.

Also, I find it funny how they complain in that RFC how they are not quoted properly, and at the same time provide barely any meta data on their page. They would be quoted much better if they did that at least.

rugk commented 4 years ago

Yeah, maybe you can simplify your work here, because of the standard: https://tools.ietf.org/html/draft-carpenter-rfc-citation-recs-01#section-5.2

It e.g. says you could possibly download a finished bib file online:

We also RECOMMEND that the RFC Editor create and maintain a canonical BibTeX file at a stable public location on the web server "www.rfc- editor.org", so that authors using BibTeX can easily obtain a BibTeX file with all issued RFCs.

Though the generator says:

Although the draft recommends that the RFC Editor create and maintain a canonical BibTeX file at a stable public location on the web server "www.rfc-editor.org", the BibTex files do not seem to have appeared on the website.

But maybe you can use the generator's source code or so…

Langenscheiss commented 4 years ago

Thanks for the information. Unfortunately, this all does not help. I cannot simply use another source code, because it needs to be integrated into the whole logic and structure of the extension. The thing is this. Each additional bibfield needs

Of course you can cut corners in the first implementation, like i did with language (which now is also available in formats other than bibtex, and accessible through format strings), but eventually, all this needs to be set up for a well-working system. Now, just for a single source type, this requires me to do all this loop for several bibfields. That's an enormous amount of work, so simply downloading a (possibly corrupt) bibtex file or integrating someone else's source code (which most likely will not fit easily into the existing system and might also produce bad results in some cases) simply won't do it. And that's not even talking about possible permission issues of using source code or of performing cross-site requests that again asks permissions from the user and makes it harder to get it through review at Google/Mozilla.