![]() ![]() ![]() GitHub Pages Alternatives: Looking to host your site for free and install/update the theme painlessly? Netlify, GitLab Pages, and Continuous Integration (CI) services have you covered. To do so fork the Minimal Mistakes theme, then rename the repo to - replacing USERNAME with your GitHub username. You can also install the theme by copying all of the theme files 1 into your project. For more details on how to set things up check GitHub’s documentation. Essentially you rename the repo to something other than and create a gh-pages branch off of master. If you’re hosting several Jekyll based sites under the same GitHub username you will have to use Project Pages instead of User Pages. If it’s not, you can force a rebuild by Customizing Your Site (see below for more details). Note: Your Jekyll site should be viewable immediately at. Generate a new repository from the starter, replace sample content with your own, and configure as needed. Looking for an example? Use the Minimal Mistakes remote theme starter for the quickest method of getting a GitHub Pages hosted site up and running. If you don’t specify a Git ref, the latest on master will be used. You may also optionally specify a branch, tag, or commit to use by appending an and the Git ref (e.g., or This is useful when rolling back to older versions of the theme. Remove any other theme: or remote_theme: entry. This allows for easier installation and updating as you don’t have to manage any of the theme files.Īdd remote_theme: to your _config.yml file. ![]() With Gem-based themes, directories such as the assets, _layouts, _includes, and _sass are stored in the theme’s gem, hidden from your immediate view. Otherwise you’ll throw Unknown tag 'include_cached' errors at build. Note: The theme uses the jekyll-include-cache plugin which will need to be installed in your Gemfile and added to the plugins array of _config.yml. These folders contain documentation and test pages for the theme and you probably don’t want them littering up your repo. ProTip: Be sure to remove /docs and /test if you forked Minimal Mistakes. If you’re running Jekyll v3.7+ and self-hosting you can quickly install the theme as a Ruby gem. If you enjoy this theme, please consider sponsoring me to continue developing and maintaining it. Minimal Mistakes has been developed as a Gem-based theme for easier use, and 100% compatible with GitHub Pages when used as a remote theme. ![]()
0 Comments
Leave a Reply. |