post

Simple Post with Sidebar Guide

Simple Post with Sidebar Guide

Overview

This guide explains how to create a blog post with a sidebar using the Snowlake Jekyll theme.

Front Matter Configuration

Layout and Basic Information

layout: posts/post-sidebar       # Required layout for sidebar post
title: "Post Title"              # Main title of the blog post
date: YYYY-MM-DD HH:MM:SS +TIMEZONE  # Publication date and time

Categorization and Metadata

categories: [category1, category2]  # Post categories
tags: [tag1, tag2]                  # Post tags
author: "Author Name"               # Post author
post_image: "/path/to/image.webp"   # Featured post image

Advanced Metadata

badge_color: "bg-purple"            # Optional badge color
slider_post: true/false             # Include in slider
trending: true/false                # Mark as trending
meta_title: "SEO Title"             # SEO-optimized title
meta_description: |                 # SEO description
  Detailed description of the post
sidebar: true                       # Enable sidebar
permalink: "/posts/post-slug"       # Custom permalink

Content Structure

Markdown Content Guidelines

---
# Front Matter (as described above)
---

# Main Content
Write your blog post content using Markdown.

## Subheadings
Use standard Markdown formatting.

### Additional Elements
- Paragraphs
- Lists
- Blockquotes
- Code blocks
  • Automatically includes related content
  • Supports author information
  • Displays recent posts
  • Includes category and tag navigation

Best Practices

Content Writing

  1. Use clear, engaging headings
  2. Break content into digestible sections
  3. Use subheadings for readability
  4. Include relevant images
  5. Maintain a consistent writing style

Formatting Tips

  • Use <div class="space20"></div> for spacing
  • Utilize blockquote styles
  • Implement semantic HTML
  • Use Markdown for basic formatting

Customization Options

  • Modify sidebar content
  • Customize badge colors
  • Control slider and trending flags
  • Adjust permalink structure

SEO Optimization

  • Provide descriptive meta title
  • Write comprehensive meta description
  • Use relevant categories and tags
  • Include alt text for images

Accessibility Considerations

  • Use semantic HTML
  • Provide descriptive link texts
  • Ensure color contrast
  • Support screen readers

Troubleshooting

  • Verify front matter syntax
  • Check image paths
  • Validate Markdown formatting
  • Test permalink functionality

Example Workflow

  1. Choose a compelling topic
  2. Write engaging content
  3. Configure front matter
  4. Add relevant images
  5. Review and refine
  6. Publish