Resources

The technologies listed below are those that enable the Writing with Visualizations project. The Learn-Static organization also hosts several modules that can help students and instructors better work through these technologies and concepts in a tutorial format. These modules are linked below:


Documentation Template

To learn how to copy and customize your own version of this documentation template, see the Learn-Static Lesson Template README).


Technologies

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.