deeplinks

deeplinks.js

يسمح deeplinks.js للأشخاص بالربط بسهولة مع أي اختيار نص على موقع الويب الخاص بك. إليك مثال على شكل واحد من هذه الروابط. إنه مخصص في الغالب للمدونات وغيرها من المواقع ، ولكنه لا يلعب نسبيًا للبيئة التي تعمل فيها.

يمكن للأشخاص اختيار النص على الموقع كما يفعل عادة ، وعندما يفعلون ذلك ، يتغير معرف الشظية (الشيء الذي يأتي بعد # في عنوان URL). إذا كانوا يريدون مشاركة النص الذي اختاروه ، فإنهم ببساطة ينسخون عنوان URL وإرساله إلى شخص ما. عندما يزور هذا الشخص عنوان URL ، سيتم اختيار نفس النص الذي تم اختياره في الأصل وتمريره إلى العرض.

قد يجعل هذا الوصف يبدو معقدًا بعض الشيء ، لكنه في الواقع بسيط للغاية وبديهي بمجرد اللعب به - اذهب إلى الخروج! إذا كنت مهتمًا بمعرفة تفاصيل كيفية عمله تحت الغطاء ، تحقق من docs/design/ .

الأهداف

• التوصيل والتشغيل. انسخ الملفات ، إسقاط <script type="module" src="/deeplinks/deeplinks.js"></script> في موقع الويب الخاص بك ، وهو يعمل.
• قوي. لن تقطع التحديثات الروابط إلى عناوين URL القديمة.
• روابط قصيرة. عناوين URL الطويلة قبيحة وغالبًا ما تكون مشوهة بواسطة تطبيقات المراسلة. يجب أن تكون عناوين URL قصيرة ولا تحتوي على شخصيات من المحتمل أن يتم تشويهها بواسطة تطبيقات سوء التصرف.
• دقيق. لا ينبغي أن تحصل في طريق القارئ. لا يكسر روابط الشظية العادية.
• صغيرة معقولة. إنه حوالي 1.7 كيلو بايت في الوقت الحالي (1.6 كيلو بايت بروتلي) ، ولا ينبغي أن ينمو أكثر من اللازم.
• سريع. هذا ليس صعبًا ، لكن الأمر يستحق جعل الصريح.

غير المميزين

• التعامل مع المحتوى المتغير بشكل متكرر ، مثل الويكي. يجب أن يكون من القوي إجراء تعديلات صغيرة من حين لآخر ، ولكن إذا كنت تريد ربطًا عميقًا قويًا حقًا ، فأنت بحاجة حقًا إلى دعم من بيئة التأليف (CRDTs ، إلخ).
• العمل لكل usecase. لدي أشياء محددة أريدها في نص مثل هذا ، وسيكون لدى الآخرين أشياء أخرى يريدونها. يجب على هؤلاء الأشخاص بناء نصوصهم الخاصة - التنوع جيد! على سبيل المثال ، لا ينفذ هذا عن قصد واجهة شظية نص WICG ، على الرغم من أنه من الممكن أنه قد يكون في المستقبل إذا انتهى الأمر بالتوحيد في شكل يعجبني.

تثبيت

أولاً ، فكر فيما إذا كنت تريد حقًا القيام بذلك. إذا قمت بذلك ، فأنت تقوم بإنشاء عناوين URL جديدة ، والتي ستنهار إذا قمت بإزالة البرنامج النصي من موقعك من أي وقت مضى. إن كسر عناوين URL يجعلني حزينًا ، لذلك يجب أن تفكر فيما إذا كنت ملتزمًا حقًا بهذا أم لا ، وربما تلعب معها محليًا لفترة قصيرة لمعرفة ما تشعر به قبل أن تنشره حقًا.

بمجرد أن تكون متأكدًا:

• قم بتنزيل أحدث إصدار من صفحة الإصدارات.
• استخراج ملف الرمز البريدي في مكان ما في موقع الويب الخاص بك.
• قم بتضمين البرنامج النصي في أي مكان في HTML الخاص بك:

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

  هذا يفترض أنك استخرجت الإصدار في دليل يسمى deeplinks - ستحتاج إلى تغيير src إذا وضعته في مكان آخر. تأكد من تضمين type="module" ، فلن يعمل بطريقة أخرى! يجب عليك تضمينها فقط على الصفحات التي لن تتغير بشكل متكرر - لا سيما ، لا تضمها على صفحات الترميز حيث يتغير المحتوى أثناء نشر منشورات جديدة ، على سبيل المثال.
• اختبار أنه يعمل.
• إذا كنت تشعر بالرضا ، املأ هذا النموذج برابط إلى موقع الويب الخاص بك! (أو فقط أرسل لي مراسلتي عبر البريد الإلكتروني ، إذا كنت لا تحب نماذج Google)