hacks-guide-minimal-mistake.../docs/_docs/06-overriding-theme-defaults.md
Michael Rose 57a4324fa0 Move gh-pages branch files into /docs and add test files
- Jekyll ignore `/docs` and `/test` folders when using from root
- Update Staticman config to point to correct branch and data file location
- Replace `{{ base_path }}` references with `absolute_url` filter
- Update documentation
2016-11-03 11:52:04 -04:00

1.3 KiB

title permalink excerpt modified
Overriding Theme Defaults /docs/overriding-theme-defaults/ Instructions on how to customize the theme's default set of layouts, includes, and stylesheets when using the Ruby Gem version. 2016-11-03T10:49:48-04:00

When installing the theme as a Ruby Gem its layouts, includes, stylesheets, and other assets are all bundled in the gem. Meaning they're not easily visible in your project.

Each of these files can be modified, but you'll need to copy the default version into your project first. For example, if you wanted to modify the default single layout, you'd start by copying it to _layouts/single.html.

ProTip: To locate theme files, run bundle show minimal-mistakes-jekyll. Then copy the files you want to override from the returned path, to the appropriate folder in your project. {: .notice--info}

Jekyll will use the files in your project first before falling back to the default versions of the theme. It exhibits this behavior with files in the following folders:

/assets
/_layouts
/_includes
/_sass

For more information on customizing the theme's [stylesheets]({{ "/docs/stylesheets/" | absolute_url }}) and [JavaScript]({{ "/docs/javascript/" | absolute_url }}), see the appropriate pages.