Open tpapp opened 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.
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.
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
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.
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.
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/},
}
We used to do this, but it was all just too confusing to navigate. Maybe BibTeX citation popups like on Google Scholar?
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.