An overview/list of all the useful links and tech tools used at the organization of De Sering.

Using homer. Hosted using GitHub Pages at start.desering.org.

Contribution

Edit config.yml and customizations.css.

Most accesible, but silly way

You can edit above files directly in your browser and see the result immediately! Open https://start.desering.org, open DevTools, locate config.yml, edit and enable "Local Overrides". Then, you can refresh the page, but your local copy will be used. Then you can copy these additions here. Note: when editing customizations.css keep DevTools open, so that the CSS is not cached.

Local development

Since this repo is just a config file for a read-made project, development is slightly cumbersome. You have to run homer server and populate it with files from this repo. See GitHub Actions for reference

Local GitHub Action runner

To test locally you can run an the build action with: $ act -j build -P ubuntu-latest=ghcr.io/catthehacker/ubuntu:act-latest

using "act locally" runner.

Deployment

To be as simple as possible we run homer using GitHub Pages, since it's static. The instance is created and configured using GitHub Actions. This happens on every push commit to main (merged PR).

Custom favicon

Homer project seems to not support custom favicon by default.

As sugested in Homer docs subpage let's use RealFaviconGenerator for generating a favicon bundle:

The setings are already in favicon-settings.json and the deployment step generates a favicon bundle based on an icon from the media repository (see GitHub Actions file).

You can check whether the deployed favicon bundle is correct with $ npx realfavicon check https://start.desering.org