Fox – Formatage
Les fichiers utilisés pour générer la capsule et le site web, utilisent le format Gemini. Cela ressemble au format Markdown, mais des différences existent est sont expliquées dans la capsule du protocole Gemini.
Si l’utilitaire `fox` utilise le format Gemini pour construire les fichiers de sortie, des spécificités existent pour permettre d’améliorer le rendu.
Gestion des liens internes
La définition des liens internes au projet se fait de la façon suivante :
L’utilitaire va réaliser deux changements sur les fichiers de sortie concernant ce format :
- Lorsque le lien commence par un `/`, ce symbole sera remplacé par l’URL spécifiée par les arguments `--base-url` et `--gemini-url`.
- De plus, l’extension `.gmi` sera remplacée par `.html` lors de la génération du site web.
Les médias (images, vidéos, …) subiront le même traitement concernant la base de l’URL, mais conserveront leur extension.
Mise en avant d’une commande dans un paragraphe
La syntaxe n’existe pas dans le format Gemini, mais afin d’améliorer le rendu du site web, la syntaxe du format Markdown pour afficher du code dans un paragraphe est prise en compte lors de la génération.
Il suffit d’utiliser l’accent grave, comme pour le Markdown, afin que la commande soit mise en avant dans le texte.
Ces symboles ne sont pas enlevés de la version finale de la capsule Gemini. Ils ne nuisent pas à la lisibilité de la page et permettent même de mieux séparer la commande du reste du texte.
–––
Liens permanents :