अपनी Jekyll साइट पर टिप्पणियाँ जोड़ें
यह FastComments की आधिकारिक Jekyll लाइब्रेरी है।
अपनी Jekyll साइट में लाइव कमेंटिंग, चैट और रिव्यू विजेट एम्बेड करें।
रिपॉज़िटरी
AI कोडिंग एजेंट 
अपने कोडिंग एजेंट को FastComments का वह संदर्भ दें जिसकी उसे आवश्यकता है - विजेट्स, कॉन्फ़िगरेशन, Secure SSO, REST API, और SDKs:
npx skills add fastcomments/skillsयह Claude Code, Codex, Cursor, Copilot, Gemini, और skills CLI द्वारा समर्थित हर अन्य एजेंट के साथ काम करता है।
लाइव डेमो
https://fastcomments.com/commenting-system-for-jekyll/ पर हर विजेट को लाइव आज़माएँ।
लाइव प्रदर्शनी
सार्वजनिक demo टेनेंट के विरुद्ध स्थानीय रूप से चल रहे हर टैग को देखने के लिए, रिपॉजिटरी को क्लोन करें और चलाएँ:
cd example
bundle install
bundle exec jekyll serveप्रत्येक विजेट का अपना पेज example/ के अंतर्गत होता है, जिसे आप सीधे अपनी Jekyll साइट में कॉपी कर सकते हैं।
इंस्टॉल करें
अपनी साइट के Gemfile में :jekyll_plugins ग्रुप में जेम जोड़ें:
group :jekyll_plugins do
gem "fastcomments-jekyll"
endफिर:
bundle install(Jekyll 3.7+ और 4.x के साथ संगत।)
क्विक स्टार्ट
अपनी tenant id एक बार _config.yml में सेट करें:
fastcomments:
tenant_id: demoफिर एक टैग जोड़ें जहाँ भी आप विजेट चाहते हैं — किसी लेआउट, पोस्ट या पेज में:
{% raw %}{% fastcomments %}{% endraw %}बस इतना ही। demo को अपनी FastComments tenant id से बदलें (इसे
Settings > API/SSO के अंतर्गत पाएं)।
टैग
| टैग | विवरण |
|---|---|
fastcomments | उत्तर, वोटिंग, मॉडरेशन और रीयलटाइम अपडेट के साथ लाइव कमेंटिंग |
fastcomments_comment_count | वर्तमान पेज के लिए कमेंट संख्या |
fastcomments_comment_count_bulk | एक सूची/इंडेक्स पेज पर कई पेजों के लिए कमेंट संख्या |
fastcomments_live_chat | रीयलटाइम स्ट्रीमिंग चैट विजेट |
fastcomments_collab_chat | सहयोगात्मक इनलाइन कमेंटिंग (टेक्स्ट एनोटेशन) |
fastcomments_image_chat | इमेज एनोटेशन कमेंट्स |
fastcomments_recent_comments | पूरी साइट के हाल के कमेंट्स |
fastcomments_recent_discussions | हाल में सक्रिय चर्चा थ्रेड्स |
fastcomments_reviews_summary | स्टार-रेटिंग समीक्षा सारांश |
fastcomments_top_pages | सबसे अधिक चर्चित पेज |
fastcomments_user_activity_feed | प्रति-उपयोगकर्ता गतिविधि फ़ीड |
उदाहरण
{% raw %}{# कमेंट संख्या। विजेट अपना लेबल स्वयं रेंडर करता है, जैसे "0 comments" #}
{% fastcomments_comment_count %}
{# लाइव चैट #}
{% fastcomments_live_chat %}
{# कोलैब चैट। CSS सेलेक्टर के साथ इसे एक कंटेंट एलिमेंट पर पॉइंट करें #}
<article id="post-body">
<p>Highlight me to leave a comment.</p>
</article>
{% fastcomments_collab_chat target="#post-body" %}
{# इमेज चैट। CSS सेलेक्टर के साथ इसे एक इमेज एलिमेंट पर पॉइंट करें #}
<img id="hero" src="/hero.jpg" alt="Hero image">
{% fastcomments_image_chat target="#hero" %}
{# समीक्षा सारांश #}
{% fastcomments_reviews_summary %}
{# उपयोगकर्ता गतिविधि फ़ीड। user id आवश्यक है #}
{% fastcomments_user_activity_feed user_id="demo:demo-user" %}
{# ब्लॉग इंडेक्स के लिए बल्क कमेंट संख्या #}
{% for post in site.posts %}
<a href="\{{ post.url }}">\{{ post.title }}</a>
<span class="fast-comments-count" data-fast-comments-url-id="\{{ post.url }}"></span>
{% endfor %}
{% fastcomments_comment_count_bulk %}{% endraw %}कॉन्फ़िगरेशन
कॉन्फ़िग तीन जगहों से आती है। बाद के स्रोत प्राथमिकता रखते हैं:
_config.ymlमेंfastcomments:कुंजी के अंतर्गत ग्लोबल डिफ़ॉल्ट।- पेज संदर्भ, पेज-स्कोप्ड विजेट्स के लिए स्वचालित रूप से प्राप्त (नीचे देखें)।
- टैग पर ही लिखे गए टैग एट्रिब्यूट्स।
इसलिए टैग पर दिया गया url_id पेज-प्राप्त मान को ओवरराइड करता है, जो किसी भी ग्लोबल डिफ़ॉल्ट को ओवरराइड करता है।
एट्रिब्यूट सिंटैक्स
एट्रिब्यूट्स snake_case में key=value जोड़े होते हैं:
{% raw %}{% fastcomments url_id="my-stable-id" readonly=true count=20 %}{% endraw %}- कोट किए गए मान (
"..."या'...') शाब्दिक स्ट्रिंग होते हैं। - बिना कोट के
true/falseबूलियन बन जाते हैं, और संख्याएँ नंबर बन जाती हैं। - बिना कोट के अन्य कुछ भी पेज संदर्भ से Liquid वेरिएबल के रूप में रिज़ॉल्व होता है, जैसे
url_id=page.slug। (Liquid टैग के एट्रिब्यूट्स के अंदर{% raw %}\{{ ... }}{% endraw %}को विस्तारित नहीं करता, इसलिए"{% raw %}\{{ page.slug }}{% endraw %}"के बजाय बिना कोट वालेpage.slugरूप का उपयोग करें।)
Snake_case एट्रिब्यूट और कॉन्फ़िग कुंजियाँ स्वचालित रूप से FastComments द्वारा अपेक्षित camelCase कुंजियों में मैप हो जाती हैं
(tenant_id → tenantId, url_id → urlId, page_title → pageTitle,
has_dark_background → hasDarkBackground, आदि)।
विजेट कॉन्फ़िगरेशन का कोई भी अन्य विकल्प
उसी तरह सीधे पास हो जाता है।
पेज-प्राप्त मान
पेज-स्कोप्ड विजेट्स (fastcomments, fastcomments_comment_count, fastcomments_live_chat,
fastcomments_collab_chat, fastcomments_image_chat) के लिए ये स्वचालित रूप से वर्तमान पेज से भर जाते हैं,
जब तक कि आप स्वयं उन्हें सेट न करें:
url_id←page.url(विज़िटिंग डोमेन से स्वतंत्र एक स्थिर पहचानकर्ता)url←site.url+page.url(केवल तब जबurl_config.ymlमें सेट हो)page_title←page.title
साइट-व्यापी विजेट्स (हाल की टिप्पणियाँ/चर्चाएँ, शीर्ष पेज, समीक्षा सारांश, उपयोगकर्ता गतिविधि फ़ीड, बल्क काउंट) किसी पेज से बंधे नहीं होते और ये मान प्राप्त नहीं करते।
EU डेटा रेज़िडेंसी
EU ग्राहक region: eu जोड़ते हैं, या तो ग्लोबली:
fastcomments:
tenant_id: your-tenant-id
region: euया प्रति टैग: {% raw %}{% fastcomments region="eu" %}{% endraw %}। विजेट्स तब EU CDN से लोड होते हैं।
रखरखाव स्थिति
ये कंपोनेंट्स हमारे मुख्य VanillaJS कंपोनेंट्स के रैपर हैं। हम इन कंपोनेंट्स को स्वचालित रूप से अपडेट कर सकते हैं (बग ठीक करना, फीचर्स जोड़ना) बिना इस लाइब्रेरी को प्रकाशित किए, इसलिए भले ही यह कुछ समय तक प्रकाशित न हो, इसका मतलब यह नहीं है कि FastComments सक्रिय विकास में नहीं है! अपडेट के लिए हमारे ब्लॉग को देखने के लिए स्वतंत्र महसूस करें। अंतर्निहित मुख्य लाइब्रेरी में ब्रेकिंग API परिवर्तन या फीचर्स कभी भी इस लाइब्रेरी में वर्जन बंप किए बिना शिप नहीं किए जाएंगे।
मदद चाहिए?
यदि आपको Jekyll Library के बारे में कोई समस्या आती है या कोई प्रश्न है, तो कृपया:
योगदान देना
योगदान का स्वागत है! कृपया योगदान दिशानिर्देशों के लिए GitHub रिपॉजिटरी देखें।