Scrivere articoli del blog

Installazione e configurazione

Prima di qualsiasi passaggio, leggere Prima di iniziare e Nozioni di base sui terminali. 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.