GRAV EasyMenu project

# Examples
user_menu_example:
  displays:
    level1: horizontal
    level2: dropdown_left
    level3: dropdown_left
  root:                       # We create a first level.
    item1:                        # 1rst item
      URI: /home                    # The page where the link will point to. It can also be an external URL.
      name: Portal                  # The name that the <a> link will display.
      explore: false                # Indicates that we don't want to auto-construct a sub-menu with children, even if there might be a few sub-pages.
    item2:                        # 2nd item
      URI: 'http://www.mywork.fr'   # An external link. No exploration of children possible.
      name: My workplace
    item3:
      URI: /stuffs
      name: auto                    # We decide to use the title of the markdown page directly, to name the link.
      explore: true                 # All children and sub-children will be deployed in a sub-menu. As we don't specify a level of deepness, all will be displayed.
    item4:
      URI: /house
      name: auto
      explore: false                # Let's say we want to build it manually !
      sub:                          # It indicates that we'll define a manual sub-menu, with specific children.
        display: dropdown_right       # Individual rule for that sub-menu level, independently from the general one (in 'displays:').
        item1:                        # Reminder : we're manually adding items, because of the "explore: false" above.
          URI: /house/sub-page1       # URI of the page
          name: 'A wonderful part of my house'
          explore: false
        item2:
          URI: /garden/sub-item2      # A page from an other parent.
          name: 'That\'s my cat'
          explore: true               # I have tens of pages with pictures of my cat !
    item5:
      auto: true                    # Means that the item will be a series of items, wich will be auto-constructed to fill-in the present level.
      URI: /item2                   # Path from wich pages will serve to build the items on the present level. Just a level of deepness is used.
      name: auto                    # Of course we name them automatically. This option is set by default anyway, if "auto: true" is used.
      explore: 2                    # We decide to display just one level of children of each item built.
      level2: dropdown_right        # An other method for deciding of the display. Here, it will be applied to all children of level 2, but levels 3 will still use the general default setting.
    item6:
      URI: /contact                 # We end by a normal single link. It is naturally added after the automated item5's links.
      name : auto
      explore: false