This is a repo for the Quarto website for the CamBridge User Group
It contains a home page, events, page and blog posts.
Corrections, suggestions and general improvements are welcome as issues.
You can also suggest changes by forking this repository, and opening a pull request. Please target your pull requests to the main
branch.
You can push directly to main for small fixes. Please use PRs to main for discussing larger updates.
This a "classic" Quarto website, but also contains blog posts.
This means there is a slightly different directory structure than what you might be used to.
project
│ _quarto.yml
| index.qmd
│ events.qmd
│ blogs.qmd # This is a listing file for a blogs in /posts
| styles.css
| ...
│
└───posts/
│ │ _metadata.yml
│ │
│ └───YYYY-MM-DD-post-description
│ │ index.qmd
│
└───docs/ # Contains all html files rendered on Github Pages
│ index.html
│ events.html
| ...
New blog posts should be created in the posts/
directory.
You can copy the YYYY-MM-DD-post-description
folder, this is a template folder.
Please use the same naming format to keep the ordering of posts consistent.
This folder contains an index.qmd
file - do not rename this file. It has the following yaml header:
---
title: "blog post title"
description: "blog post description (appears underneath the title in smaller text) which is included on the listing page"
author:
- name: Thomas Zwagerman
affiliation: British Antarctic Survey
date: 06-14-2024
categories: [Quarto, R, Cambridge] # self-defined categories
draft: true
---
Update these details for you blog post. The draft: true
header prevents publication. When you have finished your blost post, change it to draft: false
, re-render and push your change (or open a Pull Request, without edit permissions), to publish the post.
For a detailed breakdown refer to Quarto's Creating a Blog documentation.