📝 Azure Meetup Casteddu - Post Creation Guide

Welcome! This directory contains comprehensive guides and templates for creating blog posts for the Azure Meetup Casteddu website.

📚 Available Resources

1. SKILLS_POST_CREATION.md - The Complete Reference

What it contains:

When to use:

Read time: 15-20 minutes (detailed reference)

2. TEMPLATES_POST_CREATION.md - Ready-to-Use Templates

What it contains:

When to use:

Read time: 10-15 minutes (skim and copy what you need)

3. COPILOT_POST_CREATION.md - GitHub Copilot Integration

What it contains:

When to use:

Read time: 10 minutes (learn the pattern, then reference as needed)

🚀 Quick Start: Create Your First Post

Option A: Manual Creation

  1. Read → TEMPLATES_POST_CREATION.md (choose your post type)
  2. Copy → appropriate template
  3. Customize → fill in your details
  4. Verify → check against checklist
  5. Create file → in _posts/ directory
  6. Test locally → bundle exec jekyll serve
  7. Commit → push to GitHub

Option B: Using Copilot

  1. Open → COPILOT_POST_CREATION.md
  2. Ask Copilot → “Create a post about [Topic]”
  3. Provide details → speaker, date, content
  4. Copilot generates → complete post
  5. Copy output → create file
  6. Validate → test locally
  7. Commit → push to GitHub

📋 Core Conventions at a Glance

Filename Format

YYYY-MM-DD-author-slug-title-slug.md

Required Frontmatter

title: "Post Title"
author: Author Name              # or authors: [Author1, Author2]
permalink: "/YYYY/MM/DD/slug/"
category: [Category1, Category2]
tags: [tag1, tag2, tag3]

Content Structure

---
[Frontmatter]
---





<figure class=" ">
  
  
    <figcaption>Caption
</figcaption>
  
</figure>


[Opening paragraph]

[Main content sections]

[Links/CTA]

Image Locations

/assets/images/YYYY-MM-DD/[filename].jpg

🎯 Choose Your Post Type

1. Meetup Event Announcement 📢

2. Session Recap 📖

3. Community Announcement 🎉

4. Conference Session 🌍

5. Multi-Author / Panel 👥

6. Quick Update ⚡

✅ Pre-Publishing Checklist

🔗 Important Files & Directories

/
├── SKILLS_POST_CREATION.md          ← Full conventions guide
├── TEMPLATES_POST_CREATION.md       ← Ready-to-use templates
├── COPILOT_POST_CREATION.md         ← Copilot integration guide
├── _posts/                          ← Your post files go here
│   └── YYYY-MM-DD-slug.md
├── _data/
│   └── authors.yml                  ← Author profiles
├── assets/
│   ├── images/
│   │   └── YYYY-MM-DD/              ← Your images here
│   └── pdf/                         ← PDFs and presentations
├── _config.yml                      ← Site configuration
└── README.md                        ← Repository README

🎤 Categories & Tags Reference

Standard Categories

Common Tags

👥 Author Management

Adding a New Author

  1. Edit: _data/authors.yml
  2. Add entry: 
    New Author Name:
  name: "Display Name"
  bio: "Optional bio"
  avatar: "/assets/images/NewAuthor.jpg"
  links:
    - label: "LinkedIn"
      icon: "fab fa-fw fa-linkedin"
      url: "https://linkedin.com/in/..."
  3. Reference in post: Use exact name from authors.yml

Common Icons

🖼️ Asset Management

Image Naming Convention

/assets/images/YYYY-MM-DD/filename-description.jpg

Examples:

Guidelines

Supported Formats

🔧 Local Testing

Run Site Locally

bundle exec jekyll serve

Then visit: http://127.0.0.1:4000

Troubleshooting

📖 Examples in Repository

Look at existing posts in _posts/ for real examples:

❓ FAQ

Q: What date should I use?

A: The date the post is published (or should be published). Use YYYY-MM-DD format.

Q: What if I have multiple authors?

A: Use authors: [Author1, Author2] instead of single author: field.

Q: Can I use English in posts?

A: Primarily Italian, but some posts include English (e.g., technical sessions). See examples.

Q: Where do I put images?

A: In /assets/images/YYYY-MM-DD/ directory, matching your post date.

Q: How many emojis should I use?

A: 3-5 strategically placed for visual interest. Too many looks unprofessional.

Q: What if my post is ready but shows future date?

A: Either change the date, or wait until the publication date for it to appear.

Q: Can I update existing posts?

A: Yes, but don’t change the date (it changes the URL). Edit the content directly.

Q: How do I add a video?

A: Use YouTube embed in header.video or include EventBrite widget in content.

🎓 Learning Path

  1. First time? Start with TEMPLATES_POST_CREATION.md (Template 1)
  2. Need details? Read SKILLS_POST_CREATION.md section by section
  3. Using Copilot? Follow COPILOT_POST_CREATION.md
  4. Creating your post? Use appropriate template + checklist
  5. Need reference? Quick reference above or full guide

💡 Pro Tips

✅ Reuse author profiles - Once in _data/authors.yml, just reference by name
✅ Use existing tags - Helps with site navigation
✅ Check examples - Look at past posts for style/tone
✅ Test locally - Always run bundle exec jekyll serve first
✅ Validate links - Test all URLs before committing
✅ Keep images small - Optimize before uploading
✅ Be consistent - Follow conventions helps users predict structure

📞 Need Help?

📌 Quick Links

Last Updated: April 20, 2026
Repository: azuremeetupcasteddu/azuremeetupcasteddu.github.io
Theme: Minimal Mistakes Jekyll Theme
Language: Primarily Italian