Gem : FontAwesome SVG
Article de 2018 : certaines informations ont pu changer depuis.
Besoin
Je souhaitais utiliser FontAwesome sans pour autant intégrer toute la librairie, assez lourde.
J’ai donc cherché un moyen de n’inclure que les icônes utilisées, et c’est comme cela que je suis venu à chercher comment créer un plugin Jekyll.
La documentation est assez bien fournie, ce qui m’a permis de rapidement prendre en main Jekyll.
Réalisation
Ne souhaitant qu’afficher des icônes, je me suis tourné vers 2 Tag, qui permettent de définir une balise et de lui passer des paramètres.
Ainsi, je passe à mon premier tag le type de l’icône que je souhaite utiliser (regular, solid ou brand), ainsi que son nom, et je génère la balise HTMLnote 1 correspondant à l’icône. Il ne me reste donc plus qu’à récupérer la définition SVGnote 2 de l’icône et l’inclure dans un namespace, en bas de la page HTML.
Pour cela, j’ai ajouté aux données de la page Jekyll les icônes que j’utilise, dans un simple tableau.
C’est lors de l’usage du deuxième tag que je récupère toutes les icônes utilisées sur la page, et que je vais récupérer la définition SVG de l’icône.
J’ai tout d’abord réalisé ce plugin très simplement, en utilisant le répertoire _plugins de Jekyll. Mais une fois fonctionnel, j’ai souhaité en faire une Gem, mise à disposition sur RubyGems, pour qu’elle soit disponible pour tous, si elle venait à être utile à certains :blush:.
La création d’une Gem a été assez simple, le guide de Bundler étant très bien détaillé.
J’ai essayé d’être le plus en accord avec les conventions du langage Ruby, mais n’étant pas familier avec ce dernier, je suis ouvert à toutes remarques pour améliorer le code !
Il me reste à tester l’application de façon plus détaillée et à gérer les cas d’erreurs, qui sont pour le moment gérés de façon optimiste !
Usage
L’usage est le suivant :
Lorsque l’on souhaite afficher une icône, il faut utiliser le tag suivant. Le code ci-dessous va générer l’icône Twitter.
{% fa_svg fab.fa-twitter %}
Voici le résultat :
{% fa_svg fab.fa-twitter %}
Il faut ensuite ajouter à un endroit commun à toutes les pages (en général un footer), le tag de génération de la feuille SVG.
{% fa_svg_generate %}
Liens
Si vous voulez voir le code, il est disponible sur ce dépôt.
Pour télécharger la Gem, c’est par ici !