N-archive/hacks-guide-minimal-mistakes-theme
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity
📐 Jekyll theme for building a personal site, blog, project documentation, or portfolio.
236 commits 2 branches 0 tags 45 MiB
HTML 48.4%
SCSS 47.7%
JavaScript 2.3%
Ruby 1.6%
Go to file
Michael Rose 23cb7ecaeb Convert .less to .scss
2014-07-31 14:57:13 -04:00
.sass-cache Convert .less to .scss 2014-07-31 14:57:13 -04:00
_data Simplify and organize _config.yml variables 2014-07-31 14:57:03 -04:00
_includes Convert .less to .scss 2014-07-31 14:57:13 -04:00
_layouts Simplify and organize _config.yml variables 2014-07-31 14:57:03 -04:00
_posts Simplify and organize _config.yml variables 2014-07-31 14:57:03 -04:00
_sass Convert .less to .scss 2014-07-31 14:57:13 -04:00
assets Convert .less to .scss 2014-07-31 14:57:13 -04:00
images Update theme screenshot 2014-02-13 16:34:06 -05:00
.gitignore Ignore Gemfile.lock 2014-07-31 14:56:47 -04:00
.jshintrc Init Gruntjs build script 2013-09-09 10:12:07 -04:00
404.md Replace sitemap.xml with Jekyll Sitemap gem 2014-07-31 14:57:08 -04:00
_config.yml Convert .less to .scss 2014-07-31 14:57:13 -04:00
about.md add disqus comments as per hpstr theme 2014-03-25 17:25:21 +01:00
favicon.ico Minor cleanup 2013-05-24 12:04:43 -04:00
favicon.png Add favicons and iOS icons 2013-05-28 10:43:55 -04:00
feed.xml Replace sitemap.xml with Jekyll Sitemap gem 2014-07-31 14:57:08 -04:00
Gemfile Update to Jekyll 2.2.0 2014-07-31 14:56:54 -04:00
Gemfile.lock Update to Jekyll 2.2.0 2014-07-31 14:56:54 -04:00
Gruntfile.js Convert .less to .scss 2014-07-31 14:57:13 -04:00
index.md Simplify and organize _config.yml variables 2014-07-31 14:57:03 -04:00
LICENSE Update theme setup documentation 2013-09-09 12:20:51 -04:00
package.json Init Gruntjs build script 2013-09-09 10:12:07 -04:00
posts.md Rename Articles to Posts to stay consistent with Jekyll naming conventions 2014-01-15 15:32:48 -05:00
Rakefile.rb Add category to rake new_post 2014-02-27 15:00:37 -05:00
README.md Fixes #57 2014-05-18 12:00:57 -04:00
theme-setup.md Add category to rake new_post 2014-02-27 15:00:37 -05:00

README.md

Minimal Mistakes

Minimal Mistakes is a two column responsive Jekyll theme perfect for powering your GitHub hosted blog.

Minimal Mistakes is all about:

  • Responsive templates. Looking good on mobile, tablet, and desktop.
  • Gracefully degrading in older browsers. Compatible with Internet Explorer 8+ and all modern browsers.
  • Minimal embellishments -- content first.
  • Optional large feature images for posts and pages.
  • Simple and clear permalink structure.
  • Custom 404 page to get you started.
  • Stylesheets for Pygments and Coderay syntax highlighting to make your code examples look snazzy.

screenshot of Minimal Mistakes theme

Basic Setup for a new Jekyll site

  1. Install Bundler gem install bundler and then install Jekyll and all dependencies bundle install.
  2. Fork the Minimal Mistakes repo.
  3. Clone the repo you just forked and rename it.
  4. Edit _config.yml to personalize your site.
  5. Check out the sample posts in _posts to see examples for pulling in large feature images, assigning categories and tags, and other YAML data.

Demo the Theme

Pro-tip: Delete the gh-pages branch after cloning and start fresh by branching off master. There is a bunch of garbage in gh-pages used for the theme's demo site that I'm guessing you don't need.

More Theme Setup Goodness

To learn more about how customize this theme, include feature images in posts, use the Grunt build scripts, and some other junk, read up here.

Questions?

Having a problem getting something to work or want to know why I setup something in a certain way? Ping me on Twitter @mmistakes or file a GitHub Issue. And if you make something cool with this theme feel free to let me know.

License

This theme is free and open source software, distributed under the GNU General Public License version 2 or later. So feel free to use this Jekyll theme on your site without linking back to me or including a disclaimer.