C'est quoi le concept ?

latribu.dev est un site qui agrège des articles provenant de la communauté web francophone. Le but étant de promouvoir des auteurs et autrices d'articles consacrés au développement web en redirigeant les utilisateurs et utilisatrices vers leur blog respectif.

Pour relayer vos articles, latribu.dev a besoin d'un flux de syndication au format JSON Feed pour en extraire l'article le plus récent. Le lien vers votre article sera affiché durant une période de temps limité. En effet, les articles sont renouvelés régulièrement au fur et à mesure des nouvelles publications provenant des autres flux agrégés.

Créer son flux JSON Feed

Vous devez donc mettre en place sur votre blog un flux de syndication au format JSON (JSON Feed version 1.1) valide. Si vous avez déjà entendue parler du flux RSS en XML pour partager vos contenus, c'est la même chose mais au format JSON.

Votre flux JSON doit comporter au minimum les informations et la structure suivante :

  	
	{
	    "version": "https://jsonfeed.org/version/1.1",
	    "title": "My Example Feed",
	    "authors": [
	    	{
	    		"name": "Barbara Do"
	    	}
	    ],
	    "home_page_url": "https://example.org/",
	    "feed_url": "https://example.org/feed.json",
	    "items": [
	        {
	            "id": "2",
	            "url": "https://example.org/second-item",
	            "title": "Second item.",
	            "content_html": "This is a second item.",
	            "authors": [
			    	{
			    		"name": "Barbara Do",
			    		"avatar" "https://example.org/assets/img/av.jpg"
			    	}
			    ],
	            "date_published": "2022-10-09T18:22:00Z",
	            "_display": [
	            	{
	            		"reader": [
	            			{
	            				"https://latribu.dev"
	            			}
	            		]
	            	}
	            ]
	        },
	        {
	            "id": "1",
	            "url": "https://example.org/first-item",
	            "title": "First item",
	            "content_html": "This is the first item.",
	            "authors": [
			    	{
			    		"name": "Barbara Do",
			    		"avatar" "https://example.org/assets/img/av.jpg"
			    	}
			    ],
	            "date_published": "2022-05-09T14:04:00Z",
	            "_display": [
	            	{
	            		"reader": [
	            			{
	            				"https://latribu.dev"
	            			}
	            		]
	            	}
	            ]
	        }
	    ]
	}
  	
  	

A titre d'exemple, vous pouvez consulter le JSON Feed de mon blog à l'adresse https://pixenjoy.com/notes.json

Utilisez le site https://validator.jsonfeed.org/ pour tester la validité de votre JSON Feed.

Pourquoi un JSON Feed ?

Parce que le bon vieux flux RSS au format XML a fait son temps, merci à lui. Place maintenant au flux JSON, plus flexible, plus simple à lire et manipuler.

Pour en savoir plus sur le format JSON Feed, je vous invite à vous rendre sur le site officiel JSON Feed version 1.1

Combien d'articles mettre dans mon flux ?

Le but de la syndication est de permettre à d'autres personnes de s'abonner à vos publications. Ces personnes s'intéressent généralement à vos articles les plus récents, il n'est donc pas nécessaire de mettre tous les articles de votre blog dans votre flux JSON. Vous pouvez par exemple limiter le nombre d'articles à 10. A titre d'information, latribu.dev séléctionnera un seul article de votre flux, celui publié le plus récemment.

Et si je ne souhaite pas qu'un de mes articles soit séléctionné ?

Il peut arriver que dans votre flux JSON, un article sorte de la thématique de latribu.dev. Si vous ne souhaitez pas que cet article soit pris en compte sur latribu.dev, laissez la valeur de items > _display > reader à vide "" ou passez lui une valeur autre que "https://latribu.dev". La valeur "https://latribu.dev" indique à latribu.dev que l'article peut être relayé sur le site.