Temi

Un tema è l'aspetto del sito di un'organizzazione. Come partner lo crei, ne pubblichi le versioni e decidi a chi renderlo disponibile.

Lo sviluppo avviene in locale: vedi Creare e sviluppare un tema. Qui gestisci creazione, copertina e distribuzione.

Creare un tema

Da Temi > Aggiungi tema inserisci:

• il nome mostrato alle organizzazioni;
• l'identificativo, che finisce nel manifest.json del tema.

L'identificativo è definitivo: Riseact lo usa per riconoscere le versioni del tema. Non si può cambiare: un identificativo diverso è un tema diverso, e chi ha installato il primo non riceverebbe più aggiornamenti.

Il passaggio è facoltativo: il primo riseact theme release crea il tema con l'identificativo del manifest. Crearlo qui serve a prenotare l'identificativo.

Pubblicare una versione

Dalla CLI:

riseact theme release

Dal pannello, con Azioni > Upload theme as ZIP: carichi l'archivio, preparato con riseact theme package, e descrivi le modifiche.

La versione si legge dal manifest.json e deve essere superiore alla precedente. Se un file non è valido la pubblicazione viene rifiutata, con l'elenco di tutti i problemi trovati.

Le organizzazioni leggono la descrizione delle modifiche prima di decidere se aggiornare.

Chi vede il tema

Nella pagina del tema, il riquadro Visibilità offre due scelte:

• Non condiviso: puoi installarlo solo sulle organizzazioni su cui stai sviluppando.
• Le mie organizzazioni: le organizzazioni che amministri lo trovano in Sito web > Store dei temi e possono installarlo, senza approvazione. È la via più diretta per consegnare un tema su misura.

Installare un tema non lo pubblica: entra nella libreria dell'organizzazione, che decide quando attivarlo.

Pubblicare sullo store

Sullo store dei temi il tema è visibile a tutte le organizzazioni Riseact, previa approvazione. Serve almeno una versione pubblicata.

1. Carica l'immagine di copertina dalla pagina del tema: appare sulla scheda dello store, meglio uno screenshot largo della homepage.
2. Premi Invia per l'approvazione. Puoi allegare un messaggio: la cosa più utile è un indirizzo dove vedere il tema all'opera. La risposta arriva per email.

Aggiornamenti e personalizzazioni

Quando pubblichi una nuova versione, le organizzazioni che hanno il tema decidono se aggiornare. L'aggiornamento sostituisce il codice del tema ma non le loro scelte: colori, testi e composizione delle pagine restano.

Cosa viene sostituito e cosa conservato è spiegato nella guida allo sviluppo dei temi.

Fonte: https://dev.riseact.org/docs/partner-area/themes. Copia automatica da dev.riseact.org: non modificare qui, le modifiche vanno fatte sulla documentazione Docusaurus.