Blog icon, by Brendan Mitchell
Anticipated deliverable(s)
By the end of today’s workshop, you should have:
- a blog listing page as a new navbar tab on your Quarto website
- the skeleton of your first blog post
Learning objectives
By the end of today’s workshop, you should be able to:
- create the appropriate folder and files structure to add a new blog post to your Quarto website
- configure your blog post using various YAML options
- add footnotes, citations, and a bibiliography
- create additional listing pages to organize and display content on your website
Pre-workshop Prep
A. Choose your listing page style
A blog listing page is a web page that displays all of a blog’s posts. Quarto provides three built-in listing page styles to choose from. Check out the previews and identify which you might want to use ahead of class.
Workshop Materials
| Content Type | Materials | Notes |
|---|---|---|
| Slides | Adding a blog to your existing Quarto website | Instructions for adding a blog to your existing Quarto website |
What should I continue working on?
- Check out some data science blogs! Reading other data science blogs is the best way to get a sense of not only the breadth of topics that folks in the community are writing about, but also the tone, writing styles, and creative approaches you might take as a blogger. Here are some example posts and bloggers that I really enjoy:
A handful of posts to showcase some different writing styles and topics areas:
- An introduction to Python for R Users, by Rebecca Barter
- My first live coding interview, by Maya Gans
- Notes from live code review of
{soils}, by Jadey Ryan - Creating typewriter-styled maps in
{ggplot2}, by Nicola Rennie - Porting the Openscapes website from blogdown to Quarto, by Sam Shanny-Csik
- Using Amazon S3 with R, by Danielle Navarro
- Slidecrafting 101: Layout, by Emil Hvitfeldt
And a few additional fun blogs to keep an eye on:
- Meghan Hall
- Meghan Harris
- Crystal Lewis
- Cosima Meyer
- Beatriz Milz
- Shannon Pileggi
- Albert Rapp
- Nicola Rennie
- Cédric Scherer
- Cara Thompson
- Nick Tierney
- Isabella Velásquez
- rostrum.blog (by Matt Dray and Adriana De Palma)
Some bloggers have a really recgonizable brand, including:
- Cédric Scherer’s blog is one of the first places I turn to when I’m looking for data viz /
{ggplot2}content - Crystal Lewis’ blog features lots of tutorials and conversations about data management practices
- Danielle Navarro’s blog largely chronicles her experiences learning new tools and creating generative art
NOTE: You (most likely) will not have your brand identity fully sorted and solidified by this point (and that’s perfectly okay!). The above examples are meant to show how working towards finding your brand can (over time) help build a pattern of trust that draws visitors back to your website in search of familiar content.
- how your past professional or personal interests led you to pursue a degree in environmental data science
- non-data science skills / experiences that you’ve found to be transferable to your data science learning journey (in perhaps surprising / unexpected ways)
- advice you wish you had before beginning a data science graduate program
- writing a data product-focused MEDS Capstone or MESM Group Project proposal
- reflecting on the MEDS 6-week summer coding bootcamp
- your journey towards discovering your personal brand identity / building your website(!)
- what early data science skills you’ve found most valuable or surprising (so far), and why
- a mini tutorial on a focused data science skill / topic, e.g.
- how a particular function(s) or package has helped you overcome a data challenge, and why / how
- a data science workflow or organizational procedure you’ve adopted, and why
- building a data visualization or other creative product
It’s still valuable (and important) to think about how your framing, tone, and focus within each of these suggested topic areas fits your brand identity.