Scrivere articoli e organizzare raccolte

Shayan TaslimAggiornato

Il Centro assistenza organizza gli articoli all’interno di raccolte e offre al tuo team un editor rich text con collegamenti interni, cronologia delle revisioni e controlli di visibilità.

Organizzare le raccolte

Apri Centro assistenza → Articoli nella barra laterale della dashboard per gestire la struttura di navigazione.

  • Crea una raccolta. Fai clic su Nuova raccolta nella barra superiore, inserisci un Nome (fino a 255 caratteri; mentre scrivi, UserJot suggerisce automaticamente un'icona, finché non ne scegli una manualmente), seleziona un'Icona e fai clic su Crea. Le nuove raccolte vengono visualizzate in fondo al livello superiore.

  • Modifica una raccolta. Fai clic con il pulsante destro del mouse su una raccolta e seleziona Modifica… per aggiornarne l’icona, il nome o la Descrizione (fino a 500 caratteri).

  • Annida e riordina. Trascina e rilascia le raccolte e gli articoli nell’albero per riordinarli o annidarli, oppure fai clic con il pulsante destro del mouse e scegli Sposta in. Le raccolte possono essere annidate fino a tre livelli di profondità.

  • Articoli al livello superiore e non posizionati. Gli articoli posizionati al Livello superiore vengono visualizzati fuori da qualsiasi raccolta e possono avere un’icona personalizzata (clic destro → Cambia icona…). Facendo clic su Nuovo articolo nella barra superiore, viene creata una bozza non posizionata sotto Nessuna raccolta. Gli articoli non posizionati non vengono elencati né inclusi nei risultati di ricerca finché non li sposti al Livello superiore o all’interno di una raccolta.

  • Elimina una raccolta. Fai clic con il pulsante destro del mouse su una raccolta e seleziona Elimina…. Le raccolte vengono eliminate definitivamente, senza passare dal cestino. Se la raccolta contiene articoli, scegli Sposta gli articoli in un’altra raccolta, al Livello superiore o in Nessuna raccolta (spostandoli in un’altra raccolta, i vecchi URL della raccolta eliminata reindirizzeranno lì).

Scrivere con l’editor

Ogni articolo ha un Titolo obbligatorio (fino a 255 caratteri), una Descrizione facoltativa (fino a 500 caratteri, utilizzata nelle schede e come meta descrizione) e un editor per il corpo del testo.

Premi / su una nuova riga per inserire blocchi:

  • Testo, Titolo (H2) e Sottotitolo (H3). I titoli generano automaticamente ancoraggi di sezione stabili.

  • Elenco puntato, Elenco numerato, Citazione, Blocco di codice (con selettore del linguaggio) e Separatore.

  • Immagine (carica file dal computer; fai clic su un'immagine per aggiungere il Testo alternativo o una Didascalia, ciascuno fino a 500 caratteri).

  • Tabella (inizialmente una tabella 3x3 con una riga di intestazione e controlli mobili per righe e colonne).

  • Riquadri informativi Nota, Suggerimento e Avviso, oltre a blocchi A fisarmonica comprimibili (titoli da 1 a 200 caratteri). Nell'editor della dashboard, i riquadri informativi e i blocchi a fisarmonica non possono essere annidati l'uno nell'altro (tramite API o importazione HTML, un riquadro informativo può essere inserito in un blocco a fisarmonica, mentre non sono consentiti un riquadro informativo dentro un altro riquadro informativo, un blocco a fisarmonica dentro un riquadro informativo e un blocco a fisarmonica dentro un altro blocco a fisarmonica).

  • Incorpora Video da YouTube, Loom o Vimeo (oppure incolla un link diretto a uno di questi servizi su una riga a sé).

Seleziona il testo per applicare Grassetto, Corsivo, Barrato, Codice, Tasto (formattazione per i tasti di scelta rapida) o dei link. Codice e Tasto non possono essere combinati con altre formattazioni in linea, e il testo Tasto non può contenere < o >. I documenti supportano fino a 1 MB di JSON, 512 KB di Markdown, 5.000 nodi e 32 livelli di annidamento dei blocchi.

Le bozze vengono salvate automaticamente mentre scrivi. Premi ⌘S / Ctrl+S per salvare manualmente, premi ⌘⇧\ / Ctrl+Shift+\ per mostrare o nascondere il pannello laterale dell'elenco degli articoli, attiva o disattiva Anteprima nell'angolo in basso a destra per controllare la visualizzazione per i lettori, oppure fai clic sul controllo Suono di digitazione in basso a sinistra per scegliere i suoni opzionali dei tasti meccanici (Alpaca, Cream, Mint, Mochi, Frost o Disattivato) e regolarne il volume.

Dialetto Markdown del Centro assistenza

L'API REST, il server MCP, Copia pagina e gli endpoint .md utilizzano Markdown in stile GitHub, con le seguenti estensioni:

  • Blocchi informativi <Note>, <Tip> e <Warning>

  • Sezioni comprimibili <Accordion title="...">

  • {#custom-id} alla fine di un'intestazione per fissare un'ancora stabile

  • <kbd>...</kbd> per i tasti della tastiera in linea

  • Link interni scritti come /articles/<slug> o /collections/<slug> (con #heading facoltativo)

Fai clic sul pulsante dei link nella barra degli strumenti di selezione per aprire Aggiungi link. Cerca nel Centro assistenza articoli, raccolte e intestazioni di articoli pubblicati (la ricerca delle intestazioni richiede almeno 2 caratteri e restituisce fino a 8 risultati) oppure incolla un URL esterno https://. Se incolli l'URL di uno dei tuoi articoli del Centro assistenza, verrà trasformato in un riferimento interno, che continuerà a funzionare anche se cambia lo slug dell'articolo di destinazione.

Se in seguito l’elemento collegato viene rimosso dalla pubblicazione, spostato nel cestino o eliminato, l’editor evidenzia il link in linea per consentirti di correggerlo. L’elenco Collegato da nella barra laterale Articolo a destra mostra fino a otto articoli pubblicati che rimandano all’articolo corrente.

Apri la barra laterale Articolo a destra per configurare come i lettori trovano un articolo:

Impostazione

Funzione

Visibilità

Scegli Pubblico (visibile negli elenchi, nei risultati di ricerca, incluso in llms.txt e in Juno), Non in elenco (accessibile solo tramite link diretto; nascosto dalla navigazione, dalla ricerca e da Juno) oppure Team (solo amministratori interni e proprietari che hanno effettuato l’accesso).

Raccolta

Posiziona l’articolo al Livello superiore, all’interno di una raccolta oppure lascialo in Nessuna raccolta.

Link

Fai clic su /help/articles/<slug> per aprire Cambia link (lettere minuscole, numeri e trattini, fino a 60 caratteri). Prima della prima pubblicazione, lo slug segue il titolo finché non lo modifichi manualmente. Dopo la pubblicazione, se cambi lo slug viene creato automaticamente un reindirizzamento dal vecchio URL.

Mostra nei motori di ricerca

Consenti o blocca l'indicizzazione di questo articolo da parte dei motori di ricerca. Per essere indicizzato, l'articolo deve anche essere pubblico e inserito in una raccolta, e il Centro assistenza deve essere impostato su Attivo.

Parole chiave

Aggiungi parole chiave nascoste per la ricerca nella lingua corrente (fino a 50 parole chiave, di 64 caratteri ciascuna). Premi Invio o virgola per aggiungere ogni termine.

Puoi anche assegnare un Autore (o selezionare Nessun autore) dalla scheda dello stato in cima alla barra laterale destra.

Pubblicazione, cronologia e cestino

  • Pubblica. Fai clic su Pubblica (o Pubblica modifiche, scorciatoia ⌘↵). Prima della pubblicazione, un popover segnala l’eventuale testo alternativo mancante nelle immagini o i link interni non funzionanti. Quando aggiorni un articolo pubblicato, disattiva Mostra come aggiornato per le piccole correzioni di refusi, così la data di aggiornamento pubblica rimane invariata.

  • Annulla la pubblicazione. Apri Altre azioni (⋮) → Annulla pubblicazione per rimuovere dalla pubblicazione la lingua corrente, mantenendone la bozza e la cronologia delle revisioni.

  • Cronologia delle revisioni. Seleziona una voce qualsiasi in Cronologia nel pannello laterale destro per visualizzarla in sola lettura (premi Esc per uscire dall'anteprima), quindi fai clic su Ripristina questa versione per copiarla nuovamente nella bozza (resterà non pubblicata finché non farai clic su Pubblica modifiche).

  • Confronta le traduzioni. Quando modifichi un articolo tradotto, attiva Confronta nella barra superiore (sugli schermi ampi) per visualizzare fianco a fianco l’originale pubblicato e le modifiche, con i blocchi aggiunti e rimossi evidenziati.

  • Sposta nel cestino e ripristina. Apri Altre azioni (⋮) → Sposta nel cestino per rimuovere subito un articolo. Gli articoli nel cestino possono essere ripristinati per 30 giorni (con slug e reindirizzamenti riservati), prima di essere eliminati definitivamente. Aprendo un articolo nel cestino viene visualizzato il pulsante Ripristina dal cestino.

Passaggi successivi

Ha risposto alla tua domanda?