MeshCore ITA — Blog: Contribuirehttps://meshcore-ita.github.io/blog/tag/contribuire/2026-09-27T00:00:00ZMeshCore ITAhttps://meshcore-ita.github.io/blog/come-scrivere-un-post/Come scrivere un post per il blog di MeshCore ITA2026-09-13T00:00:00Z2026-09-27T00:00:00ZDove sta il file, quali chiavi meta servono e come pubblicare un nuovo post nel blog.<section class="section">
<p class="post-meta"><time datetime="2026-09-13">13 settembre 2026</time> · aggiornato il 27 settembre 2026 · <span class="post-meta__author">MeshCore ITA</span> · 3 min di lettura</p>
<ul class="tags"><li class="tag"><a class="tag__link" href="../../blog/tag/contribuire/">Contribuire</a></li></ul>
<div class="prose">
<h2 id="dove-sta-il-file">Dove sta il file</h2>
<p>Ogni post del blog è un file markdown dentro
<code>content/blog/</code>. Il nome del file diventa l'URL del post: un file
<code>content/blog/mio-post.md</code> finisce pubblicato su <code>/blog/mio-post/</code>.</p>
<p>Per scriverne uno nuovo:</p>
<ol>
<li>Crea un file <code>content/blog/<slug>.md</code>, dove <code><slug></code> è il nome che
vuoi dare al post (minuscolo, parole separate da trattino).</li>
<li>Il file inizia con un blocco di meta dati, poi il corpo in markdown.</li>
<li>Rigenera il sito e committa l'output.</li>
</ol>
<h2 id="il-blocco-meta">Il blocco meta</h2>
<p>Come per le pagine di documentazione, il file inizia con un commento
<code><!--meta { ... } --></code> contenente un oggetto JSON. Per un post servono
queste chiavi:</p>
<ul>
<li><code>slug</code>: <strong>deve essere identico al nome del file</strong>, senza estensione. Se
il file è <code>come-scrivere-un-post.md</code>, <code>slug</code> deve valere
<code>"come-scrivere-un-post"</code>.</li>
<li><code>title</code>: titolo per il tag <code><title></code> e per i motori di ricerca.</li>
<li><code>description</code>: riassunto breve, usato come meta description.</li>
<li><code>h1</code>: titolo mostrato in cima al post.</li>
<li><code>lede</code>: sottotitolo/riassunto mostrato sotto l'<code>h1</code> e nella lista dei
post.</li>
<li><code>published</code>: data di pubblicazione, formato <code>AAAA-MM-GG</code>.</li>
</ul>
<p>Sono opzionali:</p>
<ul>
<li><code>updated</code>: data di ultimo aggiornamento, se diversa da <code>published</code>.</li>
<li><code>time</code>: ora di pubblicazione in formato <code>"HH:MM"</code>, ora italiana
(es. <code>"18:30"</code>). Serve quando esce più di un post nello stesso giorno:
in quel caso va messa in tutti, e decide quale compare per primo.</li>
<li><code>author</code>: di default è <code>"MeshCore ITA"</code>.</li>
<li><code>tags</code>: un array di slug scelti tra quelli definiti in
<code>content/blog/tags.json</code> (vedi sezione "I tag" più sotto).</li>
</ul>
<h2 id="i-tag">I tag</h2>
<p>Ogni voce di <code>tags</code> deve essere uno slug già presente in
<code>content/blog/tags.json</code>: un tag non registrato fa fallire la build. Gli
slug attuali sono: <code>antenne</code>, <code>autocostruzione</code>, <code>software</code>, <code>community</code>,
<code>risorse</code>, <code>sito</code>, <code>contribuire</code>.</p>
<p>Per ogni tag usato da almeno un post la build genera una pagina
<code>/blog/tag/<slug>/</code> (con paginazione e feed Atom propri), usando <code>label</code>
e <code>description</code> del registro come titolo e testo introduttivo.</p>
<p>Per aggiungere un tag nuovo: aggiungi una voce a <code>tags.json</code> con <code>label</code>
e <code>description</code>, poi usane lo slug nell'array <code>tags</code> del post.</p>
<h2 id="il-corpo">Il corpo</h2>
<p>Dopo il blocco meta, il resto del file è markdown normale (GFM: titoli,
liste, tabelle, link, blocchi di codice, grassetto/corsivo). Niente HTML
grezzo: il markdown viene convertito automaticamente in HTML dalla build,
seguendo lo stile del sito.</p>
<p>Usa <code>##</code> per i titoli di sezione (l'<code>h1</code> lo genera già il layout dal campo
<code>h1</code> del meta). Mantieni lo stesso registro delle altre pagine del sito:
italiano tecnico, diretto, frasi brevi, niente marketing.</p>
<h2 id="pubblicare-il-post">Pubblicare il post</h2>
<p>Dopo aver scritto il file:</p>
<pre><code class="language-sh">node build.mjs # rigenera il sito, incluso /blog/ e il feed
node build.mjs --check # deve uscire 0: è lo stesso gate della CI
</code></pre>
<p>Committa sia il file sorgente in <code>content/blog/</code> sia tutti i file generati
che cambiano (<code>blog/</code>, <code>feed.xml</code>, <code>search-index.json</code> e l'eventuale
sitemap). La CI esegue <code>node build.mjs --check</code> su ogni pull request e la
rifiuta se i file generati non corrispondono ai sorgenti.</p>
<p>Se preferisci non usare la riga di comando, il link <strong>"Modifica questa
pagina su GitHub"</strong> in fondo a ogni pagina apre comunque l'editor web e
produce una pull request: in quel caso è chi revisiona la PR a rigenerare
e verificare i file di output.</p>
</div>
</section>