Comment fonctionne Atlas

Organisations, sites, environnements, contrat de site, publication et diffusion en une seule page.

Cette page a été traduite de l'anglais. En cas de divergence, la version anglaise fait foi. Lire en anglais

Les éléments de base

Concept	Définition
Organisation	Votre entreprise. Elle possède des sites, des personnes et son offre.
Site	Un site web. Le contenu, les médias, les accès des personnes et les paramètres ne sont jamais partagés entre sites.
Environnement	Chaque site dispose d’un environnement Development et d’un environnement Production. Vous travaillez dans Development ; Production ne sert qu’une release approuvée.
Contrat de site	Une description JSON de votre site web : ses composants et leurs champs typés, ses types de pages, ses collections, ses éléments globaux (en-tête et pied de page), ses profils de médias et ses design tokens.
Page	Une route de votre site web (par exemple `/about`), composée de sections. Chaque section est l’un des composants de votre contrat, avec les valeurs de ses champs.
Entrée	Un élément d’une collection, tel qu’un produit ou un article d’actualité.
Élément global	Contenu partagé entre les pages, comme l’en-tête et le pied de page du site.
Jeton de diffusion	Un jeton réservé au serveur que votre site web utilise pour lire le contenu publié d’un environnement.

Comment le contenu atteint votre site web

 Editor in Studio ──draft──▶ Atlas (Development) ──publish──▶ published revision
                                                                     │
                       your website server ◀── Delivery API (HTTPS, delivery token)
                               │
                       your components render it ──▶ visitors

Vos développeurs décrivent le site web dans le contrat de site. Un administrateur du site l’active dans Studio.
Les éditeurs créent et modifient les pages et les entrées sous forme de brouillons. Les brouillons n’apparaissent jamais sur le site web public.
Les éditeurs prévisualisent un brouillon dans le design réel de votre site web, puis le publient. Chaque publication est une révision immuable, ce qui permet de revenir en arrière.
Votre site web lit le contenu publié depuis l’API Delivery avec son jeton de diffusion, uniquement depuis du code serveur.
Atlas envoie un webhook signé à chaque publication, afin que votre site web ne rafraîchisse que les pages concernées.

Development et Production

Chaque nouveau site démarre dans Development. Le contenu y est modifié et publié.
Production est désactivé tant qu’un administrateur du site ne l’active pas, après qu’une release a passé toutes les vérifications et qu’une personne disposant des droits d’approbation l’a approuvée.
Production ne sert que sa release live et signée : un instantané figé du contenu approuvé. Modifier Development ne change jamais Production avant la prochaine release approuvée.
Changer d’environnement dans Studio modifie uniquement ce que vous consultez. Cela ne change jamais le contenu.

Pour en savoir plus : Development et Production.

Ce que votre site web doit faire

Atlas ne s’exécute pas sur votre site web. Vos développeurs ajoutent une petite quantité de code :

un client réservé au serveur pour l’API Delivery ;
le rendu des sections via vos composants existants ;
un contenu de repli : si Atlas est injoignable ou n’a rien de publié pour une page, le site sert son contenu intégré ;
une route d’aperçu des brouillons, un récepteur de webhook et un rapport de build.

Le guide de connexion détaille chacun de ces points.