Debugging Lesson Website Builds

Thu, 13 Feb 2025 00:00:00 +0000

The Carpentries Workbench is a collection of tools that help community members build accessible websites from a collection of Markdown or R Markdown files. Lesson Developers and Maintainers can use the Workbench to build a version of the lesson site on their own local system, and a set of workflow descriptions allows the site to be built on GitHub’s cloud servers and served to the internet through GitHub Pages.

This is what a successful lesson build workflow looks like on GitHub. If your lesson builds do not look this, the rest of the blog post is for you!

Ending Support for _styles_ in the Incubator

Tue, 14 Jan 2025 00:00:00 +0000

Our lesson infrastructure, The Carpentries Workbench, was rolled out across all Data Carpentry, Library Carpentry, and Software Carpentry lessons in May 2023. The Workbench replaced our previous lesson infrastructure, a Jekyll-based template (augmented by scripts and other resources developed by the community) affectionately known as styles. The product of several years of work by Zhian Kamvar, the Workbench made a number of improvements over styles, e.g. by bringing lesson sites up to at least WCAG AA standards in web accessibility, and making local installation of the infrastructure significantly easier on most community members’ systems.

The Carpentries Workbench on The Carpentries

Debugging Lesson Website Builds

Ending Support for _styles_ in the Incubator