Incubator Lesson Spotlight: Building Websites with Jekyll & GitHub Pages

Tue, 11 Jan 2022 00:00:00 +0000

The Incubator Lesson Spotlight highlights a lesson under development by our community in The Carpentries Incubator. In this edition, we look at the progress being made on the {{page.lesson_title}} lesson, and hear from the authors about how The Carpentries community can get involved with the ongoing development of this lesson.

Lesson Profile

Title: {{page.lesson_title}}
Lesson Pages: https://carpentries-incubator.github.io/jekyll-pages-novice/
Lesson Repository: https://github.com/carpentries-incubator/jekyll-pages-novice

Learning Objectives

After this lesson, learners should be able to:

create formatted page content with Markdown
configure their project to build and serve pages on GitHub
build a coherent site with multiple pages using the Jekyll framework
customise the layout and style of the pages on their site

Target Audience

This lesson guides learners through making websites using Jekyll in a web hosting service GitHub Pages. Anyone comfortable interacting with websites in a web browser and willing to learn how to produce website. Basic understanding of HTML and/or Markdown as webpage authoring languages is welcome but not a must.

Alpha testing a Jekyll Pages lesson

Tue, 19 Jan 2021 00:00:00 +0000

In the past several months, we have been developing a lesson, Building Websites with Jekyll and GitHub Pages, in The Carpentries Incubator. In November 2020, we taught this material for the first time in two mini-workshops hosted by UW-Madison.

The first time a lesson is taught is always an important step in its development. It is a chance to really assess how well the lesson objectives and material fit the target audience.

It is also usually the first time exercises have been tested by learners, and can expose weaknesses in the material that are difficult to spot from our perspective as a lesson author. In the life cycle of a lesson, The Carpentries refer to these initial trial runs undertaken by lesson authors as alpha pilots.

Renato Alves on The Carpentries

Incubator Lesson Spotlight: Building Websites with Jekyll & GitHub Pages

Lesson Profile

Learning Objectives

Target Audience

Alpha testing a Jekyll Pages lesson