Aller au contenu

Documentation

🗣 Citations

Le widget Citations permet d’afficher des phrases inspirantes ou humoristiques issues de plusieurs sources intégrées, ou d’importer vos propres citations via un fichier local ou une URL distante au format CSV.

Le widget de citations peut récupérer des phrases depuis plusieurs sources :

  • Par défaut, notre API open source de citations disponible en plusieurs langues. Il s’agit de citations motivationnelles ou inspirantes que la communauté peut enrichir via des pull requests.
  • L’API InspiroBot, une IA “old school” qui génère des citations pseudo-inspirantes avec une touche humoristique. Elle détourne les citations de motivation classiques en les transformant en parodies générées par une IA. Même si nous ne sommes pas affiliés à InspiroBot, ce service a toujours été apprécié et a été intégré pour son côté décalé. Il est important de noter qu’il a plus de 10 ans et n’a aucun lien avec les tendances actuelles autour de l’IA générative.
  • L’API Kaamelott, qui propose des répliques issues d’une série comique française. Disponible uniquement en français.
  • Des citations stoïques, inspirées de la philosophie du stoïcisme.
  • Hitokoto, des citations inspirantes japonaises.
  • Personnalisé, pour ajouter ses propres citations directement depuis l’interface de Bonjourr.
  • URL, pour importer des citations depuis un fichier CSV distant.

Deux méthodes permettent d’importer ses citations : directement depuis Bonjourr ou via une URL distante. Dans les deux cas, le format attendu est le suivant :

Auteur, Votre citation.
Auteur, Votre deuxième citation\nAvec un retour à la ligne dans la citation !

Une fois l’option activée, il suffit d’ajouter les citations en respectant le format indiqué ci-dessus.

Cette option est limitée à 8 kB de texte, soit environ 50 citations de taille standard. Cela s’explique par l’utilisation de storage.sync, qui impose cette limite par objet. Pour des bibliothèques plus volumineuses, il est recommandé d’utiliser l’option URL.

L’option URL permet de connecter Bonjourr à un fichier CSV distant contenant les citations.

La méthode la plus simple consiste à utiliser GitHub Gist, un service permettant d’héberger facilement un fichier :

  1. Créer un compte sur GitHub si nécessaire, puis se connecter.
  2. Aller sur la page GitHub Gist.
  3. Donner une description au fichier, par exemple “Mes citations Bonjourr”.
  4. Nommer le fichier, par exemple bonjourr_quotes.csv. Le nom peut être libre tant qu’il se termine par .csv.
  5. Ajouter les citations en respectant le format indiqué plus haut (elles pourront être modifiées ensuite).
  6. Une fois terminé, cliquer sur Create secret gist. Le fichier est alors créé et affiché sous forme de tableau.
  7. Cliquer sur le bouton Raw, copier l’URL de la page qui s’ouvre et la coller dans le champ URL de Bonjourr. Voilà !