Comment commenter

Vous pouvez commenter tous les articles de ce site en utilisant la méthode de commentaire IndieWeb. Voici comment procéder.

Version courte

1. Publiez un billet sur votre propre site avec le balisage Microformats 2. Utilisez h-entry pour le contenu et h-card pour votre profil.
2. Créez un lien vers mon article avec rel="in-reply-to".
3. Envoyez une webmention de votre article au mien.
4. J’analyserai ensuite votre commentaire et l’afficherai sous mon article.

Version longue

Écrire

Publiez un billet sur votre propre site avec le balisage Microformats 2. Vous n’avez pas besoin d’un logiciel particulier, juste d’un outil qui vous permet de saisir du HTML.

<div class="h-entry">
  <div class="e-content">Je suis d’accord avec toi, Yomli.</div>
  <div class="p-author h-card">Arthur Dent</div>
</div>
		

Faire un lien

Créez un lien vers mon article avec rel="in-reply-to". Ce lien ne doit pas nécessairement faire partie de la h-entry ci-dessus, mais doit être placé quelque part sur la page de votre article.

<a href="https://yom.li/notes/a-note" rel="in-reply-to">
  Un bel article
</a>
		

Au lieu d’un commentaire, vous pouvez également indiquer que vous avez aimé ou reposté mon article en ajoutant u-like-of ou u-repost-of à votre lien :

<a href="https://yom.li/notes/a-note" class="u-like-of">
  J’aime ça
</a>

<a href="https://yom.li/notes/a-note" class="u-repost-of">
  J’ai reposté ceci
</a>
		

Webmention

Enfin, envoyez une webmention de votre article au mien pour me faire savoir que j’ai un commentaire à récupérer. Mon endpoint webmention est : https://yom.li/api/webmention/ (le slash final est important). Envoyez un HTTP POST à cette URL avec les variables de formulaire suivantes (en utilisant vos propres URL bien sûr) :

• source=https://example.org/my-reply
• target=https://yom.li/notes/a-note

Vous pouvez utiliser l’un des nombreux clients pour envoyer votre webmention, mais la méthode la plus simple consiste à utiliser curl :

$ curl -i -d "source=YOUR_POST_PERMALINK&target=MY_POST_PERMLINK" \
https://yom.li/api/webmention/		

Si votre webmention échoue pour une raison ou une autre, faites-le moi savoir et je serai plus que ravi de vous aider à déboguer.

Liste blanche

N’oubliez pas de vérifier que votre domaine appartient à ma liste blanche, autrement votre message ne sera affiché que comme un like anonyme.

Si votre domaine n’est pas sur cette liste blanche, mais que l’un des domaines a déjà fait un lien vers le vôtre, vous pouvez demander un parrainage en ajoutant aux variables de formulaire HTTP POST : vouch=SOME_URL_WHO_LINKED_YOUR_BLOG. Autrement dit, si Alice a déjà fait un lien vers votre site, et qu’elle se trouve sur ma liste blanche, vous pouvez ajouter en vouch l’URL de la page où Alice vous mentionne.

Afficher

En cas de succès, mon serveur analysera votre message, récupérera votre commentaire et l’ajoutera sous l’article original.