deeplinks

deeplinks.js

deeplinks.js permite a las personas vincularse fácilmente directamente a cualquier selección de texto en su sitio web. Aquí hay un ejemplo de cómo se ve uno de estos enlaces. Está destinado principalmente a blogs y otros sitios web similares, pero es relativamente agnóstico para el entorno en el que se está ejecutando.

Las personas pueden seleccionar texto en el sitio como lo haría normalmente, y cuando lo hacen, el identificador de fragmentos (lo que viene después de que cambia # en la URL). Si quieren compartir el texto que han seleccionado, simplemente copian la URL y se lo envían a alguien. Cuando esa persona visita la URL, el mismo texto que se seleccionó originalmente se seleccionará y se desplazará a la vista.

Esta descripción puede hacer que suene un poco complicado, pero en realidad es bastante simple e intuitivo una vez que juegas con ella, ¡ve a verlo! Si está interesado en conocer los detalles de cómo funciona debajo del capó, consulte docs/design/ .

Objetivos

• Plug-and-play. Copie los archivos, suelte <script type="module" src="/deeplinks/deeplinks.js"></script> en su sitio web, y funciona.
• Robusto. Las actualizaciones no romperán los enlaces a URL más antiguas.
• Enlaces cortos. Las URL largas son feas y frecuentemente destrozadas por las aplicaciones de mensajería. Las URL deben ser cortas y no contener personajes que puedan ser destrozados por aplicaciones de mal comportamiento.
• Sutil. No debería interponerse en el camino del lector. No rompe los enlaces de identificador de fragmento normal.
• Razonablemente pequeño. Es alrededor de 1.7 kb Gzipped en este momento (1.6kb brotli), y no debería crecer demasiado.
• Rápido. Esto no es difícil, pero vale la pena hacer explícito.

Indiferentes

• Manejo de contenido que cambia con frecuencia, como wikis. Debería ser robusto para las ediciones pequeñas ocasionales, pero si desea una vinculación profunda realmente robusta, realmente necesita apoyo del entorno de autor (CRDTS, etc.).
• Trabajando para cada uso us. Tengo cosas específicas que quiero en un guión como este, y otras personas tendrán otras cosas que quieren. Esas personas deberían construir sus propios guiones similares: ¡la diversidad es buena! Por ejemplo, esto no implementa intencionalmente la interfaz de fragmento de texto WICG, aunque es posible que en el futuro sea estandarizado en una forma que me gusta.

Instalación

Primero, considere si realmente quiere hacer esto. Si lo hace, está haciendo nuevas URL, que se romperán si alguna vez elimina el script de su sitio. Romper URL me entristece, por lo que debe pensar si está realmente comprometido con esto o no, y tal vez jugar con él localmente por un tiempo para ver cómo se siente antes de que realmente lo despliegue.

Una vez que estés seguro:

• Descargue el lanzamiento más reciente de la página de lanzamientos.
• Extraiga el archivo zip en algún lugar de su sitio web.
• Incluya el script en cualquier lugar de su HTML:

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

  Esto supone que extrajo la liberación en un directorio llamado deeplinks : deberá cambiar el src si lo coloca en otro lugar. Asegúrese de incluir el type="module" , ¡no funcionará de otra manera! Solo debe incluirlo en páginas que no cambiarán con frecuencia; particularmente, no lo incluya en páginas de paginación donde el contenido cambia a medida que publica nuevas publicaciones, por ejemplo.
• Prueba que funciona.
• Si te sientes bien, ¡complete este formulario con un enlace a tu sitio web! (O simplemente envíeme un correo electrónico, si no le gustan los formularios de Google)