# Minimal Mistakes - correct approach

**URL:** https://talk.jekyllrb.com/t/minimal-mistakes-correct-approach/714
**Category:** Help
**Created:** [June 27, 2017, 5:48pm UTC](https://talk.jekyllrb.com/t/minimal-mistakes-correct-approach/714 "2017-06-27T17:48:04Z")
**Posts on this page:** 6
**Page:** 1

<div class="post-metadata">

### Author: ![falnyr](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/falnyr/32/312_2.png) [@falnyr](https://talk.jekyllrb.com/u/falnyr)
#### Post date: [June 27, 2017, 5:48pm UTC](https://talk.jekyllrb.com/t/minimal-mistakes-correct-approach/714/1 "2017-06-27T17:48:04Z")

</div>

Hello,  
I am sorry if this doesn’t belong here, but maybe it does.

I have a problem with Minimal Mistakes theme (or Jekyll in general?). I’d like to have a landing page as root of the website and then a separate section (page?) with Blog posts that could be filtered by taxonomy tags.

Right now I was able to create the landing page with some warnings (I deleted index.html and created [base.md](http://base.md) in \_pages), but I am sure this is not the right approach. Are there any sources I can use to help me out?

I am hosting the website on GitHub pages, repository fork is following: [https://github.com/phpartynz/phpartynz.github.io](https://github.com/phpartynz/phpartynz.github.io)

Thanks in advance

---

<div class="post-metadata">

### Author: ![sparky](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/sparky/32/317_2.png) [@sparky](https://talk.jekyllrb.com/u/sparky)
#### Post date: [June 27, 2017, 6:09pm UTC](https://talk.jekyllrb.com/t/minimal-mistakes-correct-approach/714/2 "2017-06-27T18:09:22Z")

</div>

still learning myself falnyr but personally I would keep index intact - I have edited my “home.html” in the layouts folder for my landing page heres my git if you want a look… [https://github.com/chipsandcurrysauce/huddersfield-explorer](https://github.com/chipsandcurrysauce/huddersfield-explorer) …and then there are some links here in my earlier post which helped me to create sub dir’s and pages.

> [@Struggling to get path to url link to work from an include](http://talk.jekyllrb.com/t/struggling-to-get-path-to-url-link-to-work-from-an-include/682):
>
> Hi all… my first post of many I’m sure slight_smile not really sure yet what all this GitHub / Liquid etc is… never done it before but now stuck into all sorts of youtube vids etc while the mrs is out so forgive me if this sounds really lame “Oh everyone knows thee answer to this one!” type of a question… smiley I’m new to Jekyll as of 3 days… I have a project that I thought to start last week using php incudes rather than a database an while searching the net stumbled upon Jekyll and I…

As for best practice… dunno but guess we’ll all learn together 🙂

best of luck.

Sparky.

---

<div class="post-metadata">

### Author: ![mmistakes](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/mmistakes/32/2169_2.png) [@mmistakes](https://talk.jekyllrb.com/u/mmistakes)
#### Post date: [June 27, 2017, 6:51pm UTC](https://talk.jekyllrb.com/t/minimal-mistakes-correct-approach/714/3 "2017-06-27T18:51:46Z")

</div>

There’s a ton of ways to approach this with Jekyll.

For a homepage I’d suggest keeping `index.html` or `index.md` in the root of your project/repo. If it’s Markdown content then go with a `.md` file. If you’re using Jekyll’s pagination for the homepage then it has to be `index.html`.

For any other page you can place them in folders like `/your-page/index.md` and they’ll build to `/your-page/`. Or if you like to keep things organized dump them all in `_pages`, give them unique names like `/_pages/your-page.md` and add a permalink field to their YAML Front Matter to define their location e.g. `permalink: /your-page/`.

It’s really up to you how you want to structure things. For the Minimal Mistakes theme I went with `_pages` method which you can [poke around here](https://github.com/mmistakes/minimal-mistakes/tree/master/docs/_pages) if you want to see how it’s built.

---

<div class="post-metadata">

### Author: ![sparky](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/sparky/32/317_2.png) [@sparky](https://talk.jekyllrb.com/u/sparky)
#### Post date: [June 27, 2017, 7:01pm UTC](https://talk.jekyllrb.com/t/minimal-mistakes-correct-approach/714/4 "2017-06-27T19:01:04Z")

</div>

so I need to edit my index to point to home layout as you have Sir in the Yaml, I’ll address that, but I’ve done right thing keeping index and editing home. ty 🙂

---

<div class="post-metadata">

### Author: ![mmistakes](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/mmistakes/32/2169_2.png) [@mmistakes](https://talk.jekyllrb.com/u/mmistakes)
#### Post date: [June 27, 2017, 7:19pm UTC](https://talk.jekyllrb.com/t/minimal-mistakes-correct-approach/714/5 "2017-06-27T19:19:54Z")

</div>

You only need to add the `permalink` stuff to the page’s YAML Front Matter if you’re placing it in an unconventional location. Or if you want to do away with a bunch of `index.md` inside of other folders e.g. `/foo-page/index.md` and simplify with just `/foo-page.md`.

`/_pages/` isn’t a standard Jekyll folder so I’m pretty sure anything you put in there needs `permalink: /whatever-url/` for them to resolve correctly. It also begins with an `_` underscore which Jekyll ignores by default.

---

<div class="post-metadata">

### Author: ![sparky](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/sparky/32/317_2.png) [@sparky](https://talk.jekyllrb.com/u/sparky)
#### Post date: [June 27, 2017, 7:30pm UTC](https://talk.jekyllrb.com/t/minimal-mistakes-correct-approach/714/6 "2017-06-27T19:30:31Z")

</div>

yep thats the approach I’ve taken…

however I have left the [index.md](http://index.md) in the relevant folders for just the front page so I know which is the main page… my structure will be

restaurants/a-restaurant.md  
sport/some-sport.md etc

so I’m using the [index.md](http://index.md) so I know which page is the main “links” page. (eventually of course being where the actual blog posts for each restaurant / sport etc will be listed using tags or categories.

Loving Jekyll.
