Add the homepage back to the navigation

[d0ugal]

No description provided.

[d0ugal]

@tomchristie Interested in your input on this. My reasoning before was that if we add it, it is hard to remove it. However, I think now that is wrong.

1. Without it in the nav, doing the TOC for the homepage is really hard. The Read The Docs theme feels weird on the homepage for example.
2. If can be easily ignore with a simple {% if not page.is_homepage %}

[d0ugal]

This will close #236.

[lovelydinosaur]

Not yet reviews if this should just already be in nav_items, or only in iter as per this fix.

[d0ugal]

hmm, yeah, I think it should be added to nav_items. Will update.

[d0ugal]

Ok, this seems pretty solid now. One thing to note, it is technically backwards incompatible as it will change what the theme outputs. In some cases, like in Django REST Framework, it will mean the Home nav item is displayed twice until the one manually added is removed.

@tomchristie Thoughts on this? Seem okay to do that in a 0.12 release?

[d0ugal]

@tomchristie Spotted the above question?

[lovelydinosaur]

@d0ugal Yeah that's okay, tho probably worth pre-emptively tracking in a REST framework issue.
Also I never caught up on the source code highlighting so maybe open a ticket for that with whatever you suggested as the resolution for that. Would we also be in a position to switch the search for 0.12 away from the current google search.

(Apologies for the off-topic bits here)

[d0ugal]

See encode/django-rest-framework#2246 for the highlighting issue.