🐸 How to Add and Publish Content

Welcome to our content publishing guide! This page will teach you how to add your own projects, stories, and memories to The Froggy House.

πŸ“ Creating a New Post

Step 1: Create a New File

Posts go in the _posts folder with a specific naming format:

YYYY-MM-DD-your-post-title.md

Example: 2024-01-15-our-first-robot.md

Step 2: Add Front Matter

Every post starts with front matter (metadata). Copy this template:

---
layout: post
title: "Your Amazing Title Here"
date: 2024-01-15
categories: [Project]
tags: [coding, fun, family]
author: "Smart Frog"
author_emoji: "πŸŽ“"
---

Step 3: Write Your Content

After the front matter, write your post using Markdown:

# This is a heading

This is a paragraph.

## This is a smaller heading

- This is a bullet point
- Another bullet point

**This is bold text**
*This is italic text*

![Image description](/assets/images/your-image.jpg)

Step 4: Add Images

Place images in assets/images/ and reference them like this:

![Our robot project](/assets/images/robot-project.jpg)

🎨 Creating a Project Page

For bigger projects, create a file in the _projects folder:

Example: _projects/robot-frog.md

---

layout: project
title: "Building Baby Robot Frog"
date: 2024-01-15
featured_image: /assets/images/robot-frog.jpg
technologies: [Arduino, LEDs, Love]
collaborators: ["Daddy Frog", "Smart Frog"]
---

Project description goes here...

πŸ“Έ Adding Family Moments

Special memories go in the _family_moments folder:

---

layout: moment
title: "First Day of Frog School"
date: 2024-01-10
photo: /assets/images/first-day.jpg
family_members: ["Smart Frog", "Mommy Frog"]
---

Memory description...

πŸš€ Publishing Your Content

Option 1: Using GitHub Web Interface

  1. Go to your repository on GitHub
  2. Navigate to the correct folder (_posts, _projects, etc.)
  3. Click "Add file" β†’ "Create new file"
  4. Name your file and add content
  5. Click "Commit new file"
  6. GitHub Pages will automatically build and publish!

Option 2: Using Git Command Line

# Clone the repository
git clone <https://github.com/froggy-house/froggy-house.github.io.git>

# Create your post

cd froggy-house.github.io/_posts
nano 2024-01-15-my-post.md

# Add and commit

git add .
git commit -m "Add new post about our robot project"

# Push to GitHub

git push origin main

Option 3: Using GitHub Desktop

  1. Clone the repository using GitHub Desktop
  2. Create your files locally
  3. Commit changes with a descriptive message
  4. Push to origin

πŸ§ͺ Testing Locally

To preview your changes before publishing:

# Install Jekyll (one time)
gem install bundler jekyll

# Install dependencies

bundle install

# Run local server

bundle exec jekyll serve

# Visit <http://localhost:4000> in your browser

πŸ’‘ Tips for Great Content

  • Use descriptive titles: Make them fun and froggy!
  • Add images: Pictures make posts more engaging
  • Tag appropriately: Help others find related content
  • Write for the family: Keep it friendly and accessible
  • Document the process: Share how you made things, not just the result
  • Include everyone: Mention who helped or participated

πŸ“š Markdown Quick Reference

Element Markdown Syntax Result
Heading 1 # Heading

Heading

Heading 2 ## Heading

Heading

Bold **bold text** bold text
Italic *italic text* italic text
Link [text](url) text
Image ![alt](url) πŸ–ΌοΈ Image
Code `code` code
List - Item β€’ Item

πŸ†˜ Need Help?

If you get stuck:

  • Check the Jekyll Documentation
  • Look at existing posts for examples
  • Ask another family member for help!
  • Remember: mistakes are how we learn 🐸