OpenScienceMOOC / Module-5-Open-Research-Software-and-Open-Source

Module 5: Open Research Software and Open Source
https://eliademy.com/catalog/oer/module-5-open-research-software-and-open-source.html
MIT License
74 stars 52 forks source link

Citation Style and starting a Zotero Group? #20

Open mrchristian opened 6 years ago

mrchristian commented 6 years ago

What citation style are we using?

Can we start a Zotero group to store sources being used. It's more efficient and lost can be done with it, FYI we can embed all the citations so that a user can choose to download all or some of the citations in one go.

I could start one up!

Simon

Protohedgehog commented 6 years ago

Erm, that's a good question. At the moment, It's just (Author, date), and then links to the full OA text included in the reading list. Each module has its own reading list (like here), is that enough to work with for now?

Protohedgehog commented 6 years ago

I just made this a bit easier to do, hopefully, by putting all the files in a directory here: https://github.com/OpenScienceMOOC/Main/tree/master/Reading%20material

mrchristian commented 6 years ago

Let me look at a simple Zotero workflow for being able to list references at the end of each module and/or task. I think I can create a MD output to easily copy paste into docs.

It's my inner-librarian that tells me we need to have citation lists :-)

Protohedgehog commented 6 years ago

That would be awesome, thank you Simon! :)

jcolomb commented 6 years ago

Since we are using .md files, I think we will need a zetero to bibtex to referemce list workflow (?). Is this working in pure .md or do we need a different tool (.Rmd would do the work I tink).

We will also need to look into zotero/zenodo integration and how zotero deals with software citation (but that is another question).

Am 28. Juli 2018 15:06:47 MESZ schrieb Jon Tennant notifications@github.com:

That would be awesome, thank you Simon! :)

-- You are receiving this because you are subscribed to this thread. Reply to this email directly or view it on GitHub: https://github.com/OpenScienceMOOC/Module-5-Open-Research-Software-and-Open-Source/issues/20#issuecomment-408606862

-- Diese Nachricht wurde von meinem Android-Gerät mit K-9 Mail gesendet.

mrchristian commented 6 years ago

Bibtex, AOK. Zotero can defo output BibTex. Manually and automatically I believe. I'll get the sample entries for Software Citation section finished and then give it a shot.

I made a start on the Gen R collab lib, when tested I'll make a dedicated OS MOOC group. https://www.zotero.org/groups/1838445/generation_r/items/collectionKey/NKI8CF9E

Just needed to make a better selection about what to cite :-)

Re: Software Citation in Zotero. They have a top level category for 'code' AKA software, and you can make your own CSL, whether this then is maintained in BibTex will take some testing.

FYI Ive been playing around with Zotero API for a while and you can easily get Zotero to render out collections live to HTML, so most likely BibTex too. https://github.com/TIBHannover/collaborative-library-prototype Its my pet project, but like all pet projects it never gets enough time :-) It makes a site like this using GitHub pages https://tibhannover.github.io/collaborative-library-prototype/index.html

Protohedgehog commented 6 years ago

Hey @mrchristian @jcolomb, how're things looking on this? Is there a citation style guide in prep or does this still need to be worked out?

mrchristian commented 6 years ago

We need to do what @jcolomb suggested, work out a Zotero to .md .rmd workflow. First question for me at least is what is the writing/rendering tool your using now for OSMOOC? We would need to look at how to marry this to Zotero. It should be possible.

Protohedgehog commented 6 years ago

@mrchristian I'm just using RStudio! And using normal markdown, but I imagine converting md to Rmd if needed should be fairly trivial.

mrchristian commented 6 years ago

We can try it out. I'll have a bash tomorrow

Protohedgehog commented 6 years ago

Awesome, thanks @mrchristian! If needed, we can always have a mini-hackathon in Berlin some time in the near future :)

mrchristian commented 6 years ago

That's a good idea, I'm up for it :-) Would be good to talk about the plans for moving content into video production if that's on the cards too. I also need to finish the Software Citation stuff, I have the notes written down about what needs doing, just need to transcribe. The delay was part that I discovered some very puzzling questions once I put my head under the bonnet of the Zenodo setup :-) Like heh?

Protohedgehog commented 6 years ago

This is why you never look under the bonnet ;)

I've already started migrating some content into audio/visual content too. This is basically just the Main.md file in audio: https://www.youtube.com/watch?v=BHrOEmKk5zM (also on Soundcloud) and this is a screencast for Task_1.md: https://www.youtube.com/watch?v=AnftV9HBPSc - was planning on doing this for the other 2 tasks shortly too. Do you think this is sufficient? I didn't want to be toooo video heavy. We also have a short intro video for this module in prep too.