In the previous version, it was comforting to see a nice sample site after download and running
bundle exec jekyll serve
I stayed with mm largely because of this because it was like being blindfolded and dropped off in a foreign country. I don't know how much time it would take me to get it working.
Now, mm joins amplify, jekyll-bootstrap, and others with this frustrating screen:
It makes me want to run away screaming.
Even though people will be changing files after cloning etc.
can you at least get us to first base here?
This was by design. I purposely removed all of the demo posts, pages, and collections because that is content and not part of the _theme_. You'd be surprised how many people had no clue they could (or should) remove them. For example you know how many forks kept the "Theme Setup" page? Answer. A TON!
And as you even said:
Even though people will be changing files after cloning etc.
All the more reason to remove the demo content. Why give people an extra step if they're going to remove it anyways?
Regardless I did leave the index.html page in tact and it does get you to a base site.
It looks to me as if you're using my gh-pages
branch which you really shouldn't be doing.
If you use master
you'll get the normal "Recent Posts" homepage albeit with no posts. My gh-pages
branch has baseurl: /minimal-mistakes
set which means you have to access it at http://localhost:4000/minimal-mistakes/ when running bundle exec jekyll serve
because of said baseurl
. I'm assuming amplify and Jekyll-bootstrap are the same way and have a base url set to properly serve their projects with GitHub Pages. An easy problem to solve... remove that line from _config.yml
or append the base to localhost:4000
Here is my approach
This results in this error message:
Liquid Exception: The included file '/Users/mac/gits/jekyll/minimal-mistakes/_includes/feature-row' should exist and should not be a symlink in minimal-mistakes-demo/_pages/splash-page.md
jekyll 3.0.3 | Error: The included file '/Users/mac/gits/jekyll/minimal-mistakes/_includes/feature-row' should exist and should not be a symlink
I found the Gem-based "quick start" instructions did not result in a fully working install. I found this issue logged when searching for information. I am just posting this as feedback and in case it helps others who may end up here with the same problems. Here are the steps which worked for me for a complete working install, albeit containing only one post:
$ gem install jekyll bundler
$ jekyll new jekyll-mm
$ cd jekyll-mm
$ sed -i -e 's/"minima".*/"minimal-mistakes-jekyll"/' Gemfile
$ bundle install
$ rm _config.yml index.md about.md
$ wget https://raw.githubusercontent.com/mmistakes/minimal-mistakes/master/_config.yml
$ echo 'theme: minimal-mistakes-jekyll' >> _config.yml
$ wget https://raw.githubusercontent.com/mmistakes/minimal-mistakes/master/index.html
$ sed -i -e 's/^layout: post/layout: single/' _posts/*welcome-to-jekyll.markdown
$ jekyll serve
theme: minimal-mistakes-jekyll
to the supplied _config.yml
. Without this it does not work.
Most helpful comment
I found the Gem-based "quick start" instructions did not result in a fully working install. I found this issue logged when searching for information. I am just posting this as feedback and in case it helps others who may end up here with the same problems. Here are the steps which worked for me for a complete working install, albeit containing only one post:
theme: minimal-mistakes-jekyll
to the supplied_config.yml
. Without this it does not work.