Sandbox Jekyll documentation

Navigation Configuration Guide

Explanation of the navigation.yml settings for the Sandbox Jekyll theme

The main section defines the primary navigation menu, supporting dropdowns, mega menus, and direct links.

main:
  - title: Demos
    type: mega-menu-img
    items:
      - title: Demo1
        url: /demo1/
        image: /assets/img/demos/mi1.webp
        image2x: /assets/img/demos/mi1@2x.webp
      - title: Demo2
        url: /demo2/
        image: /assets/img/demos/mi2.webp
        image2x: /assets/img/demos/mi2@2x.webp
  - title: Pages
    type: dropdown
    items:
      - title: About
        submenu:
          - title: About I
            url: /about/
          - title: About II
            url: /about2/
      - title: Services
        submenu:
          - title: Services I
            url: /services/
          - title: Services II
            url: /services2/

Multi-Column Dropdown (Projects)

A multi-column dropdown menu, useful for displaying portfolios or projects in an organized structure.

  - title: Projects
    type: dropdown-columns
    items:
      - title: Project Pages
        submenu:
          - title: Projects I
            url: /projects-tiles/
      - title: Single Projects
        submenu:
          - title: Single Project I
            url: /projects/sample-with-slider/

Mega Menu with Icons (Blocks)

A mega menu that displays UI components such as Features, Contact, and About with icons.

  - title: Blocks
    type: mega-menu-icon
    items:
      - title: Features
        url: /docs/blocks/features.html
        icon: /assets/img/demos/block8.svg
      - title: Contact
        url: /docs/blocks/contact.html
        icon: /assets/img/demos/block5.svg

Documentation Navigation Example

The docs type is used for sidebar navigation in documentation pages. It organizes links into sections and subcategories for better accessibility.

# Documentation Navigation Example
docs_navigation:
  - title: "Getting Started"
    url: "/docs/getting-started"
    children:
      - title: "Installation"
        url: "/docs/installation"
      - title: "Folder Structure"
        url: "/docs/folder-structure"

  - title: "Customization"
    url: "/docs/customization"
    children:
      - title: "Theme Configuration"
        url: "/docs/theme-config"
      - title: "Styling"
        url: "/docs/styling"

  - title: "Advanced"
    url: "/docs/advanced"
    children:
      - title: "Performance"
        url: "/docs/performance"
      - title: "SEO Optimization"
        url: "/docs/seo"

One-Page Navigation

One-page navigation allows users to click menu links that scroll smoothly to different sections of a single-page website.

onepage:
  links:
    - text: Home
      url: "#home"
    - text: About
      url: "#about"
    - text: Services
      url: "#services"
    - text: Contact
      url: "#contact"

Below is a quick reference table summarizing the different navigation types supported in navigation.yml.

Navigation Type Description Example
Documentation Navigation Sidebar navigation specifically for documentation pages. type: docs
Mega Menu (Images) Displays large dropdown menus with images. type: mega-menu-img
Dropdown Menu A standard multi-level dropdown navigation. type: dropdown
Dropdown Columns Multi-column dropdown layout for structured navigation. type: dropdown-columns
Mega Menu (Icons) Displays UI blocks in a large dropdown with icons. type: mega-menu-icon
One-Page Navigation Links that scroll smoothly to different sections. onepage: links