deeplinks

deeplinks.js

deeplinks.js ช่วยให้ผู้คนสามารถเชื่อมโยงโดยตรงกับการเลือกข้อความใด ๆ บนเว็บไซต์ของคุณได้อย่างง่ายดาย นี่คือตัวอย่างของลิงค์เหล่านี้ที่มีลักษณะอย่างไร มันมีไว้สำหรับบล็อกและเว็บไซต์อื่น ๆ ส่วนใหญ่ แต่มันค่อนข้างไม่เชื่อเรื่องพระเจ้าสำหรับสภาพแวดล้อมที่ทำงานอยู่

ผู้คนสามารถเลือกข้อความบนไซต์ตามปกติและเมื่อพวกเขาทำตัวระบุแฟรกเมนต์ (สิ่งที่เกิดขึ้นหลังจาก # ใน URL) เปลี่ยนแปลง หากพวกเขาต้องการแบ่งปันข้อความที่พวกเขาเลือกพวกเขาเพียงแค่คัดลอก URL และส่งให้ใครบางคน เมื่อบุคคลนั้นเข้าชม URL ข้อความเดียวกับที่เลือกไว้เดิมจะถูกเลือกและเลื่อนเข้าไปในมุมมอง

คำอธิบายนี้อาจทำให้มันดูซับซ้อนเล็กน้อย แต่จริงๆแล้วมันค่อนข้างง่ายและใช้งานง่ายเมื่อคุณเล่นกับมัน - ไปตรวจสอบ! หากคุณสนใจที่จะทราบรายละเอียดของวิธีการทำงานภายใต้ประทุนลองดู docs/design/

เป้าหมาย

• ปลั๊กแอนด์เพลย์ คัดลอกไฟล์ drop <script type="module" src="/deeplinks/deeplinks.js"></script> ในเว็บไซต์ของคุณและมันใช้งานได้
• แข็งแกร่ง การอัปเดตจะไม่ทำลายลิงก์ไปยัง URL ที่เก่ากว่า
• ลิงค์สั้น ๆ URL ที่ยาวนานนั้นน่าเกลียดและมีการจัดการกับแอพส่งข้อความบ่อยครั้ง URL ควรสั้นและไม่มีตัวละครที่มีแนวโน้มที่จะได้รับการจัดการโดยแอพที่ทำงานผิดปกติ
• บอบบาง มันไม่ควรไปในทางของผู้อ่าน มันไม่ได้ทำลายลิงก์ที่ระบุตัวตนโดยทั่วไป
• เล็กพอสมควร ตอนนี้ประมาณ 1.7kb gzipped (1.6kb brotli) และไม่ควรเติบโตมากเกินไป
• เร็ว. นี่ไม่ยาก แต่ก็คุ้มค่าที่จะทำให้ชัดเจน

ผู้ที่ไม่ได้ไป

• การจัดการเนื้อหาที่เปลี่ยนแปลงบ่อยเช่น Wikis มันควรจะแข็งแกร่งในการแก้ไขเล็ก ๆ น้อย ๆ แต่ถ้าคุณต้องการการเชื่อมโยงที่ลึกซึ้งอย่างแท้จริงคุณต้องการการสนับสนุนจากสภาพแวดล้อมการเขียน (CRDT ฯลฯ )
• ทำงานให้กับ usecase ทุกครั้ง ฉันมีสิ่งเฉพาะที่ฉันต้องการในสคริปต์เช่นนี้และคนอื่น ๆ จะมีสิ่งอื่น ๆ ที่พวกเขาต้องการ คนเหล่านั้นควรสร้างสคริปต์ที่คล้ายกันของตัวเอง - ความหลากหลายเป็นสิ่งที่ดี! ตัวอย่างเช่นสิ่งนี้โดยเจตนาไม่ได้ใช้อินเทอร์เฟซแฟรกเมนต์ข้อความ WICG แม้ว่ามันจะเป็นไปได้ในอนาคตหากมันจบลงด้วยมาตรฐานในรูปแบบที่ฉันชอบ

การติดตั้ง

ก่อนอื่นให้พิจารณาว่าคุณต้องการทำสิ่งนี้หรือไม่ ถ้าคุณทำคุณกำลังสร้าง URL ใหม่ซึ่งจะแตกหักหากคุณเคยลบสคริปต์ออกจากเว็บไซต์ของคุณ การทำลาย URL ทำให้ฉันเศร้าดังนั้นคุณควรคิดว่าคุณมุ่งมั่นที่จะทำสิ่งนี้หรือไม่และอาจเล่นกับมันในท้องถิ่นสักครู่เพื่อดูว่ามันรู้สึกอย่างไรก่อนที่คุณจะปรับใช้

เมื่อคุณแน่ใจ:

• ดาวน์โหลดรุ่นล่าสุดจากหน้าเผยแพร่
• แยกไฟล์ zip ที่ไหนสักแห่งในเว็บไซต์ของคุณ
• รวมสคริปต์ทุกที่ใน HTML ของคุณ:

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

  สิ่งนี้จะถือว่าคุณสกัดการเปิดตัวลงในไดเรกทอรีที่เรียกว่า deeplinks - คุณจะต้องเปลี่ยน src หากคุณใส่ไว้ที่อื่น ตรวจสอบให้แน่ใจว่าคุณรวม type="module" มันจะไม่ทำงานเป็นอย่างอื่น! คุณควรรวมไว้ในหน้าเว็บที่จะไม่เปลี่ยนแปลงบ่อย ๆ - โดยเฉพาะอย่างยิ่งอย่ารวมไว้ในหน้าการแบ่งหน้าซึ่งเนื้อหาเปลี่ยนแปลงในขณะที่คุณเผยแพร่โพสต์ใหม่เช่น
• ทดสอบว่ามันใช้งานได้
• หากคุณรู้สึกดีกรอกแบบฟอร์มนี้ด้วยลิงก์ไปยังเว็บไซต์ของคุณ! (หรือเพียงแค่ส่งอีเมลถึงฉันถ้าคุณไม่ชอบ Google Forms)