deeplinks

deeplinks.js

deeplinks.js memungkinkan orang untuk dengan mudah menautkan langsung ke pilihan teks apa pun di situs web Anda. Berikut adalah contoh dari seperti apa tautan ini. Ini dimaksudkan sebagian besar untuk blog dan situs web lainnya, tetapi relatif agnostik bagi lingkungan yang dijalankannya.

Orang dapat memilih teks di situs seperti yang biasanya, dan ketika mereka melakukannya, pengidentifikasi fragmen (hal yang terjadi setelah # dalam url) berubah. Jika mereka ingin membagikan teks yang telah mereka pilih, mereka cukup menyalin URL dan mengirimkannya kepada seseorang. Ketika orang itu mengunjungi URL, teks yang sama yang awalnya dipilih akan dipilih dan digulirkan ke tampilan.

Deskripsi ini mungkin membuatnya terdengar sedikit rumit, tetapi sebenarnya cukup sederhana dan intuitif setelah Anda bermain dengannya - lihatlah! Jika Anda tertarik untuk mengetahui detail cara kerjanya di bawah kap, lihat docs/design/ .

Sasaran

• Plug-and-play. Salin file, letakkan <script type="module" src="/deeplinks/deeplinks.js"></script> di situs web Anda, dan berfungsi.
• Kokoh. Pembaruan tidak akan merusak tautan ke URL yang lebih lama.
• Tautan singkat. URL panjang jelek dan sering hancur oleh aplikasi pesan. URL harus pendek dan tidak mengandung karakter yang mungkin digerogoti oleh aplikasi yang salah.
• Tak kentara. Seharusnya tidak menghalangi jalan pembaca. Itu tidak merusak tautan pengidentifikasi fragmen normal.
• Cukup kecil. Sekitar 1.7kb Gzipped sekarang (1.6kb Brotli), dan tidak boleh tumbuh terlalu banyak.
• Cepat. Ini tidak sulit, tapi itu layak dibuat secara eksplisit.

Non-Goals

• Menangani konten yang sering berubah, seperti wiki. Ini harus kuat untuk pengeditan kecil sesekali, tetapi jika Anda ingin tautan mendalam yang benar -benar kuat, Anda benar -benar membutuhkan dukungan dari lingkungan penulisan (CRDT, dll).
• Bekerja untuk setiap Usecase. Saya memiliki hal -hal spesifik yang saya inginkan dalam skrip seperti ini, dan orang lain akan memiliki hal -hal lain yang mereka inginkan. Orang -orang itu harus membangun skrip serupa mereka sendiri - keragaman itu bagus! Misalnya, ini secara sengaja tidak mengimplementasikan antarmuka fragmen teks WICG, meskipun mungkin di masa depan mungkin jika itu akhirnya distandarisasi dalam bentuk yang saya sukai.

Instalasi

Pertama, pertimbangkan apakah Anda benar -benar ingin melakukan ini. Jika Anda melakukannya, Anda membuat URL baru, yang akan rusak jika Anda pernah menghapus skrip dari situs Anda. Breaking URL membuat saya sedih, jadi Anda harus memikirkan apakah Anda benar -benar berkomitmen untuk ini atau tidak, dan mungkin bermain dengannya secara lokal untuk sementara waktu untuk melihat bagaimana rasanya sebelum Anda benar -benar menggunakannya.

Setelah Anda yakin:

• Unduh rilis terbaru dari halaman rilis.
• Ekstrak file zip di suatu tempat di situs web Anda.
• Sertakan skrip di mana saja di html Anda:

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

  Ini mengasumsikan Anda mengekstrak rilis ke dalam direktori yang disebut deeplinks - Anda harus mengubah src jika Anda meletakkannya di tempat lain. Pastikan Anda memasukkan type="module" , itu tidak akan berfungsi sebaliknya! Anda hanya boleh memasukkannya pada halaman yang tidak akan sering berubah - terutama, tidak memasukkannya ke halaman pagination di mana konten berubah saat Anda mempublikasikan posting baru, misalnya.
• Uji itu berhasil.
• Jika Anda merasa baik, isi formulir ini dengan tautan ke situs web Anda! (Atau hanya email saya, jika Anda tidak menyukai formulir Google)