Sandbox Jekyll documentation
Data Files Configuration
Guide to configuring and managing data files in the _data directory of Sandbox Jekyll theme
Data Files Overview
Navigation Configuration
The navigation.yml file controls the site’s navigation structure, supporting multiple menu types including mega menus, dropdowns, and icon menus.
main:
- title: Pages
type: dropdown
items:
- title: Services
submenu:
- title: Services I
url: /services/
- title: Services II
url: /services2/
- title: Blocks
type: mega-menu-icon
items:
- title: About
url: /docs/blocks/about.html
icon: /assets/img/demos/block1.svg
Theme Settings
The theme.yml file contains global theme settings including colors, fonts, logos, and meta information.
color_scheme: # Aqua Fuchsia Grape Green Leaf Navy Orange Pink Purple Red Sky Violet Yellow
font_scheme: # dm , space , thicccboi , urbanist
logo_1x: "/assets/img/logo.webp"
logo_2x: "/assets/img/logo@2x.webp"
meta_og_image: "/assets/img/meta-image.webp"
Content Configuration
Footer Configuration
The footer.yml file manages footer content including blog-specific elements like popular posts, categories, and tags.
blog:
column_1:
title: Popular Posts
posts: []
default_image: /assets/img/photos/a
column_2:
tags:
title: Tags
items:
- name: Still Life
url: /tag/still-life
Sidebar Configuration
The sidebar.yml defines widgets and components that appear in the blog sidebar.
widgets:
- name: search
title: "Search"
- name: popular-posts
title: "Popular Posts"
limit: 5
- name: categories
title: "Browse Categories"
Dynamic Content
Pricing Plans
The pricing_plans.json file manages pricing table data with support for monthly/yearly pricing and feature lists.
{
"plans": [
{
"name": "Basic Plan",
"svg_icon": "shopping-basket.svg",
"pricing": {
"monthly": { "amount": 9, "currency": "$", "duration": "mo" },
"yearly": { "amount": 99, "currency": "$", "duration": "yr" }
}
}
]
}
Search Configuration
Search Data
The search-data.json template generates searchable content from posts and pages.
[
{
"title": "Post Title",
"content": "Post content...",
"excerpt": "Post excerpt...",
"category": "Category",
"tags": ["tag1", "tag2"],
"url": "/post-url/",
"date": "01 Jan 2024",
"author": "Author Name"
}
]
Usage Guidelines
Accessing Data Files
Access data files in your templates using the site.data variable:
{% assign navigation = site.data.navigation %}
{% assign theme_settings = site.data.theme %}
{% assign footer = site.data.footer %}