Menus
Known limitations
Menus are only supported with Hugo and Jekyll and don’t support linking to Hugo page bundles.The Menus section won’t be displayed if you’re using another generator.
Tip: use data files to manage any type of data stored in JSON, YAML, or TOML.
Menus allow content editors to easily manage existing menus in your site, such as site navigation and sidebars using a simple drag-and-drop interface.
Adding New Menus
Forestry will automatically display menus found in your site, and allow content editors to manage menu items from existing content in your site, or to external links on the internet.
Using with Hugo
The Menu Manager integrates directly with Hugo’s menu system. See Hugo’s documentation on setting up your first menu.
Menu entries linking to existing content on your site will be added to the front matter of that content.
Menu entries with external links will be added to your Hugo site config file.
Using with Jekyll
The Menu Manager integrates directly with the Jekyll Menus plugin.
Menu entries linking to existing content on your site will be added to the front matter of that content.
Menu entries with external links will be added to your menus data file located at /data/menus.yml
.
NB. The Jekyll Menus plugin is not currently compatible with GitHub Pages as it is not a listed dependency.
Managing Menus
The Menu Manager allows you to add, reorganize, and remove menu items from existing menus.
Adding Menu Items
- Navigate to the Menus section of your site, found in the sidebar
- Click the menu you wish to update
- Click Add Link
- Provide a name for the menu item, and choose Internal to select an existing piece of content, or External to create a menu item to a publically accessible URL.
Modifying Menu Items
- Navigate to the Menus section of your site, found in the sidebar
- Click the menu you wish to update
- Click settings icon to the right of the menu item you wish to edit
Deleting Menu Items
- Navigate to the Menus section of your site, found in the sidebar
- Click the menu you wish to update
- Click trash icon to the right of the menu item you wish to delete
Reorganizing Menus
Menus can easily be reorganized using a drag-and-drop functionality. To reorganize a menu, drag a menu item from the drag indicator to the left of the menu item, and drop it in its new position.
If your site supports them, sub-menus can easily be created by dragging a menu item underneath another menu item! Give it a try!
Caught a mistake or want to contribute to the docs? Edit this page on Github!