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 de base
{
"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 le 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;
}
Publier les modifications sur 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 "premier commit"
Créez un compte sur GitHub.com puis créez un nouveau dépôt.
(Optionnel) créer un sujet sur Discourse pour discuter de vos couleurs
Idéalement, vous devriez créer un sujet dans la catégorie Customization > Theme avec quelques captures d’écran de votre schéma de couleurs. Vous utiliserez cela comme votre about_url
Remplir les informations manquantes dans votre fichier about.json
-
Accédez à votre page LICENSE sur GitHub, remplissez cette URL comme votre
license_url -
Utilisez soit l’URL du projet GitHub, soit l’URL du sujet Discourse comme votre
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 publiez sur GitHub
git commit -am "ajout de plus de détails"
git push
Tester votre composant de police
- Dans l’écran
admin/customize/theme, importez votre thème depuis GitHub
Vous pouvez désormais facilement partager des polices !
Voir aussi :
Ce document est sous contrôle de version - suggérez des modifications sur github.