Site Navigation

The general navigation includes a main menu and a social menu.

There is no need for a central menu configuration for local pages!

The entries in the main (or primary) menu lead to its sections and optionally to related sites.

Similar to the way shown in the workflow introduction for documentation pages, we add a section menu entry in the frontmatter of its branch bundle:

menu:
  main:
    name: Blog
    identifier: blog
    weight: 30

We get a top-level entry in the main menu because the entry has no parent. To determine the place of the entry we add menu weight.

We may use pages that are ordered by the general page weight inside their sections and appear also in the main menu. That’s why we should always use the special menu weight for site menus.

It’s also possible to add menu entries in the menu section of the site configuration. This is the central menu configuration but I would recommend this option only for entries without a page: Usually external absolute URLs.

This menu is solely determined by the site configuration because it’s meant only for external links represented by icons.

The main_social menu in the menu section of the site configuration may look like this:

main_social:
  - name: GitHub
    pre: github
    url: "https://github.com/bowman2001/perplex"
    weight: 1

List entries start with a dash and contain the name of the entry, the url to the social network, the icon name as the pre value, and a weight to determine the order of the entries from left to right.

This example has only one entry, but you may add as many as you can reasonably fit into the layout.

Simple Icons

You can use any icon name from Simple Icons as a value for the pre parameter.

The icons are open-source but you have to consider potential legal restrictions for their use from the corporations or organizations they represent.

You can place additional icons in the new folder assets/svg/simple-icons in your project root. They are included with their base filename as a value for pre.