2.4 KiB
title | permalink | redirect_from | excerpt | sidebar | |||||
---|---|---|---|---|---|---|---|---|---|
Quick-Start Guide | /docs/quick-start-guide/ |
|
|
{% include base_path %}
Minimal Mistakes has been developed to be 100% compatible with hosting a site on GitHub Pages. To get up and running with a new GitHub repository quickly, follow these steps.
Fork the Theme
Fork the [Minimal Mistakes theme]({{ site.gh_repo }}/fork), then rename the repo to USERNAME.github.io --- replacing USERNAME with your GitHub username.
![fork Minimal Mistakes](/N-archive/hacks-guide-minimal-mistakes-theme/media/commit/12a048925619315efc7f216fa9b556678d77902f/_docs/%7B%7B%20base_path%20%7D%7D/images/mm-theme-fork-repo.png)
Note: Your Jekyll site should be viewable immediately at http://USERNAME.github.io. If it's not, you can force a rebuild by Customizing Your Site (see below for more details). {: .notice--warning}
If you're hosting several Jekyll based sites under the same GitHub username you will have to use Project Pages instead of User Pages. Essentially you rename the repo to something other than USERNAME.github.io and create a gh-pages
branch off of master
. For more details on how to set things up check GitHub's documentation.
![creating a new branch on GitHub](/N-archive/hacks-guide-minimal-mistakes-theme/media/commit/12a048925619315efc7f216fa9b556678d77902f/_docs/%7B%7B%20base_path%20%7D%7D/images/mm-gh-pages.gif)
ProTip: Be sure to delete the gh-pages
branch if you forked Minimal Mistakes. This branch contains the documentation and demo site for the theme and you probably don't want that showing up in your repo.
{: .notice--info}
Customize Your Site
Open up _config.yml
found in the root of the repo and edit anything under Site Settings. For a full explanation of every setting be sure to read the Customization section, but for now let's just change the site's title.
![editing _config.yml file](/N-archive/hacks-guide-minimal-mistakes-theme/media/commit/12a048925619315efc7f216fa9b556678d77902f/_docs/%7B%7B%20base_path%20%7D%7D/images/mm-github-edit-config.gif)
Committing a change to _config.yml
(or any file in your repository) will force GitHub Pages to rebuild your site with Jekyll. It should then be viewable a few seconds later at <USERNAME.github.io>.
Congratulations! You've successfully forked the Minimal Mistakes Jekyll theme and are up an running with GitHub Pages. Now you're ready to add some content and customize the site further.