Ottimizzazione SEO

Ottimizza la documentazione per i motori di ricerca e le anteprime social impostando titoli, descrizioni e metadati nel frontmatter.

Cosa fa Jamdesk automaticamente

Ottimizzazione dei contenuti

Scrivere un frontmatter efficace

---
title: User Authentication    # Under 60 characters
description: Set up OAuth, JWT, and session-based authentication  # 120-160 characters
---

Titoli delle pagine

• Mantienili sotto i 60 caratteri per evitare il troncamento nei risultati di ricerca
• Includi la parola chiave principale nelle prime posizioni
• Rendi ogni titolo univoco nella documentazione

Descrizioni

• Punta a 120-160 caratteri
• Riassumi ciò che il lettore imparerà
• Includi naturalmente le parole chiave pertinenti

Controllo dell'indicizzazione

Impostazioni dell'intero sito

Nel file docs.json, configura il comportamento predefinito dei robot:

{
  "seo": {
    "metatags": {
      "robots": "index, follow"
    }
  }
}

Controllo per pagina

Sovrascrivi l'indicizzazione per pagine specifiche nel frontmatter:

---
title: Internal Notes
noindex: true
---

Usa noindex per:

• Pagine in bozza o in corso di lavorazione
• Documentazione interna
• Contenuti obsoleti che vuoi conservare come riferimento

Indicizzazione nella ricerca e acquisizione da parte dell'AI

I metadati robots e noindex controllano i motori di ricerca: stabiliscono se una pagina appare su Google e nella tua sitemap.xml. Non hanno alcun effetto sui file llms.txt e llms-full.txt letti dagli strumenti AI. Per interromperne la pubblicazione, imposta seo.ai.llmsTxt su false (consulta Disattivare llms.txt). I due controlli sono indipendenti: una pagina può essere indicizzata dai motori di ricerca ma esclusa dall'acquisizione AI, o viceversa.

URL canonici

Se la documentazione è accessibile da più URL, imposta un URL canonico:

---
title: Getting Started
canonical: https://docs.example.com/getting-started
---

Puoi anche impostare una base canonica per l'intero sito in docs.json. Jamdesk aggiunge a questa base il percorso di ogni pagina, così ogni pagina riceve un URL canonico corretto:

{
  "seo": {
    "metatags": {
      "canonical": "https://docs.acme.com"
    }
  }
}

Anteprime social e Open Graph

Jamdesk genera automaticamente una card social brandizzata da 1200×630 per ogni pagina. Sovrascrivi qualsiasi tag social nel frontmatter. Puoi usare chiavi flat di primo livello oppure un blocco seo: nidificato. Entrambi funzionano e, quando la stessa chiave è impostata in entrambi i modi, prevale il valore flat di primo livello.

---
title: API Reference
description: REST API endpoints and authentication
"og:title": API Reference — Acme
"og:description": Everything you need to call the Acme API
"og:image": /images/api-social-card.png
"twitter:card": summary_large_image
"twitter:creator": "@acme"
keywords: ["api", "rest", "authentication"]
canonical: https://docs.acme.com/api-reference
---

---
title: API Reference
description: REST API endpoints and authentication
seo:
  "og:title": API Reference — Acme
  "og:image": /images/api-social-card.png
  "twitter:card": summary_large_image
  x-custom-tag: any custom meta value
---

Tag supportati

Tipo di card Twitter / X

Il tag twitter:card controlla il layout usato da X (e dalle altre piattaforme) quando il link viene condiviso:

Per una card brandizzata da 1200×630, usa summary_large_image affinché l'immagine venga visualizzata a tutta larghezza.

Immagine predefinita per l'intero sito

Imposta un'immagine social di fallback per ogni pagina in docs.json. Qualsiasi pagina che imposta il proprio og:image la sovrascrive:

{
  "seo": {
    "metatags": {
      "og:image": "https://docs.acme.com/images/default-card.png"
    }
  }
}

Sitemap e Robots.txt

Ogni sito Jamdesk genera automaticamente sitemap.xml e robots.txt a ogni build.

Dove trovarli

Gli URL dipendono dal fatto che la documentazione risieda in un dominio principale o in un sottopercorso /docs:

https://docs.acme.com/sitemap.xml
https://docs.acme.com/robots.txt

Cosa include la sitemap

• Tutte le pagine pubblicate (escluse quelle con frontmatter noindex o hidden)
• Date dell'ultima modifica dal frontmatter, quando disponibili
• Frequenza di modifica settimanale

Esclusione delle pagine dalla sitemap

Aggiungi noindex al frontmatter per escludere una pagina sia dalla sitemap sia dai motori di ricerca:

---
title: Internal Notes
noindex: true
---

Anche le pagine con hidden: true vengono escluse automaticamente.

Dati strutturati JSON-LD

Ogni pagina include automaticamente dati strutturati schema.org come tag <script type="application/ld+json"> con due schemi:

• WebSite: nome, URL e descrizione del sito (da docs.json).
• BreadcrumbList: percorso di navigazione dalla Home alla pagina corrente, derivato dalla configurazione navigation.

Non è necessaria alcuna configurazione. I motori di ricerca usano questi dati per risultati avanzati, come i percorsi breadcrumb nei risultati di ricerca.

IndexNow

Dopo ogni build, Jamdesk invia automaticamente gli URL delle pagine modificate a IndexNow per velocizzare l'indicizzazione nei motori di ricerca. In questo modo Bing, Yandex e gli altri motori di ricerca partecipanti vengono informati delle modifiche ai contenuti senza attendere il ciclo di scansione successivo.

• Viene eseguito dopo ogni build completata correttamente
• Invia solo le pagine effettivamente modificate
• Non blocca il processo, quindi non rallenta mai la build
• Non richiede alcuna configurazione

Procedure consigliate

Segui questa checklist prima della pubblicazione:

Articoli correlati