Contentful et Ruby

Si vous aimez travailler avec Ruby mais que vous n’avez pas encore trouvé de système de gestion de contenu (CMS) fiable, et que le manque d’options vous laisse sur votre faim, nous savons ce que vous ressentez. Nous le savons parce que nous sommes aussi passés par là. C’est pourquoi nous proposons une nouvelle solution : une plateforme de contenu API-first, indépendante de la technologie, que vous pouvez utiliser dans vos applications Ruby. Dans cet article, nous mettrons en évidence les avantages de l’utilisation de Contentful et de notre plateforme de contenu pour votre prochain projet Ruby.

Avant d’aller plus loin, il est important de clarifier ce que vous obtiendrez avec Contentful. Grâce à notre plateforme de contenu, vos développeurs pourront récupérer le contenu via des appels d’API, tout en offrant aux éditeurs une interface web familière pour créer et gérer le contenu. Ainsi, que vous développiez pour des objets connectés, des smartphones ou des applications web, votre contenu n’est qu’à un appel d’API. Et comme il s’agit d’une solution hébergée dans le cloud, elle nécessite bien moins de maintenance qu’un système de gestion de contenu Ruby traditionnel — vous laissant ainsi plus de temps pour vous concentrer sur la création d’excellentes applications.

Nous fournissons des SDK pour les langages de programmation populaires tels que JavaScript, PHP et, bien sûr, Ruby. Ces SDK sont conçus pour vous faciliter la vie en tant que développeur lorsque vous utilisez Contentful et vous donnent un accès presque instantané à nos API et à leurs fonctionnalités.

Content Delivery API (CDA)

Content Delivery API (CDA) de Contentful est une API en lecture seule pour la diffusion de contenu de Contentful vers des applications, des sites Web et d’autres médias, arrivant sous forme de données JSON et de fichiers multimédias. Pour commencer avec notre SDK Ruby CDA, vous avez deux options. Installez le gem « contentful » :

Ou incluez-le dans votre « Gemfile » :

Une fois dans votre « Gemfile », vous pouvez exécuter « bundle install » pour installer le gem et toutes ses dépendances.

Ensuite, vous pouvez travailler avec l’extrait de code suivant pour récupérer le contenu de Contentful :

Et il y a bien plus que cela à voir. Si vous souhaitez approfondir la question, nous avons expliqué l’ensemble de ce processus dans notre tutoriel Premiers pas.

Content Management API (CMA)

Nous avons également un SDK Ruby pour Content Management API (CMA) de Contentful. Il s’agit d’une API de lecture-écriture pour la gestion de contenu. Vous pouvez utiliser CMA pour plusieurs cas d’utilisation, y compris les importations automatiques à partir de CMS traditionnels comme WordPress ou Drupal et la création d’expériences d’édition personnalisées.

Encore une fois, vous avez deux choix : soit installer notre gem « contentful-management » comme indiqué ci-dessus, soit l’ajouter à l’intérieur de votre « Gemfile » et exécuter « bundle install ». Si vous choisissez de l’inclure dans votre « Gemfile », la seule différence est ce que vous ajoutez exactement :

Une fois cette opération terminée, vous pouvez ensuite travailler avec l’extrait de code suivant pour gérer le contenu de Contentful :

Pour ceux qui souhaitent en savoir plus, nous avons également un guide sur la prise en main de Contentful CMA et Ruby.

Vous utilisez probablement un framework pour vos applications Ruby, et pour une bonne raison. Les frameworks vous permettent de passer à l’échelle rapidement, la maintenance du code est plus simple qu’avec du Ruby pur, et ils vous offrent la possibilité de consacrer votre temps à la véritable tâche plutôt qu’à la technologie sous-jacente. Pas d’inquiétude, nous avons ce qu’il vous faut. Contentful propose des intégrations pour deux des frameworks Ruby les plus populaires : Rails et Sinatra.

Rails

Ruby on Rails, ou Rails en abrégé, est sans doute le framework Ruby le plus populaire. Il est conçu pour rendre la programmation d’applications Web côté serveur avec Ruby sans tracas en vous permettant d’écrire moins de code tout en faisant plus. Pour faciliter cette collaboration, nous avons retravaillé deux gems qui simplifient la création d’applications Rails optimisées par Contentful : « contentful_rails » et « contentful_model ». Ces gems ont été créées pour permettre aux développeurs Ruby d’intégrer facilement Contentful dans leurs applications Rails. Vous pouvez en savoir plus sur la façon d’utiliser « contentful_rails » et « contentful_model » dans vos applications sur notre blog. La meilleure façon de démarrer avec Contentful et Rails est de travailler avec notre tutoriel Utiliser Contentful avec une application Ruby on Rails. Bien qu’il n’utilise pas les gems mentionnées précédemment, c’est le guide le plus complet qui soit.

Sinatra

Également couramment utilisé dans la communauté Ruby, Sinatra est un DSL qui fonctionne selon la philosophie de « créer des applications Web en Ruby avec un minimum d’efforts ».Chez Contentful, nous aimons utiliser Sinatra en raison de sa simplicité et de sa flexibilité. En fait, nous avons construit notre application Exemple avec. Vous pouvez la voir sur GitHub. Dans cette application, nous avons intégré Contentful en utilisant le pattern de Service. Cela à cause de la nécessité de basculer dynamiquement entre les API de diffusion et de prévisualisation, et car nous avions également quelques requêtes très spécialisées. Vous pouvez jeter un œil à la façon dont nous l’avons écrit dans notre fichier wrapper — et cette ligne issue de notre fichier ’courses.rb’ en est un exemple concret. Si vous cherchez un moyen rapide de vous lancer, vous pouvez suivre notre tutoriel sur la création de votre propre application Contentful et Sinatra.

Il est indéniable que les sites statiques ont fait leur retour, en grande partie parce que tous les projets Web n’ont pas besoin d’une stack technique complexe. Parfois, quelques pages statiques suffisent. C’est pourquoi nous avons créé des intégrations Contentful pour Middleman et Jekyll, deux générateurs de sites statiques populaires basés sur Ruby. Chacune de ces intégrations est décrite en détail dans notre article de blog, « Créer des sites statiques avec Contentful et Ruby ».Nous avons plusieurs tutoriels sur Middleman et Jekyll, montrant des fonctionnalités telles que les cycles de reconstruction automatisés et d’autres dépôts d’exemples. En plus de cela, l’un de nos évangélistes Ruby, David Litvak, a également une démo assez complète de ce que vous pouvez faire avec Contentful et Middleman sur son GitHub. Dans ce projet, le fichier le plus important auquel il faut prêter attention est le « config.rb » car, comme le dit David, c’est « là que toute la magie se produit ».

Nous vous encourageons à consulter Contentful pour Ruby pour des tutoriels, des exemples d’applications, etc. Ou si vous êtes prêt à vous lancer, créez un compte gratuit et commencez à interagir avec notre infrastructure de contenu dès aujourd’hui.