Gorgo LabVieni a vedere →

Per chi fa

Pubblica il tuo progetto

Vuoi metterci il tuo progetto? Fallo e basta. Tu scrivi il contenuto, il sito ci mette la grafica: non serve sapere HTML, CSS o come è fatto questo sito.

La scorciatoiaParti dal modello →Una pagina che contiene ogni formattazione disponibile, già scritta e commentata. Copiala, cancella quello che non ti serve, sostituisci il resto.
  1. 1

    Prepara la cartella

    Una cartella per progetto, con dentro tutto: il testo, le foto, gli allegati. Niente file sparsi.

  2. 2

    Compila il frontmatter

    Le poche righe in cima al file che dicono al sito titolo, descrizione, autori e tag. Il resto è markdown normale.

  3. 3

    Apri una pull request

    Un bot controlla che tutto sia a posto e costruisce un'anteprima del sito con il tuo progetto dentro.

  4. 4

    Merge

    Quando la revisione è ok, il progetto è online. Impaginazione, immagini e anteprime le fa il sito.

La struttura della cartella

Ogni progetto vive in src/content/progetti/, in una cartella che porta il suo nome in minuscolo-con-trattini. Quel nome diventa l'indirizzo della pagina.

src/content/progetti/
└── braccio-robotico/          ← diventa /progetti/braccio-robotico/
    ├── index.md               ← il testo del progetto
    ├── copertina.jpg          ← immagine di apertura e anteprima
    ├── montaggio-01.jpg
    ├── prototipo.jpg
    ├── schema.pdf             ← allegato scaricabile
    └── firmware.zip

Le immagini le richiami con un percorso relativo (./copertina.jpg): il sito le ridimensiona, le converte in formati moderni e genera le versioni per telefono e desktop. Carica pure la foto grossa che esce dal telefono, non serve che la ritocchi.

![Descrizione per chi non vede la foto](./montaggio.jpg)
![Descrizione per chi non vede la foto](./montaggio.jpg "Didascalia sotto la foto")

Il testo fra parentesi quadre è obbligatorio: lo legge chi usa uno screen reader, quindi descrivi cosa si vede. Quello fra virgolette è facoltativo e diventa la didascalia stampata sotto la foto, quindi non ripetere la stessa frase due volte.

Il frontmatter, per intero

È la parte tra i due --- in cima al file. Se sbagli o dimentichi un campo, la pull request diventa rossa e ti dice quale: non c'è modo di pubblicare un progetto rotto per distrazione.

---
title: Braccio robotico da scrivania
summary: Un braccio a 4 assi stampato in 3D, comandato da un ESP32,
  che sposta componenti SMD sul banco di saldatura.
date: 2026-03-14
authors:
  - Nome Cognome
tags:
  - robotica
  - stampa-3d
status: completato
cover: ./copertina.jpg
coverAlt: Il braccio robotico appoggiato sul banco di lavoro
gallery:
  - ./montaggio-01.jpg
  - ./montaggio-02.jpg
galleryAlt:
  - Le parti stampate prima del montaggio
  - Il braccio a metà assemblaggio
attachments:
  - file: schema.pdf
    label: Schema elettrico
    note: KiCad 8, esportato in PDF
  - file: firmware.zip
    label: Firmware ESP32
links:
  - label: Repository su GitHub
    url: https://github.com/utente/braccio
license: CC BY-SA 4.0
---

## Da dove è partita l'idea

Testo normale in markdown. Le immagini si mettono così:

![Il primo prototipo, storto](./prototipo.jpg)

Campi obbligatori e valori ammessi

  • title — da 3 a 90 caratteri.
  • summary — da 20 a 220 caratteri: è il testo che si legge nell'anteprima.
  • date — formato AAAA-MM-GG.
  • authors — almeno un nome.
  • cover + coverAlt — immagine di apertura e sua descrizione testuale (serve a chi usa uno screen reader, non è opzionale).
  • tags — da 1 a 6, scelti da questa lista:programmazioneelettronicaroboticastampa-3dcnclaserfalegnameriaartigianatotessilescienzaartefai-da-teriparazionedomoticaworkshopSe manca il tag che ti serve, aggiungilo a src/site.config.ts nella stessa PR.
  • status — uno tra:ideain-corsocompletatosospeso

Video, riquadri e specifiche

Se rinomini il file da index.md a index.mdx puoi usare anche questi blocchi, senza importare nulla:

<Video provider="youtube" id="dQw4w9WgXcQ" title="Il braccio in funzione" />

<Callout type="warning" title="Occhio">
L'alimentatore va collegato **prima** di innestare i servo.
</Callout>

<Specs items={[["Materiale","PLA"],["Assi","4"],["Peso","480 g"]]} />

I video vanno sempre embeddati da YouTube o Vimeo, mai caricati come file: un video nel repository lo appesantisce per sempre, anche se poi lo cancelli.

Collegamenti a risorse esterne

Dentro il testo, quando il rimando serve in quel punto del discorso — la voce che spiega la tecnica, il datasheet, il negozio dove hai trovato il pezzo:

la voce di [Wikipedia](https://www.wikipedia.org) che spiega la tecnica

Nel frontmatter, quando invece è una destinazione stabile del progetto: i links finiscono nella colonna di destra della pagina, sotto "Link esterni", sempre nello stesso posto. Il label è il testo che si legge, non l'indirizzo.

links:
  - label: Repository su GitHub
    url: https://github.com/utente/braccio

I collegamenti esterni non li verifica nessun controllo automatico: provali prima di aprire la pull request.

Un articolo invece di un progetto

Stessa procedura, ma la cartella va in src/content/blog/ e il frontmatter non ha status, gallery,attachments né links.

Se git non è il tuo mestiere

Non serve saperlo usare. Due strade, scegli quella che ti pesa meno.

Dal sito di GitHub, senza installare niente

Ti basta un account GitHub gratuito e l'invito al repository. Poi, dal browser: apri src/content/progetti/, premiAdd file → Upload files, trascina dentro la tua cartella intera, e in fondo scegli "Create a new branch for this commit and start a pull request". Hai aperto una pull request senza mai vedere un terminale.

Se ti serve un editor vero, premi il tasto . sul repository: si apre VS Code nel browser, sempre con il trascinamento dei file.

Mandaci uno zip

Nessun account, niente. Ci mandi la cartella zippata e la importiamo noi con un comando che ricomprime le immagini, ne toglie i dati EXIF (posizione GPS compresa) e prepara il file da completare. Le foto caricale come stanno, grandi quanto vengono.