This repository contains the source code for the Scalastic website, a project built with Jekyll version 4.3.2. The website is deployed using GitHub Actions and hosted on GitHub Pages.
To work with this project, ensure you have the following installed:
- Ruby 3.2.2
- Bundler 2.4.10
Follow these steps to set up the project on your local machine:
- Install Ruby and Bundler.
- Clone this repository.
- Install project dependencies by running:
bundle install
Use the following commands to build and serve the website:
- Production build:
bundle exec jekyll build
- Development build:
bundle exec jekyll server --incremental
- Development build with drafts:
bundle exec jekyll server --incremental --drafts
- Development build with drafts and future posts:
bundle exec jekyll server --incremental --drafts --future
- Development build with drafts, future posts, and verbose output:
bundle exec jekyll server --incremental --drafts --future --verbose
For more information about Jekyll, visit the Jekyll Official Website.
The project uses various Jekyll plugins, including:
- nokogiri: A Ruby gem for parsing HTML and XML.
- jekyll-paginate: A pagination plugin.
- jemoji: A plugin for converting emoji shortcodes into emoji images.
- premonition: A plugin for creating Bootstrap-style alerts in Markdown.
- jekyll-last-modified-at: A plugin for adding last modified date information to posts and pages.
- jekyll-polyglot: A plugin for managing multiple languages in a Jekyll site.
- jekyll_picture_tag: A plugin for creating responsive images.
- And more included in Jekyll's extensive plugin ecosystem.
The website integrates the following layouts:
- Bootstrap 4: A popular CSS framework for responsive and mobile-first design.
- Font Awesome 5: A widely-used icon set and toolkit.
- Google Fonts: A library of 1,000 free, open-source fonts.
- Compress HTML: A plugin for HTML compression.
- Code snippet highlighting: A Jekyll integrated syntax highlighter, styled like Carbon Now images.
- GitHub Card: A Jekyll tag, displaying GitHub repo details as GitHub does.
The project is based on the Flexible Jekyll theme, a clean and customizable Jekyll theme tailored to specific preferences.
The website is built and deployed using GitHub Actions for Jekyll, a GitHub Action specifically designed for building and deploying Jekyll sites to GitHub Pages. For more details on GitHub Actions, refer to the GitHub Actions Official Website.
The Scalastic website is hosted on GitHub Pages, the official platform for publishing and sharing web content through GitHub.
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License, except for components and images integrated into the content of the website, which may have their own licenses indicated where applicable.