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表格）