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
- DWA : se connecter au portail et saisir l’adresse du portail (proposée par le paramètre
dwa.hub.portal). - Le navigateur s’ouvre ; VS Code affiche un code.
- 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(etmarp: 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
| Situation | Ce que propose l’extension |
|---|---|
| Version retirée par l’organisation | Passer à 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 injoignable | Rien : 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.