An open API service indexing awesome lists of open source software.

https://github.com/redbox-mint/redbox-mint.github.io

The production ReDBox information website.
https://github.com/redbox-mint/redbox-mint.github.io

brochure redbox website

Last synced: 4 months ago
JSON representation

The production ReDBox information website.

Awesome Lists containing this project

README

          

# ReDBox Information Website

The source code for the
[ReDBox public information website](https://redbox-mint.github.io/).

This is the production website.

Test changes first on the [staging website](https://github.com/redbox-mint/website-redboxresearchdata).

## Overview

- Uses [Jekyll](https://jekyllrb.com/) and [GitHub Pages](https://docs.github.com/en/pages).
- Dependabot configured to update the Gemfile, npm packages, GitHub Actions.
- Content pages are in Markdown.
- Most recent ReDBox release info can be generated by a script, then included where ever is needed.

## Contributing

There are two options for contributing.

### Option A

For simple changes - edit in the GitHub website or a local git clone and immediately deploy.

1. Modify content that is part of the Jekyll site content.
2. Commit and push the change to the default branch.
3. The GitHub Actions will deploy the changes to the GitHub Pages site.

### Option B

For more extensive or complicated changes - set up GitHub Pages to test changes locally.

1. Set up [rvm](https://github.com/rvm/ubuntu_rvm) on your machine or in a VM or docker container.
2. Set up the [GitHub Pages gem](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll).
Use the scripts in `.support` to install the dependencies and build the static site.
3. Make content or structural changes.
4. Run the site locally to see that the changes are ok. Use the script `.support/local_jekyll_server.sh`.
5. Commit and push the change to the default branch.