Document an easy example of how to sort navigation links

[zachleat]

cc @minamarkham

I have something like this in use currently on 11ty.io https://github.com/11ty/11ty.io

[zachleat]

Related to #106

[zachleat]

This repository is now using lodash style issue management for documentation requests. This means documentation issues will now be closed instead of leaving them open.

View the documentation queue backlog here. Don’t forget to upvote the top comment with 👍!

[zachleat]

sortMenu filter:
https://github.com/11ty/11ty.io/blob/3c0a51861117bc751b60712c8fdfb6c3c5c75a1d/.eleventy.js#L104

sortMenu filter usage in a template: https://github.com/11ty/11ty.io/blob/969884b9b190eb64774f60bfc1d0cd27338b4f16/_includes/components/docs-toc.njk#L6

The sortMenu filter passes in a menuSortOrder argument which is declared in front matter here: https://github.com/11ty/11ty.io/blob/d053ba90e335965cf3ed7d8f5f45003ca8260c4a/_includes/layouts/docs.njk#L7

[zachleat]

I made an official navigation plugin for this. I think it’s much more straightforward than the method I described above.

Check it out: https://github.com/11ty/eleventy-navigation and it supports an order option.

I put this in the Next Minor Version milestone for release notes but it’s available officially for use right now.