Discourse prend en charge l’importation de thèmes contenant des ressources depuis un dépôt distant.
Cela permet aux auteurs de thèmes de partager des polices et des images.
Créer un nouveau dépôt Git avec la police
mkdir discourse-roboto-theme
cd discourse-roboto-theme
git init .
vim about.json
Pour about.json, ajoutez un fichier de configuration squelette :
{
"name": "Composant de thème Roboto",
"about_url": "",
"license_url": "",
"assets": {
"roboto": "assets/roboto.woff2"
}
}
Ajoutez un fichier LICENSE. J’utilise généralement la licence MIT.
vim LICENSE
Télécharger la police
http://localfont.com/ est un site pratique pour obtenir des polices.
mkdir assets
cp ~/Downloads/roboto.woff2 roboto.woff2
Ajouter du CSS qui utilise le thème
mkdir common
cd common
Créez un fichier nommé common.scss avec :
@font-face {
font-family: Roboto;
src: url($roboto) format("woff2");
}
body {
font-family: Roboto;
}
Pousser les modifications vers GitHub
Validez toutes vos modifications :
git add LICENSE
git add about.json
git add assets/roboto.woff2
git add common/common.scss
git commit -am "first commit"
Créez un compte sur GitHub.com, puis créez un nouveau dépôt.
(Facultatif) Créer un sujet sur Discourse comme point de discussion pour vos couleurs
Idéalement, vous devriez créer un sujet dans la catégorie #plugin:theme avec quelques captures d’écran de votre palette de couleurs. Vous utiliserez cette URL comme about_url.
Remplir les informations manquantes dans votre fichier about.json
-
Accédez à votre page LICENSE sur GitHub et remplissez cette URL dans
license_url. -
Utilisez soit l’URL du projet GitHub, soit l’URL du sujet Discourse pour
about_url.
À la fin du processus, votre fichier about.json ressemblera à ceci :
{
"name": "Composant de thème Roboto",
"about_url": "https://github.com/SamSaffron/discourse-roboto-theme",
"license_url": "https://github.com/SamSaffron/discourse-roboto-theme/blob/master/LICENSE",
"assets": {
"roboto": "assets/roboto.woff2"
}
}
Validez la modification et poussez vers GitHub :
git commit -am "added more details"
git push
Tester votre composant de police
- Dans l’écran
admin/customize/theme, importez votre thème depuis GitHub.
Vous pouvez désormais partager facilement des polices !
Voir également :
Ce document est versionné – proposez des modifications sur GitHub.