stan-dev / stan-dev.github.io

Stan website based on the So Simple Jekyll theme.
https://mc-stan.org/
20 stars 38 forks source link

bibliography bibtex format #35

Open tpapp opened 7 years ago

tpapp commented 7 years ago

Wishlist item: having the citations page available in BibTeX format.

Solution suggestion: I don't know how the build process of the site works, but perhaps jekyll-scholar could be useful.

bob-carpenter commented 7 years ago

Thanks for making the suggestion in the form of an issue. I'm pretty sure Michael decided to axe the citations rather than try to make them more useful. The problem we have is that they only represent a small fraction of the Stan publications and we don't have the energy to curate a proper list.

betanalpha commented 7 years ago

Yes, we cannot accurately curate citations at the moment and so we will be removing them from the website. But any project to maintain an automated bibliography of citations would be welcome.

On May 24, 2017, at 2:01 PM, Bob Carpenter notifications@github.com wrote:

Thanks for making the suggestion in the form of an issue. I'm pretty sure Michael decided to axe the citations rather than try to make them more useful. The problem we have is that they only represent a small fraction of the Stan publications and we don't have the energy to curate a proper list.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/stan-dev/stan-dev.github.io/issues/35#issuecomment-303804004, or mute the thread https://github.com/notifications/unsubscribe-auth/ABdNlk9EkUPlrBg0dUwDt1CeW5MS8KL3ks5r9HBsgaJpZM4Nk42A.

tpapp commented 7 years ago

I was actually looking for a BibTeX entry to cite the Stan manual. I recognize that providing a comprehensive citation page is burdensome, but I wonder if it would be possible to have a single, up to date .bib file with entries for

  1. the Stan project and the prominent papers,
  2. all the stan manuals,
  3. and possibly the papers they cite.

Since the manuals already use BibTeX, those entries already exist, eg for Stan, rstan, etc. They would just need to be merged as a single file and made available.

Then this could be displayed under citations, converted to HTML with jekyll-scholar or similar.

bob-carpenter commented 7 years ago

Interesting. The BibTeX is here for the Stan language manual: https://github.com/stan-dev/stan/blob/develop/src/docs/bibtex/all.bib

It's not very well curated, but if someone wanted to fix it, that'd be great. It'd be easy to add all the manuals and at the very lest just point people to it.

I hadn't seen jekyll-scholar before. It doesn't integrat with GitHub pages and it's more to configure than I have the spare time to take on, but if someone else wants to figure it out and take the responsibility of maintaining the bib going forward (these things are easy to start, but much harder to maintain), this should be pretty easy.

ctross commented 6 years ago

I think just adding this to the markdown file will place a nice Bibtex citation:

@Misc{stan2018,
    title = {Stan Modeling Language Users Guide and Reference Manual, Version 2.18.0},
    author = {{Stan Development Team}},
    year = {2018},
    url = {http://mc-stan.org/},
  }
bob-carpenter commented 6 years ago

We used to do this, but it was all just too confusing to navigate. Maybe BibTeX citation popups like on Google Scholar?