Skip to content

Thèmes d’organisation ​

Quand votre organisation publie ses thèmes sur le portail, l’extension les récupère, les vérifie et les installe une fois pour tout VS Code : toute présentation, quel que soit son dossier (ou hors de tout dossier), peut les utiliser avec theme: Nom.

Se connecter ​

  1. DWA : se connecter au portail et saisir l’adresse du portail (proposée par le paramètre dwa.hub.portal).
  2. Le navigateur s’ouvre ; VS Code affiche un code.
  3. Se connecter sur le portail (code reçu par email ou SSO), comparer le code avec celui de VS Code, puis autoriser.

Une seule connexion par portail suffit : elle donne accès aux thèmes de toutes vos organisations, sans étape supplémentaire. Le jeton est chiffré par VS Code (stockage secret du système) et réutilisé ; il ne passe jamais dans une URL et le portail n’en garde que l’empreinte SHA-256. Plusieurs portails sont possibles. En WSL, la connexion passe par le navigateur et un polling HTTPS, sans callback local.

Choisir un thème ​

DWA : choisir un thème d’organisation liste les thèmes de toutes vos organisations. Le choix :

  • télécharge la version et vérifie l’organisation, le nom, la version et l’empreinte SHA-256 du CSS ;
  • applique le validateur des thèmes et signale les erreurs éventuelles ;
  • installe le thème dans le stockage global de l’extension : une version active par thème, commune à tout VS Code ;
  • écrit theme: Nom (et marp: true) dans le frontmatter de la présentation ouverte, sans toucher aux autres clés.

Aucun fichier n’est écrit dans vos projets pour le thème : plus de .dwa-theme.json ni de .dwa/themes/.

Comment Marp trouve les thèmes ​

Marp for VS Code n’accepte que des URL ou des chemins internes au dossier ouvert. L’extension sert donc les thèmes installés sur http://127.0.0.1:<port>/dwa-themes/… (seuls les accès à 127.0.0.1 sont acceptés) et déclare ces URL dans vos réglages utilisateurmarkdown.marp.themes, en conservant vos autres entrées. Si un projet déclare ses propres thèmes Marp (ce qui masque la liste utilisateur), les URL y sont ajoutées. Plusieurs fenêtres VS Code partagent le même serveur. Les fonctions DWA (débordements, callouts, PPTX) lisent directement le fichier installé.

Mises à jour discrètes ​

À l’ouverture d’une présentation qui utilise un thème installé (au plus une fois par heure et par thème), l’extension compare l’empreinte installée à celle de la dernière version publiée. Si elle diffère, une notification propose :

  • Mettre à jour : installe la nouvelle version (avertissement en cas de changement de version majeure) ;
  • Ne plus afficher : plus de notification pour ce thème.

Rien n’est mis à jour sans votre accord. DWA : vérifier les mises à jour des thèmes vérifie tous les thèmes installés à la demande.

Le paramètre dwa.themes.updateNotifications vaut notify par défaut ; silent coupe toutes les notifications de thèmes, l’état restant visible dans la barre d’état.

Versions retirées, thèmes supprimés, accès perdu ​

SituationCe que propose l’extension
Version retirée par l’organisationPasser à la dernière version publiée
Thème suppriméUtiliser le thème de remplacement, si l’organisation en a désigné un
Accès retiréMessage ; aucune nouvelle version possible
Portail injoignableRien : nouvel essai plus tard

Dans tous les cas, la copie installée reste utilisable.

Barre d’état ​

La barre d’état affiche le thème et la version de la présentation, les erreurs Core v1 éventuelles et la mise à jour disponible. Un clic ouvre les actions : mettre à jour, vérifier, contrôler le thème, ouvrir le portail (DWA : état du thème de la présentation).

Contrôle de tout thème utilisé ​

Tout thème utilisé, du portail ou local, passe par le même validateur que le portail (étapes 1 à 4, sans navigateur) : résultats dans Problèmes, sur le fichier CSS avec la ligne, et dans la barre d’état. DWA : contrôler le thème (Core v1) relance le contrôle ; un CSS déclarant @dwa-language est recontrôlé à chaque enregistrement.

Se déconnecter ​

DWA : se déconnecter du portail révoque la session distante puis efface le secret local. Une session peut aussi être révoquée depuis le portail (Paramètres du compte). Les thèmes installés restent utilisables hors ligne.

Hors ligne et révocation ​

Les copies déjà installées restent utilisables hors ligne, même après une révocation ou un retrait côté serveur. Le portail contrôle les nouveaux téléchargements ; il ne supprime pas les fichiers à distance. Les autorisations sont un contrôle de distribution, pas un dispositif de protection des copies.

Vos présentations ne sont jamais envoyées au portail.

Documentation du langage DWA Core v1, de l’extension VS Code, du CLI et du portail des thèmes.