migrate events page > quarto

[jules32]

Earlier in April I made a branch and the first steps at migrating the events page from distill to quarto. This is not a huge priority but I wanted to document it here to pick up and complete it. I think that 1-2 hours of co-working might be all we need to finish doing so, especially having read Danielle Navarro's blog post https://blog.djnavarro.net/posts/2022-04-20_porting-to-quarto/. cc'ing @stefaniebutland if there's a week that time-wise makes sense to schedule an hour together to just go for it!

Current status:

• branch with migration: https://github.com/openscapes/events/tree/quarto-convert.
• have to render from terminal quarto render because RStudio IDE still thinks it's distill, see next steps

Next steps:

• [x] update color scheme/css
• [x] remove first 2 fake blog posts
• [x] migrate the thumbnails so they also show up in the post
• [x] Remove anything else that RStudio is still thinking as distill (right now the "build" tab still says "build website" and errors bc it's looking for RMarkdown)
• [x] make sure top navbar stays put when scrolling
• [x] make sure SEFSC exists

What it looks like now:

[stefaniebutland]

cc'ing @stefaniebutland if there's a week that time-wise makes sense to schedule an hour together to just go for it!

Weeks of May 2, 9, or 16 are good for me.

[stefaniebutland]

Stef & Julie coworked on this May 5.

• Stef will start by making thumbnails appear in the blog listing page, remove tags event completed and ping Julie for next step when that's done.
• we'll need to add back /styles.css somewhere (404: Not Found)

[stefaniebutland]

In the Quarto previews, for posts that have a TOC in the live Events page, TOC does not appear. I left the distill bit in these for now.

• /posts/2021-09-17-fdd/
• /posts/2021-09-17-nwfsc/

[stefaniebutland]

See Danielle Navarro's post to fix TOC and Citations. "Specifying the table of contents is slightly different..." "One feature in distill that I like is that it generates a citation for each post..."

[stefaniebutland]

• [x] restore citations
• [x] restore footer
• [x] define TOC
• [ ] update README

Nice to have or need to have?

• [ ] rename files.Rmd to files.qmd (code in Nick Tierney's post)
  • we decided not to do this; left older filenames and YAML structures as is

[stefaniebutland]

Notes on adding citations SHA

• [x] added citation: true to _metadata.yml to have citation in all posts
• [x] fixed date error in Duckles post citation by changing to ISO date format in post (noted in Danielle's post).
• [x] Change date format to ISO in every post
• [x] Restore Retrieved from ...URL to citations. Maybe by setting site-url (Base URL for published website) under the website key in _quarto.yml noted in Quarto docs

Quarto docs citation example:

Preview of Beth's post

[jules32]

Awesome, thanks for this progress @stefaniebutland ! We can plan to co-work more on this on Tuesday :)

[stefaniebutland]

• [x] Stef to remove distill TOCs from here: https://github.com/Openscapes/how_we_work/issues/150#issuecomment-1119237136
• [x] try to get cosmo theme using black background instead of blue. See https://bootswatch.com/cosmo/
  • used Danielle Navarro's theme / css instead
• [x] make sure SEFSC exists

[jules32]

Woohoo nice job @stefaniebutland look at our nice events quarto site!

I wrote up a few notes about distill here - feel free to add any other thoughts. https://openscapes.github.io/quarto-website-tutorial/transition-from-rmarkdown.html#distill-to-quarto

[stefaniebutland]

@jules do we need a redirect as you suspected?

Link in citation for a post gives 404: Openscapes. 2022. “A Qualitative Data Analysis Chat with Beth Duckles.” April 8, 2022. https://openscapes.org/posts/2022-04-08-qda-beth-duckles.

Is that 'cause it's really https://openscapes.github.io/events ?

[jules32]

Ah yes, I think this is because it should be openscapes.github.io listed in the _quarto.yml; we have it redirect only for openscapes.org/events but not for any specific posts from there

[jules32]

OK @stefaniebutland I've fixed this redirect issue by having the correct site-url: https://openscapes.github.io/events: (commit)

[jules32]

And I've fixed the strange issue of the body text showing upby updating the description field (instead of subtitle as it was in distill: (commit)

[jules32]

Hi @stefaniebutland, I've updated the way that we publish the events page, using GitHub Actions and updating our .gitignore after talking to Mine Cetinkaya-Rundel. I've written up notes here as a start, and we can refine them when we do it again (with screenshots, etc): https://openscapes.github.io/quarto-website-tutorial/transition-from-rmarkdown.html#distill-to-quarto.

See what you think, and then let's close this issue! woooo

[stefaniebutland]

Hi @jules32, I added some notes in this PR and proposed Events README update in this PR .

Once you've requested or made edits and merged then we're good to close the issue. Woooooo indeed!

[jules32]

Reviewed and merged! 🥳