> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Scrivere articoli del blog

Pubblica articoli locali e tipizzati con categorie e link alle guide funzionanti.

## Installazione e configurazione

Prima di qualsiasi passaggio, leggere [Prima di iniziare](https://supastack.dev/it/docs/web/before-you-start.md) e [Nozioni di base sui terminali](https://supastack.dev/it/docs/web/terminal-basics.md). Queste istruzioni presuppongono che tu abbia aperto l'intero supastack monorepo in VS Code; la sua radice package.json contrassegna la radice del repository. Nei comandi pnpm, un pacchetto dell'area di lavoro è un'app o una cartella di codice condiviso; nel prodotto, uno spazio di lavoro è il contenitore dei dati di un team e il limite di sicurezza. corepack pnpm --filter ... seleziona un pacchetto dal monorepo mentre i comandi vengono eseguiti dalla sua radice. Se hai aperto solo una cartella mobile o desktop sincronizzata, non contiene il backend Web, la configurazione di Docker o gli script root: esegui il backend da questo monorepo o da un server ospitato raggiungibile e utilizza gli script della cartella della piattaforma. Una variabile di ambiente è un'impostazione denominata memorizzata in un file .env locale o nel dashboard dell'hosting; riavvia l'app pertinente dopo averla modificata e mantieni i segreti del server fuori dai valori NEXT_PUBLIC_ e EXPO_PUBLIC_.

1. In VS Code apri apps/web/src/resources/content.ts e copia un articolo completo nelle vicinanze come punto di partenza; la copia dell'articolo risiede nel repository, non in un dashboard di pubblicazione.

2. Assegna all'articolo un nuovo slug, titolo, categoria, data, sezioni e uno slug guida esistente.

3. Dalla root del repository esegui corepack pnpm --filter @supastack/web dev e apri http://localhost:3000/blog/<your-slug>. Previsto: l'articolo e il relativo collegamento alla guida correlata vengono caricati localmente prima di condividere URL.

Il contenuto del blog è archiviato in src/resources/content.ts e blog-posts.ts. Si tratta di contenuti gestiti dal repository; non esiste un servizio di pubblicazione CMS. Ogni post necessita di uno slug, titolo, descrizione, categoria, data, guida correlata e sezioni univoci.

```
{
  slug: 'your-article',
  title: 'A specific reader question',
  category: 'Guides',
  date: '2026-09-07',
  guide: 'web/local-setup',
  sections: [{ id: 'start', title: 'Start here', paragraphs: ['Your original text.'] }]
}
```


## Comandi da copiare

Segui i commenti per vedere in quale cartella viene eseguito un comando. Se due terminali sono etichettati, apri due finestre di terminale e mantieni il primo comando in esecuzione mentre usi il secondo.

```
corepack pnpm --filter @supastack/web dev

# Replace <your-slug> with the article slug:
# http://localhost:3000/blog/<your-slug>
corepack pnpm test -- apps/web/src/resources/content.test.ts
```


## Flusso di implementazione

Segui un oggetto Post esistente completo per i campi tipizzati rimanenti. Mantieni lo slug stabile dopo la pubblicazione così gli URL condivisi continuano a funzionare. I titoli hanno bisogno di ID di sezione unici per l'indice e i link di ancoraggio.

Le categorie derivano dal catalogo degli articoli. L'indice usa filtraggio via URL e le route degli articoli generano i loro metadati dal contenuto. Il valore guide deve corrispondere a uno slug di documentazione esistente; il contenuto correlato dovrebbe condurre a un prossimo passo utile.


## Verifica e risoluzione dei problemi

Se l'articolo restituisce 404, controlla che il suo slug sia univoco e che sia stato aggiunto all'elenco degli articoli in apps/web/src/resources/content.ts. Se il sommario non salta da nessuna parte, assegna a ogni sezione un ID univoco. Esegui corepack pnpm test -- apps/web/src/resources/content.test.ts dalla radice per visualizzare gli errori di convalida del contenuto.

Esegui i test dei contenuti, apri la route dell'articolo, segui la sua guida correlata e controlla l'indice filtrato. Verifica date e affermazioni contro le fonti. Non pubblicare link placeholder e non affermare che un'integrazione è stata verificata solo perché appare in un articolo.


## Successivo

[Documentazione del prodotto](https://supastack.dev/it/docs/web/docs-site.md)