deeplinks

deeplinks.js

deeplinks.js permet aux gens de se connecter facilement directement à toute sélection de texte sur votre site Web. Voici un exemple de ce à quoi ressemble l'un de ces liens. Il est principalement destiné aux blogs et autres sites Web de ce type, mais il est relativement agnostique pour l'environnement dans lequel il fonctionne.

Les gens peuvent sélectionner du texte sur le site comme le feraient normalement, et quand ils le font, l'identifiant des fragments (la chose qui vient après le # dans l'URL) change. S'ils veulent partager le texte qu'ils ont sélectionné, ils copient simplement l'URL et l'envoient à quelqu'un. Lorsque cette personne visite l'URL, le même texte qui a été sélectionné à l'origine sera sélectionné et défilé en vue.

Cette description peut le rendre un peu compliqué, mais il est en fait assez simple et intuitif une fois que vous jouez avec - allez le vérifier! Si vous souhaitez connaître les détails de la façon dont cela fonctionne sous le capot, consultez docs/design/ .

Objectifs

• Plug-and-play. Copiez les fichiers, déposez <script type="module" src="/deeplinks/deeplinks.js"></script> dans votre site Web, et cela fonctionne.
• Robuste. Les mises à jour ne briseront pas les liens vers les URL plus anciennes.
• Liens courts. Les URL longues sont laides et fréquemment mutilées par des applications de messagerie. Les URL doivent être courtes et ne pas contenir de caractères susceptibles d'être mutilés par des applications mal comportementales.
• Subtil. Il ne devrait pas entrer dans le chemin. Il ne brise pas les liens normaux de fragment-identificateur.
• Raisonnablement petit. C'est environ 1,7 Ko gzipped en ce moment (1,6 Ko Brotli), et ne devrait pas grandir trop.
• Rapide. Ce n'est pas difficile, mais cela vaut la peine d'être explicite.

Non-Goals

• Gérer le contenu fréquemment en train de changer, comme les wikis. Il devrait être robuste aux petites modifications occasionnelles, mais si vous voulez une liaison profonde vraiment robuste, vous avez vraiment besoin de soutien de l'environnement de création (CRDTS, etc.).
• Travailler pour chaque ucase. J'ai des choses spécifiques que je veux dans un script comme celle-ci, et d'autres personnes auront d'autres choses qu'ils veulent. Ces gens devraient construire leurs propres scripts similaires - la diversité est bonne! Par exemple, cela n'implémente pas intentionnellement l'interface de fragment de texte WICG, bien qu'il soit possible, il se peut à l'avenir que cela finit par standardiser sous une forme que j'aime.

Installation

Tout d'abord, demandez-vous si vous voulez vraiment faire cela. Si vous le faites, vous créez de nouvelles URL, qui se casseront si vous supprimerez le script de votre site. Briser les URL me rend triste, vous devriez donc vous demander si vous êtes vraiment déterminé à cela ou non, et peut-être jouer avec localement pendant un petit moment pour voir ce que cela se sent avant de le déployer vraiment.

Une fois que vous êtes sûr:

• Téléchargez la version la plus récente de la page des versions.
• Extraire le fichier zip quelque part dans votre site Web.
• Incluez le script n'importe où dans votre HTML:

   < script type =" module " src =" /deeplinks/deeplinks.js " > </ script >

  Cela suppose que vous avez extrait la libération dans un répertoire appelé deeplinks - vous devrez changer le src si vous le mettez ailleurs. Assurez-vous d'inclure le type="module" , cela ne fonctionnera pas autrement! Vous ne devez l'inclure que sur des pages qui ne changent pas fréquemment - en particulier, ne l'incluez pas sur les pages de pagination où le contenu change lorsque vous publiez de nouveaux articles, par exemple.
• Tester que cela fonctionne.
• Si vous vous sentez bien, remplissez ce formulaire avec un lien vers votre site Web! (Ou tout simplement envoyez-moi un e-mail, si vous n'aimez pas les formulaires Google)