Questa guida è il riferimento ufficiale per ogni collaboratore di OSS Pratico. Seguire questi standard assicura che il portale rimanga professionale, accessibile e premiato dai motori di ricerca (SEO) e dalle AI.

---

🏗️ La Struttura del Frontmatter

Ogni articolo deve iniziare con il blocco di configurazione (Frontmatter). Ecco lo schema obbligatorio:

---
title: "Titolo Accattivante"
description: "Riassunto di 150-160 caratteri per Google."
category: "Procedure Pratiche" # Scegli tra le 6 categorie fisse
author:
  name: "Tuo Nome"
  social:
    linkedin: "https://linkedin.com/..."
date: 2024-03-28
lastUpdated: 2026-03-28 # Aggiorna sempre se modifichi il contenuto
readTime: "5 min"
image: "../../assets/images/nome-immagine.jpg"
icon: "menu_book" # Usa i nomi da Google Material Symbols
theme: "peach" # Scegli tra: peach, sage, amber, stone
tags: ["oss", "salute"] # Tag liberi per la ricerca
---

🏷️ Le 6 Categorie Ufficiali

Devi usare esattamente uno di questi nomi nel campo category:

• Procedure Pratiche
• Salute & Benessere
• Contratti & Lavoro
• Formazione & Carriera
• Etica & Relazione
• Emergenza & Primo Soccorso

---

✍️ Markdown: Codice vs Risultato

Ecco come scrivere il contenuto per ottenere un aspetto Premium.

1. Intestazioni (Hierarchy)

Usa # solo per il titolo (già gestito dal frontmatter). Nel testo usa ## e ###.

Codice Markdown	Risultato Previsto
## Sezione Principale	Titolo grande con font Fraunces
### Sotto-sezione	Titolo medio in grassetto

2. Formattazione Base

Stile	Codice Markdown
Grassetto	**parola chiave**
Corsivo	*termine tecnico*
Link	[Testo](URL)

---

💎 Admonitions (Box Speciali)

Usa i blocchi di citazione per evidenziare informazioni critiche.

NOTA (Informazione generale)

NOTE: Questo è un box informativo per dare contesto aggiuntivo.

CONSIGLIO (Best practice)

TIP: Usa sempre i guanti monouso prima di iniziare la procedura.

ATTENZIONE (Pericolo o Errore)

WARNING: Non somministrare farmaci senza la prescrizione medica.

---

📸 Immagini e Media

Per inserire un’immagine nel testo: ![Descrizione Alt](../../assets/images/nome-file.jpg)

TIP: Assicurati che l’immagine abbia un testo “Alt” descrittivo per l’accessibilità e la SEO delle immagini.

---

🏁 Checklist prima di pubblicare

1. Il titolo contiene la parola chiave principale?
2. La description invita al click?
3. Ho inserito il mio link LinkedIn nel frontmatter?
4. La categoria è una delle 6 ufficiali?
5. Ho usato i ## per dividere i paragrafi?

Seguendo queste regole, il tuo articolo sarà pronto per essere indicizzato da Google e letto da migliaia di colleghi OSS!