Thèmes : choisissez une apparence ou importez la vôtre.

1. 1Placez un fichier de thème sur votre téléphone. Son extension est .json et sa taille est inférieure à 64 KiB.
2. 2Dans Paramètres, ouvrez la carte Thème sous Apparence, appuyez sur Importer et choisissez le fichier.
3. 3Consultez l'aperçu. Il affiche les couleurs des deux moitiés, la forme, les couleurs du terminal et un rapport de contraste. Un contraste faible affiche un avertissement, et vous pouvez tout de même appliquer le thème. Un fichier qui enfreint les règles est refusé, et rien ne change.

Un thème modifie l'apparence de l'application et rien d'autre. Il ne peut pas exécuter de code, charger des fichiers ni contacter un serveur.

Un appareil conserve jusqu'à huit thèmes importés. Il n'existe pas d'importation depuis un lien, et les thèmes ne se synchronisent pas entre appareils.

{
  "version": 2,
  "id": "harbour",
  "name": "Harbour",
  "author": "Collie",
  "light": {
    "background": "oklch(0.95 0.01 235)",
    "foreground": "oklch(0.26 0.025 250)",
    "card": "oklch(0.985 0.004 235)",
    "...": "..."
  },
  "dark": {
    "background": "oklch(0.21 0.018 250)",
    "foreground": "oklch(0.93 0.012 240)",
    "card": "oklch(0.255 0.02 252)",
    "...": "..."
  },
  "fonts": { "ui": "atkinson", "display": "grotesk" },
  "surface": {
    "radius": "soft",
    "shadow": "lifted",
    "density": "default",
    "weight": "default",
    "border": "default",
    "ground": "grain",
    "chrome": "page",
    "rows": "rules",
    "icons": "thin",
    "labels": "caps"
  },
  "ansi": {
    "0": "#073642",
    "1": "#f0504a",
    "2": "#859900",
    "...": "..."
  }
}

Les 43 jetons

Un fichier de thème ne peut nommer que ces jetons, répartis en quatre groupes. Un fichier contenant toute autre clé est refusé.

Forme et apparence

Le bloc surface contient dix mots. Chacun provient d'une liste fermée, et un jeton omis conserve sa valeur par défaut, à savoir le premier mot de sa liste. Une valeur numérique libre n'est jamais acceptée, afin qu'un thème ne puisse pas altérer une taille de cible tactile.

radius

Le coin d'une carte, d'une ligne, d'un champ et d'un bouton.

• sharp
• soft
• round

shadow

L'ombre sous les panneaux surélevés.

• default
• flat
• lifted

density

L'espace présent à l'intérieur et entre les commandes.

• default
• roomy

weight

L'épaisseur de rendu du texte medium et semibold.

• default
• bold

border

L'épaisseur d'un filet.

• default
• strong

ground

La page sous l'ensemble des éléments : plate, un dégradé doux ou un grain fin.

• flat
• gradient
• grain

chrome

L'en-tête et les barres : sur la couleur de la page, ou sur leur propre bandeau.

• page
• band

rows

Une liste sous forme d'un groupe encadré unique avec des séparateurs, ou sous forme d'une carte pour chaque ligne.

• rules
• cards

icons

L'épaisseur de trait de chaque icône.

• default
• thin
• heavy

labels

Les petits libellés de section, en majuscules ou avec la casse de phrase.

• caps
• sentence

Palette de terminal

Le bloc ansi contient 18 couleurs ou aucune : les 16 couleurs du terminal, ink et ground. Chacune est sous la forme #rrggbb ou oklch(L C H), et chacune passe un contrôle de validation.

Valeurs

Une valeur est une couleur : #rrggbb, #rrggbbaa ou oklch(L C H), avec / A pour l'opacité. L va de 0 à 1, C de 0 à 0.5 et H de 0 à 360, tous sous forme de simples nombres.

Moitiés

Indiquez light, dark ou les deux. Une moitié que vous omettez est complétée depuis Collie, jeton par jeton.

Polices de caractères

La propriété optionnelle fonts.ui nomme l'une des polices intégrées à ColliePWA. La propriété optionnelle fonts.display en nomme une pour les titres. Aucune autre police n'est acceptée.

Ce qui est refusé

Une clé hors de la liste, une version autre que 1 ou 2, une valeur qui n'est ni une couleur ni un mot de forme, var(), url() ou toute autre fonction, l'identifiant d'un thème fourni et un fichier dépassant 64 KiB. Le message indique la cause, et rien n'est appliqué.

Version

version vaut 1 ou 2. Un fichier avec un bloc surface, une police fonts.display ou un bloc ansi indique 2. Un fichier de version 2 nécessite ColliePWA 1.22.0 ou une version plus récente.

L'exportation écrit le thème actif sous la forme d'un fichier .collie-theme.json. Envoyez-le à quelqu'un, ou conservez-le dans un dépôt, et la personne l'importe de la même manière que vous.

Détails dans Thèmes