sparcopen / infrastructure

A home on the web for our community owned infrastructure work.
https://infrastructure.sparcopen.org
MIT License
4 stars 2 forks source link

make it easier to cite posts #49

Closed JosephMcArthur closed 4 years ago

JosephMcArthur commented 4 years ago

We have some examples for how to cite here: https://osf.io/preprints/lissa/a7nk8/

APA Aspesi, C., Allen, N. S., Crow, R., Daugherty, S., Joseph, H., McArthur, J. T. W., & Shockey, N. (2019, November 19). SPARC Roadmap for Action: Academic Community Control of Data Infrastructure. https://doi.org/10.31229/osf.io/a7nk8

MLA Aspesi, Claudio, et al. “SPARC Roadmap for Action: Academic Community Control of Data Infrastructure.” LIS Scholarship Archive, 19 Nov. 2019. Web.

Chicago Aspesi, Claudio, Nicole S. Allen, Raym Crow, Shawn Daugherty, Heather Joseph, Joseph T. W. McArthur, and Nick Shockey. 2019. “SPARC Roadmap for Action: Academic Community Control of Data Infrastructure.” LIS Scholarship Archive. November 19. doi:10.31229/osf.io/a7nk8.

I think it would be rather nice to allow one of this to be copied. Thinking at the level of post, 'cite it' could appear in the same spot as download. Not sure about what to do on reports.

Some front matter could set the citation, when we have it.

Also, the DOI will also feel 'academic' to folks, so showing that might just be helpful.

JosephMcArthur commented 4 years ago

For posts without reports, we may want to promote citation too. I don't 100% know what's best to do there, perhaps folks should just write it in when posting.

sssoz commented 4 years ago

I can take care of this if you want. I already have a bit of code (in a different templating language) for APA / MLA / Chicago-style citations.

JosephMcArthur commented 4 years ago

Ace! Please do. The citation for the landscape analysis is here: https://osf.io/preprints/lissa/58yhb.

Joseph McArthur Assistant Director: Right to Research Coalition ( http://righttoresearch.org ) Director / Founder: Open Access Button ( http://openaccessbutton.org ) Twitter: @Mcarthur_Joe ( https://twitter.com/Mcarthur_Joe ) Skype: joseph_mcarthur

On Wed, Jun 17, 2020 at 5:43 PM, Sophy < notifications@github.com > wrote:

I can take care of this if you want. I already have a bit of code (in a different templating language) for APA / MLA / Chicago-style citations.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub ( https://github.com/sparcopen/infrastructure/issues/49#issuecomment-645487605 ) , or unsubscribe ( https://github.com/notifications/unsubscribe-auth/ABFZMZZCIIEZSNEMSDZ7MT3RXDXCDANCNFSM4N73MTRA ).

sssoz commented 4 years ago

For now, all the posts are authored by

Aspesi, Claudio, Nicole S. Allen, Raym Crow, Shawn Daugherty, Heather Joseph, Joseph T. W. McArthur, and Nick Shockey

?

Or should we add frontmatter for the author(s) of every post?

sssoz commented 4 years ago

I guess that would tie this issue to #73

JosephMcArthur commented 4 years ago

Nope, they can differ per report (that's only correct for the first). Presuming this just sets the authorship of the citation, then yes I think just using some frontmatter is great.

sssoz commented 4 years ago

Nope, they can differ per report (that's only correct for the first). Presuming this just sets the authorship of the citation, then yes I think just using some frontmatter is great.

Clarifying again, we want post- ("article-") level citations but we’re not sure about what to do at the report-level? I’m confused because the sample citation you mention up there has a DOI assigned to the full report, not the single posts (which I think you broke down into shorter posts on the website).

I have committed the template to generate APA, MLA, & Chicago-style citations, which can be used / included in both thread.html (for reports only) and post.html. Just need to better understand what goes in the authors and DOI fields.

sssoz commented 4 years ago

Oh and another thing -- the original citations also include the archive (which we do not include in our frontmatter, but won’t be a problem if it’s always going to be on LIS Scholarship Archive), and a subtitle. Do you still want the subtitles?

sssoz commented 4 years ago

Report-level citation

daddd58664bc03d4d6290cdbb8b91c0b


Post-level citation

3ade4015d34b6f01125bf7a94df4e96a


In order to assign specific authors on a post OR a thread, you just need to list out their "short names" in the front matter for either type of file, like this:

---
layout: thread
title: SPARC Landscape Analysis
authors:
  - claudio
  - nicole
  - raym
  - shawn
  - heather
  - joe
  - nick
[...]
---

You can create a new author in the _data/authors.yml file. For now, I have everyone + Shawn Daugherty, and "SPARC" as a single entity, if ever you need to use that as an author.

sssoz commented 4 years ago

This is resolved in 9c469d6eb7e563a7e13a5370b4d78ee55f5b6ebe

sssoz commented 4 years ago
sssoz commented 4 years ago
  • Add post-level URL
  • Add report name to which a post belongs

f88ac5701d7f3672332919987fa093ff


Something else to consider: the right column is starting to become very bloated, especially since it’s "sticky". We should consider moving some of these elements into icons and having them stick on the left side instead (which is already sticky )

JosephMcArthur commented 4 years ago

Small things

JosephMcArthur commented 4 years ago

I need to do this: https://docs.netlify.com/domains-https/custom-domains/configure-external-dns/#configure-an-apex-domain

JosephMcArthur commented 4 years ago

Where did we land with specifying authors for citation and authors for the author box?

sssoz commented 4 years ago

Pushed the two small things to dev!

Where did we land with specifying authors for citation and authors for the author box?

I think it should reflect the authors’ box to keep it simple -- so in all cases, for now, the authors in the citation would be Claudio & SPARC (no specific names). It wouldn’t be the same as the citations on LISSA, but it’s up to you. I still don’t fully understand how you want to attribute authorship on a per-post basis.

sssoz commented 4 years ago

The full about page (/about/) could explicitly mention that SPARC is Nicole, Heather, Nick, Raym,... You (etc.).

JosephMcArthur commented 4 years ago

Gotcha. Let's leave it as is for now. Can you make sure you've taken out any placeholder authorship info?

sssoz commented 4 years ago

Done! And pushed to dev

sssoz commented 4 years ago

Citations’ authors are also the same as the author infoboxes’. I also think we should remove the fixed sidebar... the text might be cut off at the bottom for many users.

JosephMcArthur commented 4 years ago

on mobile I think we should hide this, and related. It just turns up at the bottom and I think simplifying makes sense.

image

sssoz commented 4 years ago

Donee & pushed on dev