#lienpermanent

guillaume_f@diaspora.psyco.fr

Tutoriel création d'un lien permanent

Utile par exemple pour renvoyer vers un autre post dans un commentaire.
Comme tout le monde n'utilise pas le même pod (exemple de pod : "diaspora.psyco") il faut un lien "permanent" que moi j'aurais tendance à nommer "universel" parce que compatible avec tous les pods diasporas.

merci à @Citoyen Candide.
#LienPermanent #Diaspora

citoyen_candide@diaspora-fr.org

Aide pour l'utilisation du schéma de lien Diaspora*

diaspolove

Bonjour,

Certaines personnes utilisatrices de Diaspora* rencontrent des difficultés ou appréhension dans l'utilisation de cet outils.

Je me propose de vous expliquer le #lienpermanent tel que définit par @Salinger. Il m'a fait comprendre ce fonctionnement, je tente à mon tour de le faire.

Pourquoi ?

Au fil de nos interactions avec d'autres sur Diaspora*, nous pouvons être amené•e à leur pointer certains posts.
La façon la plus simple de faire cela est de copier le lien url que l'on trouve dans la barre d'adresse de son navigateur.

Mais, étant donné la nature décentralisée de Diaspora*, une personne qui sera sur un autre pod ne pourra pas interagir avec ce post.

Par exemple, je peut pointer ce lien :
https://diaspora-fr.org/posts/4794302

(Au hasard, Balthazar. Surtout n'allez pas lire le contenu de ce post maintenant)

Ce lien est relatif au pod sur lequel je suis inscrit : diaspora-fr.org
Ça n'est pas forcément le pod sur lequel vous êtes inscrit vous même.

Ainsi, une personne inscrite sur diaspora.psycho.fr (ou n'importe quel autre pod) pourra voir le post en cliquant sur le lien, mais pas liker, commenter, repartager. Elle ne pourra pas interagir avec le post.

C'est ce problème particulier que solutionne le #lienpermanent.

Pointer les utilisateurs Diaspora* vers un post avec lesquel ils peuvent interagir.

Qui ?

Cette démarche implique de rédiger des liens en se servant de la mise en forme #markdown.
Ce sera donc à vous, utilisatrice ou utilisateur, de rédiger vos posts et/ou commentaire en utilisant la syntaxe adéquate.

Où ?

Sur vos posts et vos commentaires Diaspora*

Quand ?

Quand vous voudrez, quand vous vous sentirez prêt•e, quand vous aurez le temps, quand vous aurez envie de rendre Diaspora* encore plus convivial...

Quoi ?

De quoi parle t'on?
Nous parlons du diaspora:// URI scheme (page en anglais, désolé pour les francophones).
Pour faire simple, dans le principe, plutôt que d'aller piocher un post dans la liste de posts connus par un pod, cette syntaxe indique au navigateur comment aller chercher un post particulier (c'est important pour la suite).

Comment ?

Dans mon premier exemple, le lien donné utilise un identifiant local (4794302). Cette référence est propre au pod diaspora-fr.org et ne fonctionnera pas sur un autre pod. Du moins elle ne reverra pas sur le même post.

Il existe un autre identifiant de post, partagé entre tous les pods. Il s'agit du GUID (Global Unit IDentificator ?). On trouve cette longue suite de chiffres et de lettres d'au moins deux manières. Je décrit ça plus loin.

La mise en forme Markdown pour un lien, c'est :
[Alt text](lien_url)
Alt text est le texte que vous voulez voir apparaître
Et lien_url est l'adresse

Je l'ai utilisé dans ce post pour le lien diaspora:// URI scheme : j'ai écrit
diaspora:// URI scheme en guise de Alt text et copié le lien de la page voulue, placée entre les parenthèses.

Pour faire un lien permanent,

Il vous faut :
- Le GUID du post vers lequel vous voulez pointer,
- L'identifiant d'utilisateur. Celui de mon compte, c'est citoyen_candide@diaspora-fr.org

La syntaxe de lien permanent est la suivante
diaspora://author@pod/post/GUID

Ceci va venir entre les parenthèses dans la mise en forme Markdown.

On remplace author@pod par l'identifiant d'utilisateur. C'est celui de l'auteur du post que vous voulez partager.

On remplace GUID par le GUID du post en particulier que l'on veut partager.

J'attire votre attention sur le fait que cette syntaxe utilise post au singulier (.../post/...) et non posts au pluriel comme dans mon premier lien d'exemple (.../posts/...). C'est dû au fait qu'on va chercher un post particulier chez un auteur/utilisateur sur un pod en particulier et non un post dans une liste de posts.

Bon, mais là vous me dites: OK mais je trouve comment le GUID et l'identifiant utilisateur pour le post que je veut partager?

J'y viens.

Comme je l'ai dit plus haut, vous avez au moins deux méthodes.

À la souris :
Depuis un navigateur en mode non tactile, en survolant l'image de l'auteur, vous aurez son identifiant, il faut le surligner à la souris pour le copier.
Pour trouver le GUID, il faut passer sa souris à droite de l'heure du post.
Vous apercevrez une image en forme de chaine.
Copiez et coller le lien
Le GUID, c'est la longue suite de chiffre et de lettres.

Au clavier:
Dans la barre d'adresse de la page du post, ajoutez .json à la fin de l'adresse, puis entrer.
Vous verrez tous les champs qui composent une page de post diaspora, dont, au début, le GUID et plus loin, le diaspora_id, c'est l'identifiant utilisateur.

Voila, je crois que vous avez tous les éléments. Il ne vous reste plus qu'à passer à la pratique.

Pourquoi ne pas tenter de rédiger un post avec un lien permanent vers le présent post ?

P.S.: vos questions, commentaires, remarques sont les bienvenues.

salinger3@diaspora-fr.org

#lienpermanent.

Utiliser /posts/guid c'est simplement donner un lien "local". C'est dire "Dans le repertoire des posts (au pluriel), mais chercher celui-ci". Quand tu mets pas le nom de domaine d'une URL, le navigateur ajoute au début de l'url le nom de domaine courant. Cette astuce ne fonctionne donc que 1 grâce à un fallback du navigateur, 2 parce que l'url existe sur le pod du visiteur. Si par exemple, un utilisateur de diaspora-fr qui a un contact sur framasphere poste un message, le message n'est disponible que sur d-fr et framasphere. Si moi, qui ai des contacts dans quasiment tous les pods, je poste un message avec un lien /posts/guid vers le premier message, mes contacts sur d-fr et framasphere auront un lien local qui marche vers ce premier post, mais tous mes autres contacts auront une 404 : leur pod n'a jamais recu le post.

La syntaxe diaspora://author@pod/post/guid (avec post au singulier, car on va chercher un post, et un unique post) permet de savoir précisément où chercher le message, car on indique le pod d'origine du post. Si je reprends mon exemple précédent, tous les autres pods qui n'avaient pas recu le message seront en capacité d'aller demander le message au pod d'origine avec cette syntaxe. Donc, plus de 404, et un message qui transite mieux à travers le réseau.

Pour trouver le GUID, il faut passer sa souris à droit de l'heure du post.
Vous apercevrez une image en forme de chaine.
Copiez et coller le lien
Le GUID, c'est la longue suite de chiffre.

https://diaspora.github.io/diaspora_federation/federation/diaspora_scheme.html

note : la fonction aperçu ne vous permet pas de vérifier si votre lien est bon. il faut publier l'article puis vérifier le lien

#astuce #diaspora #lien #liens #federation #interpod