Développeurs

La Zone choisit la mise en page, la plateforme fournit les données et les règles.

Une Zone est le site propre à une communauté et peut inclure son propre code de présentation. Ce code ne gère que la mise en page. La plateforme prépare les données et conserve la gestion des autorisations et des examens.

Thème

Réglez le thème avant de coder.

Chaque Zone part d’un thème prédéfini. Réglez la densité, la couleur de fond des pages et les proportions des couvertures, choisissez votre couleur d’accent si besoin, puis agencez les modules À la une, étagères, classements et sélections de la rédaction. Le code de présentation ne devient nécessaire que pour les mises en page impossibles à obtenir avec ces réglages.

Une feuille bleu gris foncé est pliée en petit cadre vertical avec une fenêtre, devant une feuille bleu clair.

Réglages

Exemple de réglages de thème

const tokens: ZoneTokens = {
  colorScheme: 'system',
  accent: '#3b4a5a',
  density: 'comfortable',
  cardRadius: 'md',
  headingFontScale: 'md',
  surfaceTint: 'subtle',
  fontPairing: 'serif',
  pageSurface: 'flat',
  coverStyle: 'portrait',
};
Tous les champs obligatoires du thème, typés par @rezics/zone-sdk.

Emplacements

Le code remplit des emplacements nommés

Le code de présentation est un paquet qui remplace les composants dans des emplacements nommés : en-tête, espace à la une, barre de recherche, panneau de données, fiche d’œuvre, modules et pied de page. Chaque emplacement reçoit le composant de la plateforme, que le paquet peut envelopper ou remplacer.

export default defineZonePackage({
  slug: 'anime',
  css,
  catalogue: { count: 'episodes',
    formatNames: animeFormatNames
  },
  slots: {
    browseHeader:
      AnimeBrowseHeader,
    workCard: AnimeCard,
    cataloguePanel:
      AnimeCataloguePanel,
    footer: AnimeFooter,
  },
});
Extrait inchangé du point d’entrée du paquet de la Zone d’animation REZICS.

Limites

Limites des paquets

  • Aucun accès direct aux données

    La plateforme charge les données et les transmet aux emplacements. Le paquet n’effectue aucune requête.

  • Aucun accès aux identifiants

    Le paquet ne lit ni les cookies, ni le stockage du navigateur, ni les identifiants.

  • Ne masque pas l’interface de la plateforme

    Le menu du compte, le menu de la Zone, les signalements et la vérification de l’âge restent hors des emplacements. L’indication « Pourquoi cette œuvre ? » reste visible sur chaque œuvre.

  • Styles limités à la Zone

    Les styles restent limités à cette Zone. Les couleurs et polices utilisent uniquement les variables fournies par la plateforme.

  • Taille limitée

    Après compression gzip, le CSS ne dépasse pas 40 Kio et le JavaScript 50 Kio.

Mise en ligne

De l’examen à la mise en ligne

  • Calculer l’empreinte

    Une empreinte est calculée à partir de tous les fichiers du paquet. La modification d’un seul octet la change.

  • Faire examiner par une autre personne

    Un autre compte examine le code source, les fichiers générés, l’accessibilité et le comportement en cas d’erreur. Il consigne sa décision et l’empreinte des preuves.

  • Activer avec une date d’expiration

    Seules les versions examinées peuvent être activées, et leur activation expire. Revenir à une ancienne version ne réactive pas son ancienne approbation.

  • Revenir à la mise en page standard

    Si l’empreinte ne correspond pas, la mise en page standard s’affiche. Les lecteurs peuvent désactiver le paquet en ajoutant ?safe à l’adresse. La plateforme dispose aussi d’un interrupteur général.

Un seul système en arrière-plan, votre présentation en façade ; les agents IA peuvent accéder aux mêmes données.

Un nouveau site communautaire n’a pas besoin d’un nouveau programme serveur. Le code de présentation lit uniquement les API publiques et ne contient aucune logique métier. Toutes les données affichées dans une Zone sont également accessibles par API.

Créez vos propres outils avec la même API.

Permettez à vos applications de lire et modifier les œuvres, les bibliothèques et les données des communautés. Chaque opération suit les règles d’identité et d’autorisation de REZICS.