porting blog posts

[samanthacsik]

I have no idea exactly how to automate porting blog posts from the blogdown site to the new quarto framework, but here's where things currently live/look like in the blogdown framework & how they need to be set up in the quarto framework:

Comparing frameworks

Blogdown

• . md files all in one directory (content/blog)
• media, preview imgs, etc. in static/img/blog
• example yml:

  ---
  title: "Impacts of Openscapes Training on Open Science Movement Building Inside NOAA's Alaska Fisheries Science Center"
  author: Emily Markowitz, Margaret Siple, Josh London
  date: '2023-02-16'
  slug: 2022-noaa-afsc-fall
  categories:
  - community
  - impact
  - champions
  tags:
  - noaa-fisheries
  banner: img/blog/2022-afsc-zoom-square.png
  ---

Quarto

• all posts live inside the /blog directory; each post is named index.qmd file in individual folders inside /blog (e.g. blog/yyyy-mm-dd-my-blog/index.qmd)
• media, preview imgs, etc inside folder with corresponding blog post
• example yml

---
title: "This is a blog post title"
author: Sam Csik, Julie Lowdnes
date: 2023-03-21
categories: 
  - cat1
  - cat2
  - cat3
image: my_img.png
---

Brainstorming how to do this:

I think a bash script may be the way to go? (TODOs are not necessarily listed in order)

For each .md file, create a folder inside blog/ -- this requires:

1. the date of publication (parse this from the yaml?)
2. a short name (the current .md file name?)
3. combining the date & short name to create a folder name

Create an index.qmd file inside the folder

• touch index.qmd

Create yaml for reach index.qmd file -- most yaml options will remain the same, though the following need to be updated/changed:

• don't need to change: title, date, author
• change: combine categories & tags from blogdown yaml; put all under categories option in quarto yaml
• change: banner > image
• change: slug > none (but will probably be useful to creating redirects?)

Copy over body of blog

Pull images from static/img/blog and add to folder with corresponding blog post

• find all image names used in blog post (e.g. grep 'png\|jpg' fileName_or_filePath)
• copy matching images from static/img/blog (potentially helpful resource) & paste them into folder
• change image file paths in blog post > image name

[jules32]

Great news - note from Carlos Scheidegger:

I don't think you're far off from what will be required, but I want to note at least one thing: the image field supports "project" paths. If you write (for example) image: /static/img/blog/2022-afsc-zoom-square.png, then quarto should be able to find that image, assuming that there exists a static/img/blog folder at the project top-level

New posts can use the relative path syntax if you'd prefer, but this would simplify porting the existing old posts, since "all" you have to do is read the YAML, and replace banner: X with image: /X (if that makes sense)

[samanthacsik]

Linked this issue for reference in the Adding blog posts wiki and closing it here to clean up issues

[jules32]

This is so huge, congrats Sam! 🎉