8 thoughts on “How to write a post containing references to journal articles.

  1. If you use the form, it just tries to generate a tag based only on what you’ve entered. If you include the pmid in the HTTP GET request, like so: http://generator.ocoins.info/?id=pmid:17433565&sid=pubmed then it will resolve the PMID and spit out the tag with the corresponding info. In other words, you have to either pass the pmid in the URL or enter title, journal, page number, etc., in the form. It worked two weeks ago just by entering the PMID in the form, then they changed something.

    I know it’s not very user-friendly, but I don’t think they expected it to see much use beyond librarians and other nerds, and here I go drawing attention to it.

  2. Alf, in a comment on an earlier post, reminds me that Postgenomic uses rev=’review’ in the a element or the hReview microformat.

    The hReview microformat is particularly good because is contains a means to distinguish between a post which is a review and individual reviews within the post. See the section on Object Includes. There’s no way to indicate this using COinS.

  3. The problems I have with the hReview format is that they seem to want to use h2 elements for the summary, which works for short one line summaries but not for a paragraph summary, unless I were to restyle the h2 element to make it look like the body text style, but then that doesn’t make sense and would mess up anywhere else I would want to use it.

    rev=’review’ is really simple, but should only be used when a post is about one item in particular. [EDIT: apparently I was wrong about this. Use it as much as you like.]

    hReview has a mechanism for dealing with this, but if I’m going to be expected to remember a bunch of abbreviated class names I might as well embed RDF.

    I’ve been a spectator for a while, and I’m just starting to actively use some of these technologies, but now that we’ve got some tools that can do useful things with metadata, such as Piggybank, Exhibit, Zotero, Postgenomic, etc the time is ripe for improvement on the metadata authoring side.

  4. You didn’t mention the number one rule: cite the URL to the DOI, and not the URL on the publisher’s website. First of all, not all papers are on Pubmed; if they are, the PMID can be discovered based on the DOI…

  5. You’re right about the DOI. It’s a far more universal identifier than the PMID.

    What I’m trying to do is to show Joe Scienceblogger that there’s an easier and better way of identifying their review-containing posts than linking to a icon.

    Using rev=’review’ in the link is a great and hidden-error(like mistyped page number) resistant way to do it, but I still feel like having the metadata in the post itself may be valuable, and since they’re all being set up to use COinS by the bpr3 people anyways, might as well explain how to do it right. Should I recommend putting the rev=’review’ in the DOI URL, or in the URL the DOI resolves to?

    Of course, using the DOI instead of the PMID to generate the COinS as above works, too, but it lacks the article title and some additional fields that a PMID lookup has(I don’t know if that’s specific to that particular generator), so for the purpose of getting as much metadata as possible in the post itself, I’m recommending using the PMID, if available, to generate the data. This does result in the DOI being present in the COinS.

  6. Pingback: Citing journal articles in blog posts and blog posts in journal articles at Synthesis

Leave a Reply

Your email address will not be published. Required fields are marked *