deeplinks

deeplinks.js

deeplinks.js允許人們輕鬆地直接鏈接到您網站上的任何文本選擇。這是這些鏈接之一的示例。它主要是針對博客和其他此類網站的，但是它對它正在運行的環境相對不可知。

人們可以按照往來的方式選擇網站上的文本，並且當他們這樣做時，片段標識符（在URL中#之後出現的東西）會更改。如果他們想分享他們選擇的文本，他們只需複制URL並將其發送給某人即可。當該人訪問URL時，將選擇最初選擇的文本並將其滾動到視圖中。

此描述可能會使它聽起來有些複雜，但是一旦您使用它，它實際上非常簡單，直觀 - 請檢查一下！如果您有興趣了解其在引擎蓋下工作的詳細信息，請查看docs/design/ 。

目標

• 插件。複製文件，drop <script type="module" src="/deeplinks/deeplinks.js"></script>在您的網站中，它有效。
• 強壯的。更新不會破壞指向較舊的URL的鏈接。
• 短鏈接。長URL醜陋，經常被消息傳遞應用程序所困擾。 URL應該是簡短的，並且不包含可能通過行為不良的應用程序弄髒的字符。
• 微妙的。它不應該以讀者的方式獲得。它不會打破正常的片段識別劑鏈接。
• 相當小。目前約為1.7kb的GZB（1.6kb brotli），不應該再生長太多。
• 快速地。這並不難，但值得一提。

非目標

• 處理經常改變的內容，例如Wiki。偶爾進行小型編輯應該是可靠的，但是如果您想真正牢固的深層鏈接，則確實需要創作環境（CRDT等）的支持。
• 為每個用戶酶工作。我有像這樣的腳本中想要的特定內容，其他人將還有其他想要的東西。這些人應該構建自己的類似腳本 - 多樣性很好！例如，這故意不會實現WICG文本片段界面，儘管如果以後最終以我喜歡的形式進行標準化，則有可能。

安裝

首先，考慮您是否真的想這樣做。如果這樣做，則正在製作新的URL，如果您從網站上刪除腳本，它將破壞。打破URL會讓我感到難過，因此您應該考慮是否真的致力於這個，並且可能在當地玩一會兒，看看它在真正部署之前的感覺。

一旦確定：

• 從“版本”頁面下載最新版本。
• 將zip文件提取在您網站的某個地方。
• 在您的HTML中將腳本包括在內：

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

  假設您將版本提取到稱為deeplinks的目錄中 - 如果將其放在其他地方，則需要更改src 。確保您包含type="module" ，否則它將無法使用！您應該只在不會經常更改的頁面中包含它，尤其是在發布新帖子時會更改的分頁頁上。
• 測試是否有效。
• 如果您感覺很好，請填寫此表格，並通過指向您的網站的鏈接！ （或者只是給我發電子郵件，如果您不喜歡Google表格）