# Getting started (pour les développeurs front-end)

# Introduction

Fireblog est une interface de rédaction de blog en ligne dont les contenus sont accessibles via son API GraphQL.

Il a été pensé depuis le départ pour permettre de créer très facilement des blogs statiques ou Jamstack(opens new window) ultra-performants en le couplant à des technologies comme Gatsby(opens new window) , Eleventy(opens new window) , Nuxt(opens new window) ou Next(opens new window) ; tout en offrant une interface de rédaction adaptée aux longues séances d'écriture pour les web-rédacteurs et une API intuitive et fun pour les développeurs front-end.

En réalité la seule limite pour exploiter l'API de Fireblog est votre imagination, et on espère que vous allez construire avec des choses belles et surprenantes avec vos technologies préférées et publier des textes inspirants !

# Créer votre compte Fireblog

Commencez par créer un compte(opens new window) sur Fireblog, puis créez votre premier blog.

Créez un ou plusieurs articles et PUBLIEZ-LES.

WARNING

Seuls les articles publiés sont accessibles par l'API pour le moment.

# Explorer l'API

Vous pouvez désormais jouer avec l'API pour récupérer les contenus de votre blog. Des requêtes GraphQL d'exemples sont toujours à votre disposition depuis l'interface de rédaction en cliquant sur le bouton API.

Une fenêtre s'ouvre et vous permet d'accèder à l'explorateur de l'API ou d'essayer une des requêtes GraphQL d'exemple.

En cliquant par exemple sur le bouton Essayer de la requête qui permet d'obtenir la liste des posts, puis en appuyant sur le gros bouton ▶️ de l'explorateur de l'API, on peut jouer avec la requête GraphQL et voir la liste de nos posts publiés !

# Afficher votre blog

Vous avez maintenant deux solutions pour afficher votre blog :

  • Utilisez un de nos thèmes prêts à l'emploi (le plus rapide).
  • Créez votre propre front-end en interrogeant vous-même l'API GraphQL pour récupérer les contenus et en utilisant la technologie de votre choix. Vous pouvez trouver des exemples pour vous inspirer ici: https://github.com/fireblogcms/fireblog-examples(opens new window)

# Utiliser un thème prêt à l'emploi

Nous avons aujourd'hui deux thèmes open-source de départ qui sont très faciles à personnaliser, l'un en Gatbsy.js, l'autre en Eleventy.

Gatbsy conviendra à celles et ceux qui adorent React, tandis que Eleventy plaira beaucoup à celles et ceux qui préférent une solution simple et sobre, sans JavaScript côté client.

Nos kits de démarrage

Nous allons construire progressivement un véritable catalogue de thèmes avec de chouettes designs et d'autre technologies front-end pour que vous puissiez toujours trouver un front-end qui correspond à votre projet !

# Déploiement et hébergement

Il existe aujourd'hui d'excellents hébergeurs pour déployer vos sites statiques et Jamstack; qui vont à la fois :

  • faire le build de votre site statique
  • déployer vos fichiers statiques sur un CDN
  • être en mesure de redéclencher un build du site via un webhook entrant

En effet, quand le contenu du blog change, Fireblog peut envoyer une requête HTTP POST à votre hébergeur en indiquant que votre blog doit être regénéré.

Chez Fireblog, nous vous recommandons par exemple les hébergeurs suivants pour vos blogs statiques :

  • Netlify(opens new window) : ils sont à l'origine même du concept Jamstack !
  • Vercel(opens new window) : par les créateurs de Next.js. Très versatile, Vercel est une puissante plateforme de déploiement pour vos applications statiques, serverless mais aussi dynamiques.

# Configurer les webhooks

Dans l'interface de Fireblog, rendez-vous dans les réglages du blog.

Dans le formulaire des webhooks, vous pouvez indiquer l'URL que Fireblog doit appeler pour déclencher la régénération de votre blog statique. Dans le cas ci-dessous, il s'agit d'un blog hébergé chez Netlify.

Si besoin, vous pouvez indiquer plusieurs URL, séparées par des virgules.