πΈ 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*

Step 4: Add Images
Place images in assets/images/
and reference them like this:

π¨ 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
- Go to your repository on GitHub
- Navigate to the correct folder (_posts, _projects, etc.)
- Click "Add file" β "Create new file"
- Name your file and add content
- Click "Commit new file"
- 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
- Clone the repository using GitHub Desktop
- Create your files locally
- Commit changes with a descriptive message
- 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 |  |
πΌοΈ 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 πΈ