Azure Meetup Casteddu - Post Creation Skill

Repository: Azure Meetup Casteddu Blog
Platform: Jekyll (Minimal Mistakes Theme)
Language: Primarily Italian
Purpose: Community blog for Azure events, sessions, and announcements

1. Naming Convention

File Naming Format

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

Examples:

Rules:

/YYYY/MM/DD/slug-title/

Example:

permalink: "/2025/12/01/antonio-buonaiuto-microsoft-most-valuable-professional-acknowledgement/"

2. Front Matter Structure

Complete Front Matter Template

---
title: "Post Title"
author: Author Name                    # Single author
authors:                              # Multiple authors (alternative)
  - Author One
  - Author Two
permalink: "/YYYY/MM/DD/slug-title/"
category: [Category1, Category2]
tags: [Tag1, Tag2, Tag3]
classes: "wide"                       # Optional: use "wide" for full width
layout: splash                        # Optional: for special pages (default: post)
excerpt: "Brief description..."       # Optional: 1-2 sentences summary
toc: true                             # Optional: enable table of contents
toc_label: "Table Title"              # Optional: TOC label
toc_icon: "book"                      # Optional: Font Awesome icon
toc_sticky: true                      # Optional: sticky TOC on scroll
gallery:                              # Optional: images gallery
  - url: /assets/images/YYYY-MM-DD/filename.jpg
    image_path: /assets/images/YYYY-MM-DD/filename.jpg
    alt: "description"
    title: ""
header:                               # Optional: hero image or video
  overlay_image: /assets/images/path.jpg
  overlay_filter: 0.5
  video:
    id: YouTubeVideoId
    provider: youtube
author:                               # Complex author with details
  name: "Author Name"
  avatar: "/assets/images/YYYY-MM-DD/author.jpg"
  links:
    - label: "Label"
      icon: "fab fa-fw fa-linkedin"
      url: "https://example.com"
---

Standard Field Values

Categories (use as applicable):

Common Tags:

3. Content Structure

Standard Content Layout

---
[Front matter as above]
---

[Opening paragraph - 2-3 sentences introducing the topic]

[Optional: Include gallery]




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


[Main content body]

[Optional: Additional sections with headings]

[Links/Resources section if needed]

Content Elements





<figure class=" ">
  
  
    <figcaption>Descriptive caption for the gallery
</figcaption>
  
</figure>





<figure class=" ">
  
  
    <figcaption>Specific gallery reference
</figcaption>
  
</figure>


[Link Text](https://url.com)
[Link Text](https://url.com){:target="_blank"}

Embedded Content

PDF Embedding:

<embed src="/assets/pdf/filename.pdf" type="application/pdf" />

YouTube Video:

<div id="eventbrite-widget-container-ID"></div>

<script src="https://www.eventbrite.it/static/widgets/eb_widgets.js"></script>

<script type="text/javascript">
    window.EBWidgets.createWidget({
        widgetType: 'checkout',
        eventId: 'EVENT_ID',
        iframeContainerId: 'eventbrite-widget-container-ID',
        iframeContainerHeight: 425
    });
</script>

Typography & Formatting

Content Tone & Style

4. Asset Management

Image Directory Structure

/assets/images/YYYY-MM-DD/
  - filename-descriptive.jpg
  - filename-descriptive.png

Naming Convention:

Image Guidelines

Other Assets

5. Author Management

Author File Location

_data/authors.yml

Author Entry Template

Author Name:
  name: "Display Name"
  bio: "Optional bio"
  avatar: "/assets/images/AuthorName.jpg"
  links:
    - label: "Label"
      icon: "fab fa-fw fa-linkedin"    # Font Awesome icon class
      url: "https://url.com"
    - label: "Email"
      icon: "fas fa-fw fa-envelope-square"
      url: "mailto:email@example.com"
    - label: "Website"
      icon: "fas fa-fw fa-link"
      url: "https://website.com"

Icon Classes (Font Awesome)

Author Reference in Posts

author: Author Name                    # Single author (must match _data/authors.yml)

authors:                              # Multiple authors
  - Author One
  - Author Two

6. Common Post Types

Type 1: Event Announcement

Use for: Meetup events, conferences, sessions

Key Fields:

Example File: 2026-02-20-luigi-pandolfino-azure-meetup-casteddu-azure-site-recovery-come-ti-salvo-is-nadigas.md

Type 2: Session Recap/Blog Post

Use for: Summary of past events, deep-dive articles

Key Fields:

Example File: 2025-07-27-fabio-cannas-the-azure-developers-superpower-azd-cli.md

Type 3: Community Announcement

Use for: MVP announcements, milestone achievements

Key Fields:

Example File: 2025-12-01-antonio-buonaiuto-microsoft-most-valuable-professional-acknowledgement.md

Type 4: Session at External Conference

Use for: Global Azure, sessions at other events

Key Fields:

Example File: 2026-01-19-fabio-cannas-global-azure-veneto-2026-infrastructure-as-code-on-azure-session.md

Type 5: Multi-Author Content

Use for: Collaborative posts, panel discussions

Key Fields:

Example File: 2025-12-23-meetup4xmas.md

7. Post Creation Workflow

Step 1: Prepare Assets

  1. Create date-based directory: /assets/images/YYYY-MM-DD/
  2. Save images with descriptive names
  3. Optimize images for web (recommended max: 1200px width)

Step 2: Create Front Matter

  1. Determine publication date (YYYY-MM-DD)
  2. Create file name using naming convention
  3. Fill in front matter fields:
    • Unique permalink (based on date and slug)
    • Appropriate category
    • Relevant tags
    • Gallery with image paths
    • Author reference

Step 3: Write Content

  1. Start with engaging opening paragraph
  2. Include gallery with caption
  3. Structure with clear headings (if needed)
  4. Use markdown formatting consistently
  5. Add emojis for visual interest (moderate use)
  6. Include CTAs and relevant links

Step 4: Validate

  1. Check date format in filename and permalink
  2. Verify all image paths exist
  3. Confirm author name matches _data/authors.yml
  4. Test links before publishing
  5. Verify categories and tags

Step 5: Publish

  1. Commit file to _posts/ directory
  2. Push to GitHub
  3. Site builds automatically (GitHub Pages)
  4. Verify post appears correctly on site

8. Quick Reference: Categories & Tags

Meetup          - Local meetup events
Global Azure    - International Azure events
Community       - Community news and announcements
Articoli        - In-depth articles
Workshop        - Workshop/training sessions

Azure           - All posts about Azure
Meetup          - Event-related posts
Community       - Community involvement
Global Azure    - International events
Event names     - Global Azure 2025, Global Azure Veneto 2026
Topics          - azd CLI, Azure Site Recovery, AI Gateway, etc.
Speaker names   - When relevant (Antonio Buonaiuto, Fabio Cannas, etc.)
Content type    - Session, Speech, Dev, Workshop
Skill levels    - Beginner, Intermediate, Advanced (if applicable)

9. Examples & Templates

Minimal Post

---
title: "Event Name - Speaker Name - Topic"
author: Speaker Name
permalink: "/YYYY/MM/DD/slug-title/"
category: [Meetup]
tags: [Azure, Meetup, Community]
gallery:
  - url: /assets/images/YYYY-MM-DD/image.jpg
    image_path: /assets/images/YYYY-MM-DD/image.jpg
    alt: "description"
    title: ""
---





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


Brief introduction to the event or session.

[Registration Link](https://url.com)

Complete Post

---
title: "Azure Meetup Casteddu - Speaker - Topic: Detailed Description"
classes: "wide"
author:
  name: "Speaker Name"
  avatar: "/assets/images/YYYY-MM-DD/speaker.jpg"
  links:
    - label: "LinkedIn"
      icon: "fab fa-fw fa-linkedin"
      url: "https://linkedin.com/in/..."
    - label: "Website"
      icon: "fas fa-fw fa-link"
      url: "https://website.com"
permalink: "/YYYY/MM/DD/slug-title/"
category: [Meetup, Community]
tags: [Azure, Meetup, Community, Topic]
excerpt: "Brief summary of the session..."
toc: true
toc_label: "Contents"
toc_icon: "book"
gallery:
  - url: /assets/images/YYYY-MM-DD/session.jpg
    image_path: /assets/images/YYYY-MM-DD/session.jpg
    alt: "Session description"
    title: ""
---

🎉 Event Introduction





<figure class=" ">
  
  
    <figcaption>Event Title
</figcaption>
  
</figure>


## Section 1
Details and content...

## Section 2
More details...

[Learn More](https://url.com)

[Eventbrite Registration](https://eventbrite.com/...)

10. SEO & Best Practices

Title Guidelines

Excerpt Guidelines

Image Optimization

11. Common Mistakes to Avoid

❌ Incorrect date format in filename or permalink
❌ Missing author from _data/authors.yml
❌ Broken image paths (verify paths exist)
❌ Typos in permalink (URLs are permanent)
❌ Empty gallery captions (use descriptive text)
❌ Inconsistent formatting (follow markdown style)
❌ Missing category or tags (improves discoverability)
❌ Broken external links (test before publishing)
❌ Inconsistent author names (must match exactly)
❌ Date in future (post won’t appear until publication date)

12. Helpful Commands

Run site locally

bundle exec jekyll serve

Then visit: http://127.0.0.1:4000

Build assets

npm run build:js

Update gems

bundle update

Validate Jekyll

bundle exec jekyll doctor

Example File: Complete Reference

File: _posts/2026-02-20-luigi-pandolfino-azure-meetup-casteddu-azure-site-recovery-come-ti-salvo-is-nadigas.md

---
title: "Azure Meetup Casteddu - Luigi Pandolfino - Azure Site Recovery: come ti salvo is nàdigas!"
classes: "wide"
author: 
  name: "Luigi Pandolfino"
  avatar: "/assets/images/2026-02-20/luigi-pandolfino.jpg"
  links:
      - label: "azurelab.blog"
        icon: "fas fa-fw fa-link"
        url: "https://www.azurelab.blog/"
      - label: "LinkedIn"
        icon: "fab fa-fw fa-linkedin"
        url: "https://www.linkedin.com/in/pandolfino/"
permalink: "/2026/02/20/luigi-pandolfino-azure-meetup-casteddu-azure-site-recovery-come-ti-salvo-is-nadigas/"
category: [Meetup, Community]
tags: [Meetup, Community, Azure Site Recovery]
excerpt: "Azure Site Recovery è uno strumento essenziale per la protezione dei dati e il ripristino di emergenza. Scopri come funziona e come usarlo."
gallery:
- url: /assets/images/2026-02-20/luigi-pandolfino-azure-meetup-casteddu-azure-site-recovery-come-ti-salvo-is-nadigas.png
  image_path: /assets/images/2026-02-20/luigi-pandolfino-azure-meetup-casteddu-azure-site-recovery-come-ti-salvo-is-nadigas.png
  alt: "luigi-pandolfino-azure-meetup-casteddu-azure-site-recovery-come-ti-salvo-is-nadigas"
  title: ""
---





<figure class=" ">
  
  
    <figcaption>Azure Meetup Casteddu - Luigi Pandolfino - Azure Site Recovery: come ti salvo is nàdigas!
</figcaption>
  
</figure>


😴➡️😳 La tua azienda si è svegliata dal torpore…

[Content continues...]

Last Updated: April 20, 2026
Repository: azuremeetupcasteddu/azuremeetupcasteddu.github.io
Theme: Minimal Mistakes (Jekyll)