{"id":22833039,"url":"https://github.com/kroxylicious/kroxylicious.github.io","last_synced_at":"2025-07-18T21:33:40.564Z","repository":{"id":104911986,"uuid":"604374253","full_name":"kroxylicious/kroxylicious.github.io","owner":"kroxylicious","description":"kroxylicious.io org page","archived":false,"fork":false,"pushed_at":"2025-07-09T15:35:33.000Z","size":12321,"stargazers_count":0,"open_issues_count":16,"forks_count":10,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-07-10T00:54:02.223Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kroxylicious.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-02-20T23:29:37.000Z","updated_at":"2025-07-09T15:35:39.000Z","dependencies_parsed_at":"2024-04-09T22:32:46.979Z","dependency_job_id":"b15bad02-7a3d-45db-8abb-a9379d2d97de","html_url":"https://github.com/kroxylicious/kroxylicious.github.io","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kroxylicious/kroxylicious.github.io","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kroxylicious%2Fkroxylicious.github.io","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kroxylicious%2Fkroxylicious.github.io/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kroxylicious%2Fkroxylicious.github.io/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kroxylicious%2Fkroxylicious.github.io/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kroxylicious","download_url":"https://codeload.github.com/kroxylicious/kroxylicious.github.io/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kroxylicious%2Fkroxylicious.github.io/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265837624,"owners_count":23836558,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-12T21:11:43.160Z","updated_at":"2025-07-18T21:33:40.553Z","avatar_url":"https://github.com/kroxylicious.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kroxylicous.io Site\n\n## What?\n\nThis is the repo containing the kroxylicious.io website.\nThe site runs on Jekyll, so you'll need to ensure you have the [prerequisites](https://jekyllrb.com/docs/) installed to try it locally.\nYou'll also need to ensure you have Ruby 3.2+ installed, along with the latest versions of Rake and Bundler for your Ruby distribution.\n\n## Key Files\n- [Gemfile](Gemfile) - required ruby gems for building and serving the site\n- [_config.yml](_config.yml) - Jekyll configuration for building the site\n- [_sass/kroxylicious.scss](_sass/kroxylicious.scss) - configuring CSS with kroxy colours\n- [.github/workflows/jekyll-gh-pages.yml](.github/workflows/jekyll-gh-pages.yml) - workflow for building and deploying to GitHub Pages\n\n## Development\n\nBuilt with Jekyll, Bootstrap 5, and Ruby 3.4\n\nThere is a GitHub action that builds and deploys the HTML/CSS on push to `main`.\n\nWe don't use the Bootstrap 5 ruby gem here, as it runs on a\n`dart-sass` implementation that's incompatible with the one Jekyll uses.\n\n### Running in a Container\n\nTo build and serve the website from a container you can run `./run.sh`. It will be deployed on http://localhost:4000\n\nThis assumes the use of `podman`, if you are a `docker` user you can run `CONTAINER_ENGINE=docker ./run.sh`.\n\n### Running on GitHub Pages on a Fork\n\nTo exercise the GitHub workflows and share changes it can be convenient to deploy a fork to GitHub Pages.\n\nTo enable pages on your fork:\n1. go to `https://github.com/${yourname}/kroxylicious.github.io/settings` in a browser, replacing `${yourname}` with your GitHub username.\n2. Navigate to \"Pages\" under \"Code and automation\"\n3. Under \"Build and deployment\", under \"Source\", select \"Github Actions\".\n4. Navigate to \"Actions\" under \"Secrets and variables\" under \"Security\"\n5. Select the \"Variables\" tab\n6. Click \"New repository variable\"\n7. Create a new repository variable named `JEKYLL_CONFIG_OVERRIDES` with value:\n   ```yaml\n   baseurl: \"kroxylicious.github.io\"\n   url: \"https://${yourname}.github.io\"\n   ```\n   replacing `${yourname}` with your GitHub username.\n8. Push changes to any branch of your fork and then trigger a manual run of `https://github.com/${yourname}/kroxylicious.github.io/actions/workflows/jekyll-gh-pages.yml`,\n   supplying the branch you want to checkout and deploy as a parameter. \n\n# Binary content\n\nWe have an ever-growing collection of binary assets, mostly images but also a few PDF slide decks etc all of these\nshould go under `/assets/`. To try and preserve a bit of sanity to the repo we subdivide `/assets` into sections for each class of conent.\n- `/assets/pages/` - for binary assets related to the pages of the site.\n- `/assets/theme/` - for binary assets included as part of the site theme\n- `/assets/blog/` - for binary assets related to blog posts. Currently, blog has further sub dirs of `slides` \u0026 `images`.\n\n# Excalidraw images\n\nSome content such as the use-cases include diagrams drawn in Excalidraw.  Browsers can't handle the format natively, so instead, in addition to\ncommiting the `.excalidraw` orginals to the repo, we also export a transparent `.png` for inclusion in the content.\n\n# Redirects\nThere is nothing more frustrating than reading some documentation or a stack trace with a link to some helpful sounding answer only for that link to be a 404. To try and minimise that pain we have built a Jekyll plugin to generate a redirect from a token to a URL. This plug-in generates a collection of static pages derived from the yaml documents in `_data/redirects`.\nEach yaml document defines a namespace for redirections. For example `errors.yaml` will build pages under `/redirects/errors/`. The yaml document takes the format outlined here:\n\n```yaml\nbaseUrl: https://kroxylicious.io/documentation/ #The base URL to build redirects from\ndelay: 3 #How long should the re-direction message be shown before loading the target. Defaults to 1.\nmappings:\n- name: test #the token to be the landing url\n  fromVersion: 0.10.0 #Optional, if not specified the latest release at time of site build is used. \n  toVersion: 0.12.0 #Optional, if not specified the latest release at time of site build  is used.\n  path: /html/kroxylicious-proxy/#con-configuring-client-connections-proxy # the path within the baseUrl\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkroxylicious%2Fkroxylicious.github.io","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkroxylicious%2Fkroxylicious.github.io","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkroxylicious%2Fkroxylicious.github.io/lists"}