Incubator Lesson Spotlight: Building Websites with Jekyll & GitHub Pages

Get involved in the community’s development of a new lesson to teach Jekyll and GitHub.

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 “Building Websites with Jekyll & GitHub Pages” lesson, and hear from the authors about how The Carpentries community can get involved with the ongoing development of this lesson.

Lesson Profile

  • Title: “Building Websites with Jekyll & GitHub Pages”
  • Lesson Pages:
  • Lesson Repository:

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.

Lesson Progress

The lesson is in the Beta stage, as it has been completed and taught several times by the maintainers.

How You Can Help Develop This Lesson

We are currently looking for volunteers to test this lesson! The lesson has been taught by the maintainers a few times but we would like it to be more widely used. We can help instructors prepare to teach the lesson and would love to receive feedback on how it could be further improved, based on their experience in the workshop.

If you are interested in contributing to the lesson, you can join The Carpentries Slack and join the #jekyll-pages-lesson channel.

About This Series

Incubator Lesson Spotlight is a regular feature in The Carpentries blog and Carpentries Clippings newsletter, highlighting the great work our community is doing to develop new lessons in The Carpentries Incubator. Developers of any lesson in the Incubator are encouraged to submit details about their material for inclusion in the series. If you would like to increase the visibility of your lesson and encourage Carpentries community members to contribute to its ongoing development, fill in this short form.

Dialogue & Discussion

Comments must follow our Code of Conduct.

Edit this page on Github