This is the repo containing the kroxylicious.io website. The site runs on Jekyll, so you'll need to ensure you have the prerequisites installed to try it locally. You'll also need to ensure you have Ruby 3.2+ installed, along with the latest versions of Rake and Bundler for your Ruby distribution.
- Gemfile - required ruby gems for building and serving the site
- _config.yml - Jekyll configuration for building the site
- _sass/kroxylicious.scss - configuring CSS with kroxy colours
- .github/workflows/jekyll-gh-pages.yml - workflow for building and deploying to GitHub Pages
Built with Jekyll, Bootstrap 5, and Ruby 3.2
There is a GitHub action that builds and deploys the HTML/CSS
to the gh-pages branch on push to main.
We don't use the Bootstrap 5 ruby gem here, as it runs on a
dart-sass implementation that's incompatible with the one Jekyll uses.
To run the site locally, you'll first need to download the Bootstrap 5 Sass sources by running bootstrap_setup.sh.
Then install the site's prerequisites by running this:
bundle installYou can then run the site with this command (don't close the terminal once you've run this, or the process serving the site will terminate):
bundle exec jekyll serveWe have an ever-growing collection of binary assets, mostly images but also a few PDF slide decks etc all of these
should go under /assets/. To try and preserve a bit of sanity to the repo we subdivide /assets into sections for each class of conent.
/assets/pages/- for binary assets related to the pages of the site./assets/theme/- for binary assets included as part of the site theme/assets/blog/- for binary assets related to blog posts. Currently, blog has further sub dirs ofslides&images.
Some content such as the use-cases include diagrams drawn in Excalidraw. Browsers can't handle the format natively, so instead, in addition to
commiting the .excalidraw orginals to the repo, we also export a transparent .png for inclusion in the content.