ghost-giscus-plugin प्रीव्यू

डिफ़ॉल्ट रूप से, इस प्लगइन ने इस पेज की टिप्पणियों को लेख के मुख्य भाग के ठीक बाद रखा है। बाएँ पैनल में स्थान, पैडिंग और यह कि सब्सक्राइबर टिप्पणी क्षेत्र मौजूद है या नहीं, बदलें और असली टिप्पणियाँ उसी के अनुसार खिसक जाती हैं।

परिचय

पेज पर जिस भी तत्व में giscus क्लास हो, giscus उसमें टिप्पणियाँ माउंट कर देता है। यह प्लगइन बस उस तत्व को आपकी मनचाही जगह पर बना देता है। टिप्पणियों का असली काम और भंडारण अब भी giscus और GitHub Discussions ही संभालते हैं, इसलिए कुछ भी नए सिरे से नहीं बनाया जाता।

इंस्टॉलेशन

Ghost में, नीचे दी गई दोनों स्क्रिप्ट को सेटिंग्स, code injection, साइट फ़ुटर में पेस्ट करें। पहली यह प्लगइन है; दूसरी आधिकारिक giscus टैग है।

<script src="https://cdn.jsdelivr.net/gh/GreedyLabs/ghost-giscus-plugin@1/giscus-mount.min.js"
        data-target=".gh-content"
        data-place="after"
        data-class="gh-comments gh-canvas"
        data-padding-bottom="48"></script>

<script src="https://giscus.app/client.js"
        data-repo="[YOUR REPO]"
        data-repo-id="[REPO ID]"
        data-category="[CATEGORY]"
        data-category-id="[CATEGORY ID]"
        data-mapping="pathname"
        data-theme="preferred_color_scheme"
        crossorigin="anonymous"
        async></script>

क्रम मायने रखता है

यह प्लगइन giscus स्क्रिप्ट से पहले आना चाहिए। giscus चलते ही उसी क्षण तय कर लेता है कि कहाँ माउंट करना है, यह देखकर कि giscus तत्व मौजूद है या नहीं, इसलिए हमारी स्क्रिप्ट को पहले वह जगह बना देनी होती है। क्रम उल्टा हो जाए तो टिप्पणियाँ स्क्रिप्ट टैग की जगह पर आ जाती हैं।

विकल्प

सारा व्यवहार स्क्रिप्ट टैग की ऑप्शन से सेट होता है: किस तत्व को आधार बनाना है (data-target), उसके सापेक्ष कहाँ जोड़ना है (data-place: replace, append, prepend, before, after इन पाँच में से एक), माउंट रैपर पर जोड़ी जाने वाली क्लास (data-class, स्पेस से अलग करके कई दी जा सकती हैं ताकि आपकी थीम की स्टाइल विरासत में मिले), और चारों ओर की पैडिंग (data-padding-top, data-padding-right, data-padding-bottom, data-padding-left, इकाई px)। जब आधार तत्व नहीं मिलता, तो एक पेज गार्ड giscus स्क्रिप्ट हटा देता है ताकि टिप्पणियाँ गलत जगह न लगें; इसे data-guard="false" से बंद करें।

data-target=".gh-content"
data-place="after"
data-class="gh-comments gh-canvas"
data-padding-bottom="48"

जगह चुनना

ज़्यादातर मामलों के लिए दो तरीके काफ़ी हैं: टिप्पणियों को लेख के ठीक बाद रखना, या किसी मौजूदा टिप्पणी ब्लॉक को बदल देना। दोनों को नीचे बारी-बारी से देखते हैं।

लेख के बाद रखना

अनुशंसित डिफ़ॉल्ट है data-target=".gh-content" data-place="after" data-class="gh-comments gh-canvas" data-padding-bottom="48"। यह लेख के मुख्य भाग (.gh-content) के ठीक बाद माउंट बिंदु बनाता है और थीम की gh-comments gh-canvas क्लास विरासत में लेता है, जिससे पैडिंग और चौड़ाई थीम के अनुरूप दिखती है। यह सबसे सुरक्षित विकल्प है क्योंकि लेख का मुख्य भाग हर पेज पर हमेशा मौजूद रहता है। केवल सदस्यों के लिए दिखने वाले, कभी-कभी छिप जाने वाले टिप्पणी क्षेत्र के विपरीत, यह लक्ष्य कभी गायब नहीं होता, इसलिए हर जगह एक जैसा व्यवहार करता है।

<script src="https://cdn.jsdelivr.net/gh/GreedyLabs/ghost-giscus-plugin@1/giscus-mount.min.js"
        data-target=".gh-content"
        data-place="after"
        data-class="gh-comments gh-canvas"
        data-padding-bottom="48"></script>

मौजूदा टिप्पणी ब्लॉक को बदलना

अगर आपकी थीम में पहले से टिप्पणी ब्लॉक है, तो उसकी जगह data-target=".gh-comments" data-place="replace" से दोबारा इस्तेमाल करें। यह थीम फ़ाइल को छुए बिना, केवल code injection से <div class="gh-comments gh-canvas giscus"></div> को हूबहू दोहरा देता है, इसलिए थीम द्वारा तय की गई स्थिति और स्टाइल आपको विरासत में मिल जाती है। जब कोई मेल खाता ब्लॉक मौजूद हो, तब इसे चुनें। सावधानी: Ghost की मूल टिप्पणियाँ केवल सदस्यों के लिए होती हैं, इसलिए उन्हें बंद करने वाली साइटों पर .gh-comments तत्व हो ही न, ऐसा संभव है। ऐसे में ऊपर वाला लेख के बाद रखने का डिफ़ॉल्ट इस्तेमाल करें।

<script src="https://cdn.jsdelivr.net/gh/GreedyLabs/ghost-giscus-plugin@1/giscus-mount.min.js"
        data-target=".gh-comments"
        data-place="replace"></script>

giscus सेटअप

रिपॉज़िटरी लिंक, कैटेगरी और repo-id जैसे मान आधिकारिक giscus साइट से आते हैं। वहाँ अपनी रिपॉज़िटरी दर्ज करें और यह पेस्ट करने के लिए तैयार giscus टैग बना देता है।

giscus.app पर कॉन्फ़िगर करें →

अक्सर पूछे जाने वाले प्रश्न

टिप्पणियाँ मेरी मनचाही जगह के बजाय स्क्रिप्ट टैग पर दिख रही हैं।

आपकी प्लगइन स्क्रिप्ट giscus स्क्रिप्ट के बाद है। उन्हें आपस में बदल दें ताकि यह प्लगइन पहले आए।

मैं टिप्पणियाँ सिर्फ़ कुछ पेजों पर चाहता हूँ।

आधार को ऐसे तत्व पर लगाएँ जो केवल उन्हीं पेजों पर मौजूद हो। जब सेलेक्टर किसी से मेल नहीं खाता तो प्लगइन कुछ नहीं करता, इसलिए data-target को केवल पोस्ट पर मौजूद तत्व पर लगाने से टिप्पणियाँ पोस्ट तक ही सीमित रहती हैं।

मैं अपनी थीम का टिप्पणी अंतर चाहता हूँ।

अगर नियम आपकी थीम की स्टाइलशीट में है, तो उसे विरासत में लेने के लिए data-class से उसकी क्लास जोड़ें; वरना data-padding-bottom से मान सीधे तय करें।

निष्कर्ष

यह एक हल्का उपकरण है जो आधिकारिक giscus को अछूता छोड़ देता है और बस उसे आपके लिए जगह पर रख देता है। एक लाइन और सही क्रम, और यह किसी भी साइट पर एक जैसा व्यवहार करता है।