Reference & Resources
To learn about using workshop-template-b
, the content pages of this demo provide documentation and examples (also check the README).
Workshop sites using this template:
- Demo (this repository)
- Go Go GitHub Pages (v.2) (workshop)
- Get Started with OpenRefine (workshop)
- Web Crash Course (workshop)
- write-md: Markdown and Pandoc for Academic Writing (workshop)
- web-cites: Web Archiving to Fight Link Rot and Preserve Your Citations (workshop)
- Hey API! (workshop)
- Web Crash Course (workshop)
- Try Linux! (workshop)
- Make OER! (presentation)
- Teaching Tech Hands-on (presentation)
Other workshop sites an minimal version of this template (no bootstrap):
If you need a Bootstrap 4 version, see older v1.0 release.
Reference
Git & GitHub
GitHub is a popular web service for hosting Git repositories–with benefits! It provides a handy web interface for editing and collaborating on repos, as well as, built in project management features and free static web hosting powered by Jekyll. Accounts are free. To learn more check out Hello World on GitHub Guides or GitHub Learning Lab.
Markdown
Markdown is a standard to simplify writing content for the web. Markdown can be used any where on GitHub and in Jekyll.
Bootstrap 5
Bootstrap is a CSS framework designed to streamline developing user interfaces for your website.
Bootstrap Icons are SVG-based icon set used to add graphics to your content.
YAML
YAML is a human readable plain text data format. It is used in Jekyll for configuration, site data, and front matter. Jekyll projects are configured using the “_config.yml” file.
Liquid
Liquid is a flexible template language.
[In Jekyll]((https://jekyllrb.com/docs/liquid/) it allows you to layout pages built from modular components and data, using the “_includes”, “_layouts”, and “_data” directories.
Liquid includes features such as operators, loops, and filters to manipulate raw content.
Liquid statements are enclosed by {% %}
and variables in {{ }}
.
Sass
Sass is a CSS extension / preprocessor. All normal CSS is valid SCSS, but Sass adds many powerful functions and programmatic features. Writing SCSS is often easier and more sensible, for example by supporting nesting, variables, and operators. Jekyll lets you write SASS in modular chucks called partials, in the “_sass” directory, that will be combined and compiled into normal CSS files when the site is built.