Ce tutoriel vous explique comment utiliser la Theme CLI avec notre site Theme Creator pour développer un thème et prévisualiser vos modifications sur un site Discourse en direct.
-
Inscrivez-vous sur Meta si ce n’est pas déjà fait.
-
Installez la Theme CLI en suivant les instructions ici
-
Créez un nouveau thème sur Theme Creator en :
- Visitant https://discourse.theme-creator.io/my/themes
- Cliquant sur Install, et en sélectionnant l’option “Create New”.
- Donnant un nom unique à votre thème (vous pouvez ignorer le schéma de couleurs pour l’instant).
-
Cliquez sur advanced, puis edit locally, et retrieve API key.
Copiez la clé API qui est générée.
-
Retournez à votre ligne de commande et tapez
discourse_theme download example-folder, où example-folder est l’endroit où votre thème sera stocké localement. Suivez les instructions.-
Entrez
https://discourse.theme-creator.iocomme URL racine de votre site Discourse. -
Entrez votre clé API de l’étape précédente lorsqu’on vous le demande.
-
Continuez à suivre les instructions et sélectionnez le thème que vous avez créé à l’étape 4.
-
Entrez oui lorsque l’on vous demande si vous souhaitez commencer à surveiller votre thème.
-
-
Maintenant, votre dossier de thème local est surveillé pour les changements, qui seront automatiquement téléchargés vers Theme Creator. Vous pouvez ouvrir un aperçu de votre thème en cliquant sur preview dans les paramètres de votre thème sur Theme Creator.
-
Pour arrêter la surveillance des changements, appuyez sur ctrl + c dans votre fenêtre de ligne de commande. Pour recommencer à surveiller les changements, tapez
discourse_theme watch example-theme.
Vous avez maintenant un répertoire de thème local que vous pouvez modifier et voir vos changements en direct !
Pour un aperçu approfondi de la structure des thèmes et de ce que vous pouvez faire, consultez notre Developing Discourse Themes & Theme Components
Ce document est contrôlé par version - suggérez des modifications sur github.