statnet / ergm

Fit, Simulate and Diagnose Exponential-Family Models for Networks
Other
94 stars 36 forks source link

Organise help bibliography using Rdpack? #468

Open krivit opened 2 years ago

krivit commented 2 years ago

I did it experimentally with https://github.com/statnet/ergm.multi, and it's really nice: you just put a bib file in inst/, replace parenthetical and text citation with \insertCite{key}{package} macro, put \insertAllCited{} into the references section, and it just works. (Details in the vignette.)

It doesn't require any technical skill, just a lot of text editing.

martinamorris commented 2 years ago

Definitely worth considering. I've just started using bibs for the workshops (h/t @mbojan), seems to be integrated into Markdown -- mimics bibtex. You probably already know about this, but just in case -- the bib is identified in the yaml up top, cites look alot like bibtex, and refs are automatically added at the end. Example from the statnetWeb workshop. I don't know if this works for packages, but it's simple.

krivit commented 2 years ago

Also, it looks like you can reference the bibliography made for Rdpack from vignettes, though I haven't tested this on Windows.

mbojan commented 2 years ago

Nice! I need to have a look at this. Does it work at build-time, install-time or render-time? Build-time would make most sense...

krivit commented 2 years ago

Based on Rdpack source code, it's at build time.

krivit commented 2 years ago

Also, it looks like you can reference the bibliography made for Rdpack from vignettes, though I haven't tested this on Windows.

Also tested it on Windows.

krivit commented 1 year ago

Added Rdpack in fa8d47996c753bd443559446c36e9894732fd39e, forgot to tag. Need to port over all the references.