Skip to content

Customization

Christian Olsen edited this page Nov 14, 2024 · 1 revision

When Hugo builds a site, it'll look for files in the local repository before the theme. This means that any part of the theme can be overwritten by creating a local equvialent of the corresponding theme file.

Overwriting the Theme

The files that are used for building a Hugo site based on the Qubt theme can all be found in the ./layouts/ folder. Overwriting any of these files is done by placing a file on the same path in your own repository. Let's say you want to overwrite the default single.html file, all you need to do is create a file on the following path (replative to the root of your repository): ./layouts/_default/single.html. Now Hugo will use this file when building your site. instead of the equivialent theme file.

If you do end up overwriting a file, please keep in mind that any changes made to the theme file won't be available to you, before you impliment the same changes in your own version of the file.

Adding Custom CSS & JS

The theme supports adding custom CSS and JS. The theme looks for two files, that can be used to include CSS and JS.

CSS

Add any custom CSS to ./assets/css/custom.css.

JS

Add any custom JS to ./assets/css/custom.js.

Clone this wiki locally