deeplinks

deeplinks.js

deeplinks.js permite que as pessoas se conectem facilmente diretamente a qualquer seleção de texto em seu site. Aqui está um exemplo de como é um desses links. É destinado principalmente a blogs e outros sites, mas é relativamente agnóstico ao ambiente em que está sendo executado.

As pessoas podem selecionar o texto no site como normalmente, e quando o fizerem, o identificador de fragmento (o que vem após o # no URL) muda. Se eles querem compartilhar o texto que selecionaram, simplesmente copiam o URL e o enviam para alguém. Quando essa pessoa visitar o URL, o mesmo texto que foi originalmente selecionado será selecionado e rolado para a exibição.

Essa descrição pode parecer um pouco complicada, mas é realmente bastante simples e intuitiva depois de brincar com ele - vá conferir! Se você estiver interessado em saber os detalhes de como ele funciona sob o capô, consulte docs/design/ .

Metas

• Plug-and-play. Copie os arquivos, soltar <script type="module" src="/deeplinks/deeplinks.js"></script> no seu site e funciona.
• Robusto. As atualizações não quebram links para URLs mais antigos.
• Links curtos. Os URLs longos são feios e freqüentemente mutilados por aplicativos de mensagens. Os URLs devem ser curtos e não conter caracteres que sejam mutilados por aplicativos de comportamento incorreto.
• Sutil. Não deve entrar no caminho do leitor. Não quebra os links normais do identificador de fragmento.
• Razoavelmente pequeno. Está em torno de 1,7 kb de gzi agora (1,6kb brotli) e não deve crescer muito mais.
• Rápido. Isso não é difícil, mas vale a pena tornar explícito.

Não-objetivos

• Lidar com conteúdo frequentemente em mudança, como wikis. Deve ser robusto para edições pequenas ocasionais, mas se você quiser uma ligação realmente robusta, realmente precisa de apoio do ambiente de autoria (CRDTS etc.).
• Trabalhando para cada USECASE. Tenho coisas específicas que quero em um script como este, e outras pessoas terão outras coisas que desejam. Essas pessoas devem construir seus próprios scripts semelhantes - a diversidade é boa! Por exemplo, isso intencionalmente não implementa a interface de fragmento de texto do WICG, embora seja possível que no futuro seja padronizado em um formulário que eu gosto.

Instalação

Primeiro, considere se você realmente quer fazer isso. Se o fizer, você está fazendo novos URLs, que quebrarão se você remover o script do seu site. Quebrar URLs me deixa triste, então você deve pensar se está realmente comprometido com isso ou não, e talvez brincar com ele localmente por um tempo para ver como se sente antes de realmente implantá -lo.

Depois de ter certeza:

• Faça o download do lançamento mais recente da página de lançamentos.
• Extraia o arquivo zip em algum lugar do seu site.
• Inclua o script em qualquer lugar do seu HTML:

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

  Isso pressupõe que você extraiu a versão para um diretório chamado deeplinks - você precisará alterar o src se colocá -lo em outro lugar. Certifique -se de incluir o type="module" , ele não funcionará de outra forma! Você deve incluí -lo apenas nas páginas que não mudam com frequência - principalmente, não o inclua em páginas de paginação em que o conteúdo muda ao publicar novas postagens, por exemplo.
• Teste que funciona.
• Se você estiver se sentindo bem, preencha este formulário com um link para o seu site! (Ou apenas me envie um email, se você não gosta de formulários do Google)