2.7 KiB
title | permalink | excerpt | sidebar | ||
---|---|---|---|---|---|
Installation | /docs/installation/ |
|
{% include base_path %} {% include toc %}
Install the Theme
There are several ways to install the theme.
The easiest being: fork the Minimal Mistakes repo on GitHub. If you plan on hosting your site with GitHub Pages then following the steps outlined in the Quick-Start Guide.
For an existing site you have some more work ahead of you. What I suggest is to fork and rename the theme as before, then clone it by running git clone https://github.com/USERNAME/REPONAME.git
--- replacing USERNAME and REPONAME with yours.
![copy GitHub repo URL](/N-archive/hacks-guide-minimal-mistakes-theme/media/commit/0d61b26dd472f533f18e0395367c87fc2fa88e22/_docs/%7B%7B%20base_path%20%7D%7D/images/mm-github-copy-repo-url.png)
Then depending on how much existing content you're moving over begin the process of copying and converting everything. In most cases you simply need to update the settings in _config.yml
to your liking and set the correct layout
in the YAML Front Matter.
Converting Existing Content: Be sure to read through the "Working with Posts/Pages/Collections" documentation to learn about all the options available to you. Minimal Mistakes has been designed to be flexible, with numerous settings for toggling features on/off. {: .notice--info}
If for some chance you don't want to mess with Git you can also download the theme as a ZIP file and work with it locally that way.
Download Minimal Mistakes Theme{: .btn .btn--success}
Install Dependencies
If this is your first time using Jekyll be sure to read through the official documentation to familiarize yourself. This guide assumes you've done that and have Ruby v2 installed.
To keep your sanity and better manage dependencies I strongly urge you to install Bundler with gem install bundler
and use the included Gemfile
. Minimal Mistake's Gemfile defaults to the github-pages
gem to maintain a local Jekyll environment in sync with GitHub Pages.
If you're not planning on hosting with GitHub Pages and want to leverage features found in the latest version of Jekyll replace gem "github-pages"
with gem "jekyll"
in Gemfile
and then run:
$ bundle install
![bundle install in Terminal window](/N-archive/hacks-guide-minimal-mistakes-theme/media/commit/0d61b26dd472f533f18e0395367c87fc2fa88e22/_docs/%7B%7B%20base_path%20%7D%7D/images/mm-bundle-install.gif)
Depending on what gems you already have installed you may have to run bundle update
to clear up any dependency issues. Bundler is usually pretty good at letting you know what the issue is to work through them.