Skip to content

GitHub Pages and Jekyll

jm1021 edited this page Jan 2, 2022 · 10 revisions

From the Jekyll home page "Transform your plain text into static websites and blogs"

As we build our Website there is an increasing need to share information quickly and easily. Teachers are looking for student leaders to establish policies within their teams to share information and progress. Now there are tools and processes built around GitHub pages and Jekyll to make this "potentially" much easier.

Use this to essentially "deploy" a WebSite centered around the static content we keep in GitHub.

Use Jekyll programming language, looks very similar to Jinja2, to do many quick and unique things using combination of our current learnings on Markup and HTML.

This has all kinds of examples that should look familiar, including HTML layouts.

Challenges

Who? Teachers suggest Web Designer and either GitHub Admin, Deployment Admin. Scrum Master is the customer and should define requirements and needs.

Challenge 1: Turn your README into a GitHub Hosted site, linked from you Web Site (Required).

  1. Start with Settings tab in you project to get Pages going.
  2. Setup DNS to enable subdomain under your primary website domain.
  3. Look at this projects index.md, _config.yml, and _layout directory for starters.
  4. Start looking at Incubator document for detail guideance.

Challenge 2: Using Incubator document or internet as a guide, show me something cool (Impress the Teacher)

  1. Blogging with Code Fragments, purpose is for Tech Talks
  2. Building automatic "GitHub Activity" for all the students in the class
  3. Through Jekyll _layouts automate building standards on page section with menus
  4. Share SCSS between your Web Site and Jekyll Pages (Colors and Fonts)
  5. Find ways to embed Scrum Board, Wiki, or Code Fragments into page (I don't think this is possible)
  6. Find ways to embed GitHub Jekyll page into you web page, while making sure links don't die (I don't think this is possible)
  7. If you can't embed, Pros and Cons of Wiki vs Markdown/Jekyll with real examples
Clone this wiki locally