Overview

nyjc-computing.github.io is a static site containing information about the Computing programme at NYJC.

The site is hosted on Github Pages and owned by the nyjc-computing Github organization.

Content is written in Markdown, and built using Jekyll.

What is a static site?

A static site contains static content; there is no database or other service running on the backend, besides a simple web server that serves the page content.

What is Markdown?

Markdown is a simplified markup language that makes the page structure visible even to human readers. It is an easier alternative to HTML for creating web content.

What is Jekyll?

Jekyll is a static site generator. It takes text written in your favorite markup language and uses layouts to create a static website. You can tweak the site’s look and feel, URLs, the data displayed on the page, and more. -- Jekyll Quickstart

A bunch of markdown files does not look very nice on the web. To apply the full power of HTML element structure and CSS styling, we use a program to convert our markdown files into a hierarchy of HTML files, with content inserted and styles applied through the use of templates.

Such programs are called static site generators, and Jekyll is one such generator. Other static site generators exist, but Github Pages has built-in support for Jekyll which makes the build process slightly easier.