The landing layout is designed for creating a sleek, minimal homepage or landing page for your Jekyll site. It provides a structured format for showcasing a masthead, repository information, navigation links, and social media profiles.
To use the Landing layout in your Jekyll site, create a new file with the following front matter:
---
layout: landing
---
The Landing layout accepts several parameters in the front matter:
| Parameter | Default | Description |
|---|---|---|
layout |
Required | Must be set to landing |
style |
none |
Layout style customization (optional) |
repo_info |
site.repo_info |
Shows repository information when enabled |
nav |
site.nav |
Navigation items to render on the page |
social_media |
site.social_media |
Social media configuration used to render social profile links |
This example shows a basic Landing page setup:
---
layout: landing
style: none
repo_info: true
---
To override the site navigation for just this page, pass a custom list of links:
---
layout: landing
nav:
- name: Docs
url: /docs/
- name: Blog
url: /blog/
---
nav is not defined at the page or site level, the landing page simply renders without navigation.nav to a list of links when you want to override site.nav for a single page.repo_info and social_media are configured in _config.yml if needed.This layout may depend on:
masthead.html include for branding.toggle.html include for theme switching.mini-repo-info-card.html include for repository info.nav.html include for navigation.social.html include for social media links.Ensure these dependencies are properly set up in your Jekyll theme for the Landing layout to function correctly.