---
title: Aggiornamento
description: Voci di changelog in stile cronologia con date, descrizioni e tag di categoria, integrate con il sommario per la navigazione.
---
> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.
Il componente Update crea voci di changelog in stile cronologia, integrate automaticamente con il sommario. Ogni voce può avere un'etichetta con la data, una descrizione e tag di categoria, risultando adatta a pagine "Novità", changelog di API e note di rilascio.
Usa Update per:
- **Documentare i rilasci** con numeri di versione o date
- **Creare changelog** che i lettori possono consultare tramite il sommario
- **Annunciare funzionalità** con tag categorizzati (nuova funzionalità, correzione, modifica incompatibile)
Hai creato un changelog da queste voci? Puoi visualizzarlo nel tuo prodotto con un pulsante "What's new?" e un indicatore di contenuti non letti. Consulta [Incorpora il tuo changelog](/it/development/embed-page).
## Utilizzo di base
Aggiunto il supporto alla modalità scura per tutti i temi.
```mdx
Added support for dark mode across all themes.
```
## Con descrizione
Aggiungi un contesto sotto la data:
La funzione `getData()` ora richiede un oggetto options.
```mdx
The `getData()` function now requires an options object.
```
## Con tag
Classifica le voci con i tag:
- Rimossa l'opzione deprecata `legacyMode`
- Aggiornato il flusso di autenticazione
```mdx
- Removed deprecated `legacyMode` option
- Updated authentication flow
```
## Più voci
Impila i componenti Update per creare un changelog completo:
Nuova funzionalità di esportazione per i formati PDF e CSV.
Corretta la gestione dei fusi orari nei post programmati.
Gli endpoint API `v1` sono ora deprecati. Esegui la migrazione a `v2` entro marzo 2025.
## Link di ancoraggio e sommario
Ogni Update genera un ID di ancoraggio dalla propria etichetta (`label="January 10, 2025"` crea `#january-10-2025`). Le etichette vengono visualizzate anche nel sommario per consentire una navigazione rapida.
## Proprietà
Etichetta della data o della versione (crea un ID di ancoraggio).
Testo secondario sotto l'etichetta.
Tag di categoria visualizzati come badge.
Stringa di data ISO (ad esempio `"2025-03-15"`) utilizzata per `pubDate` nel feed RSS. Non viene visualizzata; `label` rimane il testo mostrato.
## Feed RSS
Consenti ai lettori di iscriversi agli aggiornamenti del changelog. Aggiungi `rss: true` a qualsiasi pagina con componenti Update: Jamdesk genera automaticamente un `feed.xml` durante le build.
```yaml
---
title: Changelog
rss: true
---
```
Quando è abilitato:
- Accanto al titolo della pagina viene visualizzata un'icona RSS che rimanda al feed
- Al `` viene aggiunto un tag `` per il rilevamento automatico, così i lettori RSS e i browser possono trovare il feed
- Ogni `` diventa un elemento RSS con la propria etichetta come titolo e un link di ancoraggio che rimanda alla voce
### Impostazione delle date di pubblicazione
Usa la proprietà `date` per impostare `` per ogni voce del feed. Senza `date`, la voce viene inclusa nel feed ma senza indicazione temporale.
```mdx
Added dark mode support across all themes.
```
### Contenuto del feed
I feed RSS contengono solo testo normale. La formattazione Markdown, i componenti MDX, i blocchi di codice e l'HTML vengono rimossi dalla descrizione del feed, quindi scrivi la prima frase come un riepilogo chiaro che funzioni anche senza formattazione.
### URL del feed
Il feed è disponibile all'indirizzo `/feed.xml` (o `/docs/feed.xml` se il tuo sito utilizza [hostAtDocs](/it/deploy/custom-domains)).
Il feed generato ha questo aspetto:
```xml
Acme Docs Changelog
https://docs.acme.com
Updates and changelog for Acme DocsMarch 2025 — New dashboard
https://docs.acme.com/changelog#march-2025
Sat, 15 Mar 2025 00:00:00 GMTAdded dark mode support across all themes.
```
### Integrazione con altri strumenti
Gli iscritti possono usare l'URL del feed con qualsiasi servizio compatibile con RSS:
- Slack: aggiungi l'[app RSS](https://slack.com/apps/A0F81R7U7-rss) `/feed` a un canale.
- Discord: usa [MonitoRSS](https://monitorss.xyz/) o un bot simile per pubblicare automaticamente gli aggiornamenti.
- Email: collega il feed a [Zapier](https://zapier.com/) o [IFTTT](https://ifttt.com/) per inviare email agli iscritti quando vengono aggiunte nuove voci.
- Browser: Safari, Vivaldi e Firefox (tramite estensioni) supportano nativamente gli RSS.
Puoi aggiungere `rss: true` a più pagine. Tutte le voci Update delle pagine abilitate per RSS vengono combinate in un unico `feed.xml` dell'intero sito.
## Best practice
Ogni etichetta crea un ID di ancoraggio, quindi usa etichette univoche per garantire collegamenti diretti corretti:
- Usa date specifiche: `January 10, 2025` (non solo `January 2025`)
- Includi i numeri di versione: `v2.1.0` rispetto a `v2.0.0`
- Le etichette duplicate creano ID duplicati, interrompendo la navigazione tramite ancoraggi
Scegli un formato e utilizzalo sempre:
- `January 10, 2025` (consigliato)
- `2025-01-10` (formato ISO)
- `v2.0.0` (per changelog basati sulle versioni)
Tag comuni con codifica automatica dei colori:
| Tag | Colore | Utilizzo |
|-----|-------|---------|
| `breaking` | Rosso | Modifiche incompatibili |
| `feature` / `new` | Verde | Nuove funzionalità |
| `deprecation` / `deprecated` | Ambra | Funzionalità deprecate |
| Altri tag | Grigio | Categorie generiche come `api`, `fix` |
- Inizia con la modifica più importante
- Usa elenchi puntati per più elementi
- Inserisci link alla documentazione dettagliata per le modifiche complesse
## Cosa fare dopo?
Consulta tutti i componenti disponibili
Scopri come usare i componenti in MDX