Contribute: Editing tips

Editing the config file

A lot of the aspects of the website are changed by editing the _config.yml file. The ELIXIR Toolkit Theme website has more detailed documentation and details the options available.

Editing styling

The files that determine the overall styling of the pages are found in the _sass folder. Here you can define custom styles, colours, sizes etc.

Copying other styles

Looking at other websites using this theme is a great way to learn how to implement certain features and styles, see the list on the ELIXIR toolkit theme website for a list of websites using the theme.

If build fails…

If the build step of the deployment fails, go to the logs to see if there is an error that explains the issue. Commonly things might have failed due to invalid yaml/css syntax.

1. To view the logs, go to the Actions tab on the repo, and click the workflow run that failed.
2. Click on the step that failed and read through the logs to find the source of the error
3. Try to fix the source of the error

If the build fails, the previous version of the website will remain until an updated, successful build is run.

Getting Help

Any issues with the theme itself can be raised with the ELIXIR Toolkit theme team by raising an issue on their GitHub repo. You can also search through previous issues to see if anyone else has had similar issues and found a solution.

Contributors