akkaz / scuola

La tua idea.
Il tuo primo sito.

Dalla cartella sul computer alla tua prima pagina web. Apri VS Code, costruisci i contenuti e dai loro uno stile, un pezzetto alla volta.

2G · 3 ore · 21 ottobre 2026 · Da solo o in coppia

Il percorso di oggi

1

Prepariamo il banco

20 min · prima ora

Oggi cominci un sito vero, fatto di file che puoi aprire e modificare. Non serve conoscere già HTML. Lavora con un compagno: uno scrive, l'altro legge e prova. Cambiate a ogni tappa.

Prima: la cartella

  1. Apri la tua cartella di lavoro sul PC. Crea una cartella chiamata il-mio-sito.
  2. Cerca Visual Studio Code nel menu del computer e aprilo. È l'editor blu, non Visual Studio.
  3. Scegli File → Open Folder / Apri cartella, seleziona il-mio-sito e conferma. Se chiede se ti fidi, conferma solo per questa cartella creata da te.
  4. Nell'elenco a sinistra, usa New File / Nuovo file. Crea index.html. Poi crea style.css. Scrivi i nomi esattamente così.
il-mio-sito/
 index.html
 style.css

HTML dice quali contenuti ci sono. CSS dice come si vedono. I due file devono stare nella stessa cartella.

VS Code non c’è, o non posso creare file?

Chiedi al docente: non installare programmi senza autorizzazione. Puoi fare tutta la lezione nel banco prova qui sotto. Alla fine scaricherai i due file e potrai aprirli in VS Code.

Non trovo i pulsanti o ho creato index.html.txt

In VS Code: View → Explorer / Visualizza → Esplora risorse apre l’elenco. Con File → New Text File crei un documento; Ctrl+S ti fa scegliere cartella e nome. Su Windows attiva “Estensioni nomi file” in Esplora file. Se compare index.html.txt, rinominalo in index.html.

↑ Tutto il percorso

2

Scegli a chi serve

10 min · prima ora

Inventa una piccola attività: una pizzeria, un negozio di giochi o un laboratorio di riparazione bici. Puoi riprendere il ristorante disegnato in Excalidraw.

La pagina deve permettere di capire cosa offri, leggere due prezzi e trovare gli orari. Usa dati inventati: nessun nome, telefono o indirizzo personale.

Un esempio

“Officina Pedale” aiuta chi usa la bici. Chi visita il sito deve trovare il costo di una riparazione e gli orari. Esempi inventati: camera d’aria 8 €, controllo freni 12 €; martedì–sabato, 9–18.

↑ Tutto il percorso

3

La prima pagina HTML

20 min · prima ora

Nel banco prova trovi un piccolo documento già pronto. Se usi VS Code, premi Copia HTML, incollalo in index.html e salva con Ctrl+S.

  1. Cambia La mia attività nel titolo della scheda e nel titolo grande.
  2. Sostituisci il paragrafo con una frase che spieghi la tua attività.
  3. Nel file CSS incolla il CSS di partenza, poi salva entrambi i file.
  4. Apri la cartella dal computer e fai doppio clic su index.html: si apre nel browser. Dopo una modifica: Ctrl+S in VS Code, poi Ctrl+R nel browser.

Nel banco prova, invece, premi Aggiorna e controlla.

<h1>Officina Pedale</h1>
<p>Ripariamo la tua bici per il prossimo giro.</p>
Che cosa sono questi segni?

<h1> apre il titolo principale; </h1> lo chiude. Il testo sta in mezzo. <p> apre un paragrafo. I segni < e > fanno parte dei tag: non cancellarli quando cambi il testo.

<head> contiene impostazioni; <body> contiene ciò che vediamo nella pagina. Scrivi i contenuti dentro body, non dopo la sua chiusura.

↑ Tutto il percorso

4

Salva i due file

10 min · fine prima ora

Fermati qui per la prima ora. Mostra il titolo e la frase al docente.

  1. In VS Code premi Ctrl+S in index.html e in style.css.
  2. Se usi il banco prova, premi Scarica index.html e Scarica style.css. Metti i due file nella cartella il-mio-sito.
  3. Apri index.html con doppio clic e controlla la pagina.
  4. Alla ripresa riapri la cartella in VS Code. Se continui nel banco prova, ritrovi il codice nello stesso browser.

↑ Tutto il percorso

5

Aggiungi servizi e collegamenti

25 min · seconda ora

Ora rendi utile il sito. Dentro <main>, sotto la presentazione, aggiungi due sezioni. Una sezione è un gruppo di contenuti sullo stesso argomento.

<section id="servizi">
  <h2>Servizi e prezzi</h2>
  <ul>
    <li>Camera d’aria: 8 €</li>
    <li>Controllo freni: 12 €</li>
  </ul>
</section>
<section id="orari">
  <h2>Quando ci trovi</h2>
  <p>Da martedì a sabato, dalle 9 alle 18.</p>
</section>

Riscrivi servizi e prezzi per la tua attività. ul è un elenco; ogni li è una voce.

Il menu, prima del titolo

<nav>
  <a href="#servizi">Servizi e prezzi</a>
  <a href="#orari">Orari</a>
</nav>

href="#orari" porta alla sezione che ha id="orari". Le due parole devono essere uguali. Clicca davvero entrambi i link.

Dove incollo?

Il menu va subito dopo <body>, prima di <main>. Le due sezioni vanno prima di </main>. Non sostituire tutto il documento. Se sbagli, usa Ctrl+Z. Non aggiungere una seconda coppia di tag body.

↑ Tutto il percorso

6

Diamo ordine con il CSS

25 min · seconda ora

Apri style.css. Il collegamento al foglio di stile è già nell'HTML:

<link rel="stylesheet" href="style.css">

Modifica la regola body già presente; aggiungi le altre. Il selettore dice a quali elementi applicare le istruzioni. Ogni istruzione finisce con ;.

body {
  font-family: Arial, sans-serif;
  font-size: 18px;
  line-height: 1.6;
  color: #18332e;
  background: #f6faf8;
  margin: 0;
  padding: 24px;
}
main, nav {
  max-width: 800px;
  margin: auto;
}
section {
  margin-top: 32px;
}
a {
  color: #145e48;
  margin-right: 16px;
}
h1 {
  font-size: 36px;
}
  1. Cambia un valore alla volta e osserva la differenza.
  2. Prova padding: 0, poi torna a 24px: che cosa cambia ai bordi?
  3. Scegli un colore scuro per il titolo, mantenendo testo leggibile e sfondo chiaro.
Il CSS non si vede

Controlla: file chiamato style.css, stessa cartella di index.html, collegamento dentro head, entrambi salvati. Nel CSS controlla le parentesi { } e i punti e virgola. Aggiorna il browser. Non scrivere i tag <style> nel file CSS.

↑ Tutto il percorso

7

Dal computer al telefono

20 min · terza ora

Nel banco prova premi Vista telefono. In VS Code continua a salvare; nel browser riduci la larghezza della finestra. Il contenuto deve restare leggibile senza trascinare a destra.

La riga viewport nell'HTML prepara il sito al telefono. max-width limita la larghezza sui PC ma lascia restringere il contenuto. Una larghezza fissa di 1000px può farlo uscire dallo schermo.

  1. Leggi il nome dell'attività e i prezzi.
  2. Prova il menu: i testi dei link si capiscono e si toccano bene?
  3. Se il titolo è troppo grande, aggiungi questa regola in fondo al CSS.
@media (max-width: 600px) {
  body { padding: 16px; }
  h1 { font-size: 28px; }
  nav a { display: block; margin-bottom: 12px; }
}
Come leggo questa regola?

“Quando la finestra è larga al massimo 600 pixel, usa queste istruzioni”. Sul PC più largo restano le regole precedenti. display: block mette ogni collegamento su una riga propria.

↑ Tutto il percorso

8

Una coppia prova il vostro sito

20 min · terza ora

Scambiatevi di posto. Chi prova riceve queste due richieste, senza indicazioni su dove cliccare:

  1. “Trova il servizio meno caro e dimmi quanto costa.”
  2. “Scopri in quali giorni posso venire.”

Chi ha costruito il sito osserva in silenzio. “È bello” non è un risultato del test: annota cosa la persona ha fatto o non ha trovato.

↑ Tutto il percorso

9

Correggi e rendilo tuo

20 min · terza ora

Applica il miglioramento emerso dal test. Poi chiedi alla stessa persona di riprovare.

Se devi ancora finire: completa titolo, due prezzi, orari e collegamenti. Questo è il risultato principale di oggi.

Solo se il percorso base funziona

Aggiungi una sezione “Come lavoriamo” con tre passaggi e un link nel menu. Oppure una foto autorizzata che conservi nella cartella del sito: scrivi un testo alternativo che descriva la foto. Non cercare né usare foto dei compagni.

Nel file HTML, dentro main:

<img src="negozio.jpg" alt="Ingresso del nostro negozio di esempio">

Nel file CSS:

img { max-width: 100%; height: auto; }

La foto locale si prova nella cartella con VS Code e browser. Il banco prova di questa pagina non carica file immagine dal tuo computer.

↑ Tutto il percorso

10

Mostra, spiega, conserva

10 min · chiusura

Mostrate la pagina al docente. Ognuno risponde a una domanda: quale tag crea il titolo? Come funziona un collegamento interno? Quale regola CSS cambia la distanza dal bordo?

  1. Nel banco prova scarica index.html e style.css nella stessa cartella. Non lasciarli con nomi come index (1).html.
  2. Apri index.html con doppio clic e verifica che lo stile funzioni.
  3. In VS Code, conserva la cartella del sito con entrambi i file salvati.

Avete iniziato un sito reale e locale: non è ancora pubblicato su Internet.

↑ Tutto il percorso

Il banco prova

Usalo qui, oppure copia il codice nei file di VS Code.

Scrivi soltanto HTML e CSS. Ctrl+Z annulla una modifica. I controlli aiutano sulla struttura, non assegnano un voto.

La tua pagina

I controlli riguardano il codice nel banco prova. Se lavori in VS Code, incolla qui i due file aggiornati per controllarli. Le immagini locali si provano nel browser dal tuo PC.

Hai già le basi? Metti alla prova il tuo sito.

Quattro sfide extra per chi ha già usato HTML e VS Code. Scegline una: non serve farle tutte.

Prima controlla che titolo, due prezzi, orari e menu funzionino. Poi aggiungi una cosa utile alla tua attività. Puoi seguire gli indizi oppure provare da solo; alla fine devi saper spiegare il codice.

Le prime tre sfide funzionano anche nel banco prova. Per la quarta usa i file sul PC. Salva con Ctrl+S, aggiorna il browser e prova ogni modifica.

Servizi che si sistemano da soli

20–25 minuti · HTML e CSS · VS Code o banco prova

La sfida: mostra tre servizi affiancati sul computer e uno sotto l’altro sul telefono. Ogni servizio deve avere un nome, una breve descrizione e un prezzo.

Un punto di partenza: elenco e griglia

Dentro <section id="servizi">, sostituisci solo il vecchio elenco <ul>…</ul> con questo. Conserva la sezione e il suo titolo. Adatta i testi alla tua attività.

<ul class="servizi-grid">
  <li>
    <h3>Camera d’aria</h3>
    <p>Sostituzione per ripartire in bici.</p>
    <p><strong>8 €</strong></p>
  </li>
  <li>
    <h3>Controllo freni</h3>
    <p>Verifica e regolazione della frenata.</p>
    <p><strong>12 €</strong></p>
  </li>
  <li>
    <h3>Pulizia catena</h3>
    <p>Pulizia e lubrificazione della catena.</p>
    <p><strong>10 €</strong></p>
  </li>
</ul>

Aggiungi in fondo a style.css:

.servizi-grid {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 16px;
  list-style: none;
  padding: 0;
}
.servizi-grid li {
  background: white;
  border: 1px solid #9aafa7;
  border-radius: 12px;
  padding: 16px;
}
@media (max-width: 600px) {
  .servizi-grid { grid-template-columns: 1fr; }
}

repeat(3, 1fr) crea tre colonne uguali; gap lascia spazio fra loro. Sotto 600 pixel resta una sola colonna.

È riuscita se: nella finestra larga vedi tre colonne; nella vista telefono leggi tutti i prezzi senza scorrere a destra. Sai indicare la regola che cambia il numero di colonne.

Rispondi prima che te lo chiedano

15 minuti · HTML · VS Code o banco prova

La sfida: aggiungi tre domande frequenti con risposte che si aprono al clic, senza JavaScript. Scrivi domande davvero utili per chi visita la tua attività.

L’indizio: details e summary

In index.html, prima di </main>, inserisci una sola sezione. Duplica il blocco details per arrivare a tre domande diverse.

<section id="domande">
  <h2>Domande frequenti</h2>
  <details>
    <summary>Serve un appuntamento?</summary>
    <p>Per una foratura puoi passare durante gli orari di apertura.</p>
  </details>
</section>

summary è la domanda visibile; il paragrafo è la risposta nascosta. Il browser sa già aprirla e chiuderla. Aggiungi al menu <a href="#domande">Domande frequenti</a>.

È riuscita se: tutte e tre le risposte si aprono e si richiudono. Prova anche con Tab per raggiungere una domanda e Invio per aprirla.

Un menu che funziona anche senza mouse

15–20 minuti · CSS e prova di utilizzo · VS Code o banco prova

La sfida: rendi i link del menu comodi da cliccare e fai capire quale link è selezionato quando si usa la tastiera. Il menu deve andare a capo se manca spazio.

L’indizio: flex, hover e focus-visible

Conserva il menu HTML che hai già. Aggiungi queste regole in fondo a style.css, dopo le regole precedenti:

nav {
  display: flex;
  flex-wrap: wrap;
  gap: 12px;
}
nav a {
  display: block;
  padding: 10px 16px;
  margin: 0;
  color: #145e48;
  background: #e4f3eb;
  border-radius: 8px;
}
nav a:hover {
  background: #c8e6d6;
}
nav a:focus-visible {
  outline: 3px solid #145e48;
  outline-offset: 3px;
}

:hover si attiva con il mouse; :focus-visible evidenzia il link raggiunto da tastiera. flex-wrap: wrap permette ai link di andare su più righe.

È riuscita se: con il solo tasto Tab sai sempre dove sei; con Invio raggiungi servizi e orari. Nella vista stretta i link non escono dal bordo. Nel banco prova clicca prima dentro l’anteprima, poi usa Tab.

Da una pagina a un piccolo sito

25–30 minuti · HTML, file e collegamenti · Solo VS Code e browser sul PC

La sfida: crea una seconda pagina “Come lavoriamo” con tre passaggi. Collegala alla pagina iniziale e aggiungi un collegamento per tornare indietro. Le due pagine devono usare lo stesso CSS.

La cartella e il codice da cui partire

In VS Code crea come-lavoriamo.html nella stessa cartella di index.html e style.css. Non cancellare i file esistenti. Nel nuovo file scrivi:

<!doctype html>
<html lang="it">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Come lavoriamo · Officina Pedale</title>
  <link rel="stylesheet" href="style.css">
</head>
<body>
  <nav><a href="index.html">Torna alla pagina iniziale</a></nav>
  <main>
    <h1>Come lavoriamo</h1>
    <ol>
      <li>Ascoltiamo il problema della tua bici.</li>
      <li>Ti spieghiamo intervento e prezzo.</li>
      <li>Ripariamo e controlliamo insieme il risultato.</li>
    </ol>
  </main>
</body>
</html>

Nel menu di index.html aggiungi:

<a href="come-lavoriamo.html">Come lavoriamo</a>

Qui il collegamento punta a un file, quindi non mettere #. Salva entrambi gli HTML. Per provarli apri index.html dal PC: il banco prova gestisce una sola pagina.

È riuscita se: puoi andare e tornare cliccando i collegamenti. Cambiando il colore del titolo in style.css, lo vedi cambiare su entrambe le pagine dopo averle aggiornate.

Prima di dire “finito”

Fai provare la tua aggiunta a un compagno senza suggerirgli dove cliccare. Poi mostra al docente il pezzo di HTML o CSS che la fa funzionare. Conserva tutti i file del sito nella stessa cartella.

↑ Torna al banco prova · Rivedi il percorso base