// Giscus comment system integration script for Mintlify (SPA-aware) (function() { 'use strict'; // // Auto-generated by scripts/generate-giscus-path-map.py — do not edit by hand. // Maps docs pathname (no leading slash) -> GitHub Discussion number. // Used with giscus data-mapping="number" to bypass broken GitHub discussion search. const GISCUS_PATH_MAP = { "agent-tools/cloud": 1134, "agent-tools/in-app-agent": 1801, "agent-tools/mcp": 1457, "agent-tools/partner-mcp": 1199, "agent-tools/skills": 1555, "basic-concepts/dependencies": 1562, "basic-concepts/links": 1558, "basic-concepts/models": 1559, "basic-concepts/nodes": 1556, "basic-concepts/properties": 1557, "basic-concepts/workflow": 1561, "built-in-nodes/CreateList": 1108, "built-in-nodes/CreateVideo": 1669, "built-in-nodes/EmptyLatentImage": 1682, "built-in-nodes/SaveImage": 1355, "built-in-nodes/TripoConversionNode": 1127, "built-in-nodes/VAEEncode": 1681, "built-in-nodes/api-node/image/openai/openai-gpt-image1": 289, "built-in-nodes/api-node/video/google/google-veo2-video": 288, "built-in-nodes/api-node/video/pixverse/pixverse-text-to-video": 367, "built-in-nodes/overview": 513, "built-in-nodes/partner-node/video/minimax/minimax-text-to-video": 1372, "changelog": 619, "cloud/import-models": 1157, "cloud/share-workflow": 1323, "comfy-cli/getting-started": 436, "comfy-cli/troubleshooting": 306, "community/contributing": 398, "community/links": 1154, "custom-nodes/backend/datatypes": 620, "custom-nodes/backend/expansion": 605, "custom-nodes/backend/images_and_masks": 537, "custom-nodes/backend/lists": 532, "custom-nodes/backend/more_on_inputs": 538, "custom-nodes/backend/server_overview": 541, "custom-nodes/help_page": 687, "custom-nodes/js/javascript_hooks": 634, "custom-nodes/js/javascript_objects_and_hijacking": 621, "custom-nodes/js/javascript_overview": 1119, "custom-nodes/js/javascript_topbar_menu": 626, "custom-nodes/overview": 539, "custom-nodes/v3_migration": 501, "custom-nodes/walkthrough": 426, "custom-nodes/workflow_templates": 463, "development/comfyui-server/api-key-integration": 624, "development/comfyui-server/comms_overview": 526, "development/comfyui-server/comms_routes": 527, "development/core-concepts/links": 657, "development/core-concepts/models": 540, "development/core-concepts/nodes": 547, "development/core-concepts/workflow": 378, "development/overview": 349, "get_started/cloud": 545, "get_started/first_generation": 1439, "get_started/introduction": 427, "installation/comfyui_portable_windows": 307, "installation/desktop/linux": 1630, "installation/desktop/overview": 1162, "installation/desktop/usage/instance-management": 1141, "installation/desktop/windows": 335, "installation/install_custom_node": 269, "installation/manual_install": 408, "installation/system_requirements": 267, "interface/credits": 429, "interface/features/partial-execution": 339, "interface/features/subgraph": 338, "interface/features/template": 546, "interface/maskeditor": 1065, "interface/nodes-2": 614, "interface/settings/3d": 559, "interface/settings/lite-graph": 1135, "interface/settings/mask-editor": 502, "interface/settings/server-config": 564, "interface/shortcuts": 560, "interface/user": 413, "manager/pack-management": 1768, "registry/overview": 484, "specs/nodedef_json": 607, "specs/workflow_json": 342, "support/contact-support": 1512, "support/subscription/canceling": 625, "support/subscription/subscribing": 1486, "troubleshooting/custom-node-issues": 1560, "troubleshooting/overview": 1816, "tutorials/3d/hunyuan3D-2": 580, "tutorials/3d/trellis2": 1869, "tutorials/3d/triposplat": 1580, "tutorials/api-nodes/overview": 410, "tutorials/api-nodes/runway/image-generation": 321, "tutorials/api-nodes/stability-ai/stable-audio": 419, "tutorials/audio/ace-step/ace-step-v1": 531, "tutorials/audio/ace-step/ace-step-v1-5": 1128, "tutorials/basic/image-to-image": 567, "tutorials/basic/inpaint": 534, "tutorials/basic/lora": 572, "tutorials/basic/multiple-loras": 276, "tutorials/basic/outpaint": 402, "tutorials/basic/text-to-image": 272, "tutorials/basic/upscale": 571, "tutorials/controlnet/controlnet": 574, "tutorials/controlnet/depth-controlnet": 576, "tutorials/controlnet/mixing-controlnets": 584, "tutorials/controlnet/pose-controlnet-2-pass": 577, "tutorials/flux/flux-1-controlnet": 673, "tutorials/flux/flux-1-fill-dev": 323, "tutorials/flux/flux-1-kontext-dev": 282, "tutorials/flux/flux-1-text-to-image": 274, "tutorials/flux/flux-1-uso": 592, "tutorials/flux/flux-2-dev": 676, "tutorials/flux/flux1-krea-dev": 316, "tutorials/image/cosmos/cosmos-predict2-t2i": 678, "tutorials/image/hidream/hidream-e1": 278, "tutorials/image/hidream/hidream-o1": 1100, "tutorials/image/krea/krea-2": 1192, "tutorials/image/omnigen/omnigen2": 317, "tutorials/image/ovis/ovis-image": 637, "tutorials/image/qwen/qwen-image": 327, "tutorials/image/qwen/qwen-image-2-1": 1760, "tutorials/image/qwen/qwen-image-edit": 550, "tutorials/image/qwen/qwen-image-layered": 667, "tutorials/image/z-image/z-image-turbo": 595, "tutorials/partner-nodes/faq": 658, "tutorials/partner-nodes/image/overview": 1553, "tutorials/partner-nodes/pricing": 1359, "tutorials/utility/image-upscale": 1474, "tutorials/utility/sam3d-body": 1672, "tutorials/utility/seedvr2": 1440, "tutorials/utility/video-segment-sam3": 1110, "tutorials/video/hunyuan/hunyuan-video-1-5": 586, "tutorials/video/kandinsky/kandinsky-5": 1363, "tutorials/video/ltx/ltx-2-3": 1736, "tutorials/video/ltx/ltx-2-5": 1735, "tutorials/video/ltxv": 606, "tutorials/video/minimax/minimax-h3": 1344, "tutorials/video/minimax/minimax-h3-prompt-guide": 1808, "tutorials/video/wan/wan-ati": 301, "tutorials/video/wan/wan-video": 348, "tutorials/video/wan/wan2-2-animate": 439, "tutorials/video/wan/wan2-2-fun-camera": 368, "tutorials/video/wan/wan2-2-fun-control": 360, "tutorials/video/wan/wan2-2-fun-inp": 358, "tutorials/video/wan/wan2-2-s2v": 396, "tutorials/video/wan/wan2_2": 291, "zh-CN/custom-nodes/backend/server_overview": 298, "zh-CN/custom-nodes/help_page": 490, "zh-CN/custom-nodes/i18n": 440, "zh-CN/custom-nodes/js/javascript_commands_keybindings": 505, "zh-CN/development/comfyui-server/comms_routes": 654, "zh-CN/development/core-concepts/custom-nodes": 417, "zh-CN/development/core-concepts/dependencies": 453, "zh-CN/development/core-concepts/links": 451, "zh-CN/development/core-concepts/models": 452, "zh-CN/development/core-concepts/nodes": 645, "zh-CN/development/core-concepts/properties": 362, "zh-CN/development/overview": 608, "zh-CN/get_started/cloud": 520, "zh-CN/installation/comfyui_portable_windows": 447, "zh-CN/installation/desktop/linux": 446, "zh-CN/installation/desktop/macos": 445, "zh-CN/installation/install_custom_node": 449, "zh-CN/installation/manual_install": 448, "zh-CN/installation/system_requirements": 407, "zh-CN/installation/update_comfyui": 450, "zh-CN/interface/credits": 430, "zh-CN/interface/features/partial-execution": 456, "zh-CN/interface/features/subgraph": 455, "zh-CN/interface/features/template": 454, "zh-CN/interface/overview": 433, "zh-CN/interface/settings/lite-graph": 660, "zh-CN/troubleshooting/custom-node-issues": 304, "zh-CN/troubleshooting/model-issues": 343, "zh-CN/tutorials/3d/hunyuan3D-2": 415, "zh-CN/tutorials/api-nodes/google/gemini": 399, "zh-CN/tutorials/api-nodes/overview": 425, "zh-CN/tutorials/api-nodes/pricing": 421, "zh-CN/tutorials/audio/ace-step/ace-step-v1": 481, "zh-CN/tutorials/basic/image-to-image": 457, "zh-CN/tutorials/basic/inpaint": 333, "zh-CN/tutorials/basic/lora": 459, "zh-CN/tutorials/basic/multiple-loras": 460, "zh-CN/tutorials/basic/outpaint": 458, "zh-CN/tutorials/basic/upscale": 279, "zh-CN/tutorials/controlnet/controlnet": 464, "zh-CN/tutorials/controlnet/depth-controlnet": 466, "zh-CN/tutorials/controlnet/depth-t2i-adapter": 467, "zh-CN/tutorials/controlnet/mixing-controlnets": 468, "zh-CN/tutorials/controlnet/pose-controlnet-2-pass": 465, "zh-CN/tutorials/flux/flux-1-controlnet": 472, "zh-CN/tutorials/flux/flux-1-fill-dev": 471, "zh-CN/tutorials/flux/flux-1-kontext-dev": 469, "zh-CN/tutorials/flux/flux-1-text-to-image": 470, "zh-CN/tutorials/flux/flux1-krea-dev": 322, "zh-CN/tutorials/image/cosmos/cosmos-predict2-t2i": 475, "zh-CN/tutorials/image/hidream/hidream-e1": 474, "zh-CN/tutorials/image/hidream/hidream-i1": 473, "zh-CN/tutorials/image/omnigen/omnigen2": 375, "zh-CN/tutorials/image/qwen/qwen-image": 336, "zh-CN/tutorials/image/qwen/qwen-image-edit": 372, "zh-CN/tutorials/image/z-image/z-image-turbo": 652, "zh-CN/tutorials/partner-nodes/faq": 549, "zh-CN/tutorials/video/cosmos/cosmos-predict2-video2world": 483, "zh-CN/tutorials/video/hunyuan-video": 477, "zh-CN/tutorials/video/ltxv": 476, "zh-CN/tutorials/video/wan/vace": 332, "zh-CN/tutorials/video/wan/wan-ati": 302, "zh-CN/tutorials/video/wan/wan-flf": 310, "zh-CN/tutorials/video/wan/wan-video": 482, "zh-CN/tutorials/video/wan/wan2-2-animate": 478, "zh-CN/tutorials/video/wan/wan2-2-fun-camera": 480, "zh-CN/tutorials/video/wan/wan2-2-fun-control": 479, "zh-CN/tutorials/video/wan/wan2-2-fun-inp": 369, "zh-CN/tutorials/video/wan/wan2_2": 303, "zh/changelog": 638, "zh/custom-nodes/backend/server_overview": 298, "zh/custom-nodes/help_page": 490, "zh/custom-nodes/i18n": 440, "zh/custom-nodes/js/javascript_commands_keybindings": 505, "zh/custom-nodes/overview": 649, "zh/development/comfyui-server/comms_routes": 654, "zh/development/core-concepts/custom-nodes": 417, "zh/development/core-concepts/dependencies": 453, "zh/development/core-concepts/links": 451, "zh/development/core-concepts/models": 452, "zh/development/core-concepts/nodes": 645, "zh/development/core-concepts/properties": 362, "zh/development/core-concepts/workflow": 444, "zh/development/overview": 608, "zh/get_started/cloud": 520, "zh/get_started/first_generation": 432, "zh/installation/comfyui_portable_windows": 447, "zh/installation/desktop/linux": 446, "zh/installation/desktop/macos": 445, "zh/installation/desktop/windows": 390, "zh/installation/install_custom_node": 449, "zh/installation/manual_install": 448, "zh/installation/system_requirements": 407, "zh/installation/update_comfyui": 450, "zh/interface/appearance": 656, "zh/interface/credits": 430, "zh/interface/features/partial-execution": 456, "zh/interface/features/subgraph": 455, "zh/interface/features/template": 454, "zh/interface/maskeditor": 347, "zh/interface/nodes-2": 613, "zh/interface/overview": 433, "zh/interface/settings/comfy": 659, "zh/interface/settings/lite-graph": 660, "zh/interface/settings/server-config": 661, "zh/interface/user": 639, "zh/troubleshooting/custom-node-issues": 304, "zh/troubleshooting/model-issues": 343, "zh/tutorials/3d/hunyuan3D-2": 415, "zh/tutorials/api-nodes/google/gemini": 399, "zh/tutorials/api-nodes/overview": 425, "zh/tutorials/api-nodes/pricing": 421, "zh/tutorials/audio/ace-step/ace-step-v1": 481, "zh/tutorials/basic/image-to-image": 457, "zh/tutorials/basic/inpaint": 333, "zh/tutorials/basic/lora": 459, "zh/tutorials/basic/multiple-loras": 460, "zh/tutorials/basic/outpaint": 458, "zh/tutorials/basic/text-to-image": 431, "zh/tutorials/basic/upscale": 279, "zh/tutorials/controlnet/controlnet": 464, "zh/tutorials/controlnet/depth-controlnet": 466, "zh/tutorials/controlnet/depth-t2i-adapter": 467, "zh/tutorials/controlnet/mixing-controlnets": 468, "zh/tutorials/controlnet/pose-controlnet-2-pass": 465, "zh/tutorials/flux/flux-1-controlnet": 472, "zh/tutorials/flux/flux-1-fill-dev": 471, "zh/tutorials/flux/flux-1-kontext-dev": 469, "zh/tutorials/flux/flux-1-text-to-image": 470, "zh/tutorials/flux/flux-1-uso": 401, "zh/tutorials/flux/flux1-krea-dev": 322, "zh/tutorials/image/cosmos/cosmos-predict2-t2i": 475, "zh/tutorials/image/hidream/hidream-e1": 474, "zh/tutorials/image/hidream/hidream-i1": 473, "zh/tutorials/image/omnigen/omnigen2": 375, "zh/tutorials/image/qwen/qwen-image": 336, "zh/tutorials/image/qwen/qwen-image-edit": 372, "zh/tutorials/image/qwen/qwen-image-edit-2511": 671, "zh/tutorials/image/z-image/z-image-turbo": 652, "zh/tutorials/partner-nodes/faq": 549, "zh/tutorials/video/cosmos/cosmos-predict2-video2world": 483, "zh/tutorials/video/hunyuan-video": 477, "zh/tutorials/video/ltxv": 476, "zh/tutorials/video/wan/vace": 332, "zh/tutorials/video/wan/wan-ati": 302, "zh/tutorials/video/wan/wan-flf": 310, "zh/tutorials/video/wan/wan-video": 482, "zh/tutorials/video/wan/wan2-2-animate": 478, "zh/tutorials/video/wan/wan2-2-fun-camera": 480, "zh/tutorials/video/wan/wan2-2-fun-control": 479, "zh/tutorials/video/wan/wan2-2-fun-inp": 369, "zh/tutorials/video/wan/wan2-2-s2v": 409, "zh/tutorials/video/wan/wan2_2": 303 }; // let currentPath = ''; let giscusLoaded = false; let intersectionObserver = null; let themeObserver = null; let loadingTimeout = null; let routeLoadTimer = null; let intersectionLoadTimer = null; const INITIAL_LOAD_DELAY_MS = 3200; const SPA_LOAD_DELAY_MS = 2200; const INTERSECTION_LOAD_DELAY_MS = 1200; const INTERSECTION_ROOT_MARGIN = '0px 0px 64px 0px'; const CONTENT_STABILITY_CHECK_INTERVAL_MS = 250; const CONTENT_STABILITY_REQUIRED_MS = 1000; const CONTENT_STABILITY_MAX_WAIT_MS = 5000; // Add CSS styles once function addStyles() { if (document.querySelector('#giscus-styles')) return; const style = document.createElement('style'); style.id = 'giscus-styles'; style.textContent = ` .giscus-container { margin-top: 3rem; padding-top: 2rem; border-top: 1px solid var(--border-color, #e5e7eb); max-width: none !important; width: 100%; box-sizing: border-box; clear: both; position: relative; z-index: 1; } /* Responsive design and sidebar conflict prevention */ .giscus-container .giscus, .giscus-container .giscus-frame { max-width: 100% !important; width: 100% !important; } /* Ensure proper width within content area */ main .giscus-container { max-width: calc(100vw - 300px); /* Account for sidebar */ } @media (max-width: 1024px) { main .giscus-container { max-width: 100%; } } @media (max-width: 768px) { .giscus-container { margin-left: -1rem; margin-right: -1rem; padding-left: 1rem; padding-right: 1rem; } } /* Hide giscus container initially to prevent flash */ .giscus-container.loading { opacity: 0; transition: opacity 0.3s ease; } .giscus-container.loaded { opacity: 1; } /* Lazy loading placeholder */ .giscus-placeholder { min-height: 200px; display: flex; align-items: center; justify-content: center; color: var(--text-muted, #666); font-size: 0.875rem; border: 1px dashed var(--border-color, #e5e7eb); border-radius: 8px; margin: 1rem 0; cursor: pointer; transition: all 0.2s ease; } .giscus-placeholder:hover { background: var(--hover-bg, #f9fafb); border-color: var(--primary-color, #3b82f6); } .giscus-placeholder-content { text-align: center; line-height: 1.5; } .giscus-placeholder-icon { font-size: 2rem; margin-bottom: 0.5rem; opacity: 0.5; } /* Discussion notice styling */ .giscus-notice { background: var(--notice-bg, #f8fafc); border: 1px solid var(--notice-border, #e2e8f0); border-radius: 8px; padding: 1rem; margin: 1rem 0; color: var(--notice-text, #475569); font-size: 0.875rem; line-height: 1.5; } .giscus-notice-title { font-weight: 600; margin-bottom: 0.5rem; color: var(--notice-title, #334155); } .giscus-notice-button { background: var(--primary-color, #3b82f6); color: white; border: none; border-radius: 4px; padding: 0.5rem 1rem; cursor: pointer; font-size: 0.875rem; text-decoration: none; display: inline-flex; align-items: center; transition: background-color 0.2s ease; } .giscus-notice-button:hover { background: var(--primary-color-hover, #2563eb); } .giscus-notice-button.secondary { background: var(--secondary-color, #6b7280); } .giscus-notice-button.secondary:hover { background: var(--secondary-color-hover, #4b5563); } /* Dark mode notice styling */ @media (prefers-color-scheme: dark) { .giscus-notice { background: var(--notice-bg-dark, #1e293b); border-color: var(--notice-border-dark, #334155); color: var(--notice-text-dark, #94a3b8); } .giscus-notice-title { color: var(--notice-title-dark, #e2e8f0); } } [data-theme="dark"] .giscus-notice, .dark .giscus-notice { background: var(--notice-bg-dark, #1e293b); border-color: var(--notice-border-dark, #334155); color: var(--notice-text-dark, #94a3b8); } [data-theme="dark"] .giscus-notice-title, .dark .giscus-notice-title { color: var(--notice-title-dark, #e2e8f0); } `; document.head.appendChild(style); } // Remove existing giscus instances function cleanupGiscus() { const existingContainers = document.querySelectorAll('.giscus-container'); existingContainers.forEach(container => container.remove()); // Also remove any orphaned giscus elements const giscusElements = document.querySelectorAll('.giscus, giscus-widget, [class*="giscus"]'); giscusElements.forEach(el => { if (!el.closest('.giscus-container')) { el.remove(); } }); // Clean up observers if (intersectionObserver) { intersectionObserver.disconnect(); intersectionObserver = null; } if (themeObserver) { themeObserver.disconnect(); themeObserver = null; } if (loadingTimeout) { clearTimeout(loadingTimeout); loadingTimeout = null; } if (routeLoadTimer) { clearTimeout(routeLoadTimer); routeLoadTimer = null; } if (intersectionLoadTimer) { clearTimeout(intersectionLoadTimer); intersectionLoadTimer = null; } giscusLoaded = false; } // Create placeholder for lazy loading function createGiscusPlaceholder() { const isChinesePage = window.location.pathname.includes('/zh/') || window.location.pathname.includes('/cn/'); const placeholderText = isChinesePage ? '💬 点击或滚动到此处加载评论' : '💬 Click or scroll here to load comments'; const placeholder = document.createElement('div'); placeholder.className = 'giscus-placeholder'; placeholder.innerHTML = `

💬

${placeholderText}

`; // Click to load placeholder.addEventListener('click', () => { loadGiscusContent(placeholder.parentElement); }); return placeholder; } // Setup intersection observer for lazy loading function setupLazyLoading(container) { if (!window.IntersectionObserver || giscusLoaded) return; intersectionObserver = new IntersectionObserver((entries) => { entries.forEach(entry => { if (entry.isIntersecting && !giscusLoaded) { if (!intersectionLoadTimer) { intersectionLoadTimer = setTimeout(() => { intersectionLoadTimer = null; if (giscusLoaded) return; loadGiscusContent(container); if (intersectionObserver) { intersectionObserver.disconnect(); intersectionObserver = null; } }, INTERSECTION_LOAD_DELAY_MS); } } else if (intersectionLoadTimer) { clearTimeout(intersectionLoadTimer); intersectionLoadTimer = null; } }); }, { rootMargin: INTERSECTION_ROOT_MARGIN, threshold: 0.15 }); intersectionObserver.observe(container); } function waitForWindowLoad() { if (document.readyState === 'complete') { return Promise.resolve(); } return new Promise((resolve) => { window.addEventListener('load', resolve, { once: true }); }); } function waitForNextPaint() { return new Promise((resolve) => { requestAnimationFrame(() => { requestAnimationFrame(resolve); }); }); } async function waitForPageContentStability() { await waitForWindowLoad(); await waitForNextPaint(); const contentRoot = document.querySelector('.mdx-content.prose, .mdx-content, main, [role="main"]'); if (!contentRoot) return; await new Promise((resolve) => { const startedAt = Date.now(); let stableForMs = 0; let previousSignature = ''; const checkStability = () => { const signature = [ contentRoot.childElementCount, contentRoot.scrollHeight, contentRoot.clientHeight, (contentRoot.textContent || '').trim().length ].join(':'); if (signature === previousSignature) { stableForMs += CONTENT_STABILITY_CHECK_INTERVAL_MS; } else { stableForMs = 0; previousSignature = signature; } const waitedTooLong = Date.now() - startedAt >= CONTENT_STABILITY_MAX_WAIT_MS; if (stableForMs >= CONTENT_STABILITY_REQUIRED_MS || waitedTooLong) { resolve(); return; } setTimeout(checkStability, CONTENT_STABILITY_CHECK_INTERVAL_MS); }; checkStability(); }); } function scheduleGiscusLoad(delayMs) { const scheduledPath = window.location.pathname; if (routeLoadTimer) { clearTimeout(routeLoadTimer); } routeLoadTimer = setTimeout(async () => { routeLoadTimer = null; if (window.location.pathname !== scheduledPath) return; await waitForPageContentStability(); if (window.location.pathname !== scheduledPath) return; loadGiscus(); }, delayMs); } // Find the best content container for giscus function findContentContainer() { // Wait for content to be ready return new Promise((resolve) => { let attempts = 0; const maxAttempts = 20; function tryFind() { // Specific selectors for Mintlify content structure const selectors = [ // Mintlify main content container - this is the key one! '.mdx-content.prose', '.mdx-content', // Fallback selectors 'main [class*="prose"]:not([class*="nav"]):not([class*="sidebar"])', 'main article:not([class*="nav"])', 'main > div > div:last-child', // Common Mintlify structure '[role="main"] > div:last-child', 'main .content', 'main' ]; for (const selector of selectors) { const elements = document.querySelectorAll(selector); for (const element of elements) { const textContent = element.textContent?.trim() || ''; const noExistingGiscus = !element.querySelector('.giscus-container'); // Special handling for .mdx-content - this is our primary target if (element.classList.contains('mdx-content')) { if (textContent.length > 50 && noExistingGiscus) { console.log('Giscus: Found mdx-content container', element); resolve(element); return; } } else { // Stricter requirements for other selectors const hasSubstantialContent = textContent.length > 200; const notNavigation = !element.closest('[class*="nav"], nav, .sidebar'); if (hasSubstantialContent && notNavigation && noExistingGiscus) { console.log('Giscus: Found content container', selector, element); resolve(element); return; } } } } attempts++; if (attempts < maxAttempts) { setTimeout(tryFind, 250); } else { resolve(null); } } tryFind(); }); } // Get current theme from Mintlify function getCurrentTheme() { // Check for Mintlify's theme class on html or body const html = document.documentElement; const body = document.body; // Mintlify typically uses data attributes or classes if (html.classList.contains('dark') || body.classList.contains('dark')) { return 'dark'; } else if (html.classList.contains('light') || body.classList.contains('light')) { return 'light'; } else if (html.dataset.theme === 'dark' || body.dataset.theme === 'dark') { return 'dark'; } else if (html.dataset.theme === 'light' || body.dataset.theme === 'light') { return 'light'; } // Fallback to system preference return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'; } // Update giscus theme function updateGiscusTheme(theme) { const giscusFrame = document.querySelector('iframe.giscus-frame'); if (giscusFrame) { const message = { giscus: { setConfig: { theme: theme === 'dark' ? 'dark' : 'light' } } }; giscusFrame.contentWindow.postMessage(message, 'https://giscus.app'); } } // Set up theme change observer function setupThemeObserver() { // Don't create multiple observers if (themeObserver) { return; } // Watch for changes to the document element's attributes and classes themeObserver = new MutationObserver((mutations) => { let themeChanged = false; mutations.forEach((mutation) => { if (mutation.type === 'attributes' && (mutation.attributeName === 'class' || mutation.attributeName === 'data-theme' || mutation.attributeName === 'data-color-scheme')) { themeChanged = true; } }); if (themeChanged) { const newTheme = getCurrentTheme(); updateGiscusTheme(newTheme); } }); // Observe both html and body elements for theme changes themeObserver.observe(document.documentElement, { attributes: true, attributeFilter: ['class', 'data-theme', 'data-color-scheme'] }); themeObserver.observe(document.body, { attributes: true, attributeFilter: ['class', 'data-theme', 'data-color-scheme'] }); // Also listen for system theme changes const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)'); mediaQuery.addEventListener('change', () => { // Only update if no explicit theme is set const html = document.documentElement; const body = document.body; if (!html.classList.contains('dark') && !html.classList.contains('light') && !body.classList.contains('dark') && !body.classList.contains('light') && !html.dataset.theme && !body.dataset.theme) { const newTheme = getCurrentTheme(); updateGiscusTheme(newTheme); } }); } function normalizeGiscusPath(pathname) { let path = (pathname || '/').split('?')[0].split('#')[0] || '/'; if (path.length < 2) return 'index'; // Match giscus client.js pathname mapping: strip leading slash and file extension return path.substring(1).replace(/\.\w+$/, ''); } function getMappedDiscussionNumber(pathname) { // Strip trailing slash for map lookup only; unmapped pages keep raw pathname // so giscus pathname+strict behavior is unchanged when creating new threads. const term = normalizeGiscusPath(pathname).replace(/\/$/, ''); const direct = GISCUS_PATH_MAP[term]; if (direct) return direct; // Legacy zh-CN discussions when visiting /zh/... if (term.startsWith('zh/')) { const legacy = GISCUS_PATH_MAP['zh-CN/' + term.slice(3)]; if (legacy) return legacy; } return null; } // Generate GitHub Discussions URL for current page function generateDiscussionUrl() { const repoOwner = 'Comfy-Org'; const repoName = 'docs'; const mappedNumber = getMappedDiscussionNumber(window.location.pathname); if (mappedNumber) { return `https://github.com/${repoOwner}/${repoName}/discussions/${mappedNumber}`; } const currentPath = window.location.pathname; const currentTitle = document.title || 'Discussion'; // Extract meaningful part of the path for search const pathSegments = currentPath.split('/').filter(Boolean); let searchQuery = ''; if (pathSegments.length > 0) { // Keep the path shape; GitHub title search is unreliable, but this is // better than nothing when we have no mapped discussion number yet. searchQuery = pathSegments.join('/'); } // If no meaningful path, use page title if (!searchQuery && currentTitle) { searchQuery = currentTitle.replace(/[^\w\s]/g, '').trim(); } // Create search URL to find existing discussions if (searchQuery) { const encodedQuery = encodeURIComponent(searchQuery); return `https://github.com/${repoOwner}/${repoName}/discussions?discussions_q=${encodedQuery}`; } // Fallback to discussions main page return `https://github.com/${repoOwner}/${repoName}/discussions`; } // Show friendly discussion notice function showGiscusNotice(container, noticeType = 'rate_limit') { const discussionUrl = generateDiscussionUrl(); const noticeMessages = { rate_limit: { en: { title: '💬 Join the Discussion', message: 'Comments are temporarily unavailable due to high traffic.', suggestion: 'Retry loading comments, or check GitHub for an existing discussion about this page.', discussionLink: 'Find Related Discussions', retryLink: 'Retry Comments' }, zh: { title: '💬 参与讨论', message: '由于访问量较高，评论功能暂时不可用。', suggestion: '请重试加载评论，或前往 GitHub 查找此页面已有的讨论。', discussionLink: '查找相关讨论', retryLink: '重试评论' }, ja: { title: '💬 ディスカッションに参加', message: 'アクセスが集中しているため、コメント機能は一時的にご利用いただけません。', suggestion: 'コメントの再読み込みを試すか、GitHub でこのページに関する既存のディスカッションを確認してください。', discussionLink: '関連ディスカッションを検索', retryLink: 'コメントを再読み込み' }, ko: { title: '💬 토론에 참여하기', message: '접속량이 많아 댓글 기능을 일시적으로 사용할 수 없습니다.', suggestion: '댓글을 다시 불러오거나 GitHub에서 이 페이지의 기존 토론을 확인해 주세요.', discussionLink: '관련 토론 찾기', retryLink: '댓글 다시 불러오기' } }, network: { en: { title: '💬 Join the Discussion', message: 'Comments could not be loaded at this time.', suggestion: 'Retry loading comments, or check GitHub for an existing discussion about this page.', discussionLink: 'Find Related Discussions', retryLink: 'Retry Comments' }, zh: { title: '💬 参与讨论', message: '评论暂时无法加载。', suggestion: '请重试加载评论，或前往 GitHub 查找此页面已有的讨论。', discussionLink: '查找相关讨论', retryLink: '重试评论' }, ja: { title: '💬 ディスカッションに参加', message: 'コメントを読み込めませんでした。', suggestion: 'コメントの再読み込みを試すか、GitHub でこのページに関する既存のディスカッションを確認してください。', discussionLink: '関連ディスカッションを検索', retryLink: 'コメントを再読み込み' }, ko: { title: '💬 토론에 참여하기', message: '지금은 댓글을 불러올 수 없습니다.', suggestion: '댓글을 다시 불러오거나 GitHub에서 이 페이지의 기존 토론을 확인해 주세요.', discussionLink: '관련 토론 찾기', retryLink: '댓글 다시 불러오기' } } }; const isChinesePage = window.location.pathname.includes('/zh/') || window.location.pathname.includes('/cn/'); const isJapanesePage = window.location.pathname.includes('/ja/'); const isKoreanPage = window.location.pathname.includes('/ko/'); const lang = isKoreanPage ? 'ko' : isJapanesePage ? 'ja' : isChinesePage ? 'zh' : 'en'; const notice = noticeMessages[noticeType][lang]; const noticeDiv = document.createElement('div'); noticeDiv.className = 'giscus-notice'; noticeDiv.innerHTML = `

${notice.title}

${notice.message}

${notice.suggestion}

${notice.discussionLink}

`; noticeDiv.querySelector('[data-giscus-retry]').addEventListener('click', () => { window.retryGiscus(); }); // Remove any previously inserted notice to avoid duplicates, but keep the // original giscus iframe/content intact so false-positive detections don't // erase a successfully loaded comment widget. const existingNotice = container.querySelector('.giscus-notice'); if (existingNotice) { existingNotice.remove(); } container.appendChild(noticeDiv); container.classList.remove('loading'); container.classList.add('loaded'); } // Legacy retry function (may not be needed now) window.retryGiscus = function() { const container = document.querySelector('.giscus-container'); if (!container) return; // Simply reload the giscus content giscusLoaded = false; // Reset the loaded flag loadGiscusContent(container); }; // Listen for giscus messages to detect rate limit errors function setupGiscusErrorListener() { window.addEventListener('message', function(event) { if (event.origin !== 'https://giscus.app') return; const message = event.data; console.log('Giscus message received:', message); // Debug log const container = document.querySelector('.giscus-container'); if (!container) return; // Check for various error patterns if (message && message.giscus) { // Standard giscus error format if (message.giscus.error) { const errorType = message.giscus.error.type; console.warn('Giscus error detected:', errorType, message.giscus.error); if (errorType === 'rate_limit' || errorType === 'rate-limit' || errorType === 'RATE_LIMITED') { showGiscusNotice(container, 'rate_limit'); } else { showGiscusNotice(container, 'network'); } } // Check for discussion data with error indicators if (message.giscus.discussion === null && message.giscus.viewer === null) { // This might indicate a rate limit or auth issue console.warn('Giscus: No discussion data, possibly rate limited'); setTimeout(() => { if (container.querySelector('.giscus-frame')) { const iframe = container.querySelector('.giscus-frame'); if (iframe && iframe.contentDocument) { const errorElements = iframe.contentDocument.querySelectorAll('[class*="error"], [class*="Error"]'); if (errorElements.length > 0) { console.warn('Giscus: Error elements found in iframe'); showGiscusNotice(container, 'rate_limit'); } } } }, 3000); } } // Also check for direct error messages in the content if (typeof message === 'string' && message.includes('rate limit')) { console.warn('Giscus: Rate limit detected in string message'); showGiscusNotice(container, 'rate_limit'); } }); // Additional error detection: Monitor iframe content changes const checkForErrors = () => { const container = document.querySelector('.giscus-container'); const iframe = document.querySelector('.giscus-frame'); if (iframe && container) { try { // Check if iframe has loaded and has error content setTimeout(() => { const iframeDoc = iframe.contentDocument || iframe.contentWindow.document; if (iframeDoc) { const bodyText = iframeDoc.body ? iframeDoc.body.textContent || '' : ''; if (bodyText.includes('rate limit') || bodyText.includes('API rate limit') || bodyText.includes('exceeded')) { console.warn('Giscus: Rate limit detected in iframe content'); showGiscusNotice(container, 'rate_limit'); } else if (bodyText.includes('error occurred')) { console.warn('Giscus: Generic error detected in iframe content'); showGiscusNotice(container, 'rate_limit'); // Assume it's rate limit for now } } }, 5000); // Check after 5 seconds } catch (e) { // Cross-origin restrictions, can't access iframe content console.log('Cannot access iframe content due to CORS'); } } }; // Run error check periodically setTimeout(checkForErrors, 6000); } // Load actual giscus content function loadGiscusContent(container) { if (giscusLoaded) return; giscusLoaded = true; // Clear placeholder container.innerHTML = ''; container.className = 'giscus-container loading'; // Get current theme and path info const currentTheme = getCurrentTheme(); const newPath = window.location.pathname; // Create giscus script const script = document.createElement('script'); script.src = 'https://giscus.app/client.js'; script.setAttribute('data-repo', 'Comfy-Org/docs'); script.setAttribute('data-repo-id', 'R_kgDOLlassQ'); // Replace with real ID script.setAttribute('data-category', 'Announcements'); script.setAttribute('data-category-id', 'DIC_kwDOLlassc4CtQoz'); // Replace with real ID // Prefer discussion number mapping when we know it. GitHub's discussion // search index is incomplete for this repo, so pathname/strict lookup // silently fails for many existing threads (see #1468). Number lookup // bypasses search. Unmapped pages still use pathname+strict so giscus // can create new discussions with the sha1 body tag. const mappedNumber = getMappedDiscussionNumber(newPath); if (mappedNumber) { script.setAttribute('data-mapping', 'number'); script.setAttribute('data-term', String(mappedNumber)); script.setAttribute('data-strict', '0'); console.log('Giscus: Using mapped discussion number', mappedNumber, 'for', normalizeGiscusPath(newPath)); } else { script.setAttribute('data-mapping', 'pathname'); script.setAttribute('data-strict', '1'); console.log('Giscus: No map entry; using pathname strict for', normalizeGiscusPath(newPath)); } script.setAttribute('data-reactions-enabled', '1'); script.setAttribute('data-emit-metadata', '0'); script.setAttribute('data-input-position', 'bottom'); script.setAttribute('data-theme', currentTheme === 'dark' ? 'dark' : 'light'); // Set language based on path const isChinesePage = newPath.includes('/zh/') || newPath.includes('/cn/'); const isJapanesePage = newPath.includes('/ja/'); const isKoreanPage = newPath.includes('/ko/'); const giscusLang = isKoreanPage ? 'ko' : isJapanesePage ? 'ja' : isChinesePage ? 'zh' : 'en'; script.setAttribute('data-lang', giscusLang); // Debug logging console.log('Giscus: Current path:', newPath); console.log('Giscus: Is Chinese page:', isChinesePage); console.log('Giscus: Language set to:', giscusLang); script.setAttribute('crossorigin', 'anonymous'); script.async = true; // Handle giscus load event and errors script.onload = () => { // Clear the loading timeout since script loaded successfully if (loadingTimeout) { clearTimeout(loadingTimeout); loadingTimeout = null; } setTimeout(() => { container.classList.remove('loading'); container.classList.add('loaded'); // Set up theme observer after giscus loads setupThemeObserver(); }, 1000); }; script.onerror = () => { // Clear the loading timeout since we got an error if (loadingTimeout) { clearTimeout(loadingTimeout); loadingTimeout = null; } console.error('Giscus: Failed to load giscus script'); showGiscusNotice(container, 'network'); }; // Set up a timeout to detect if giscus fails to load loadingTimeout = setTimeout(() => { // Check if giscus is still loading or showing an error const iframe = container.querySelector('.giscus-frame'); const hasError = container.querySelector('.giscus-error'); if (container.classList.contains('loading') || (iframe && !hasError)) { // Check iframe content for errors if possible try { if (iframe && iframe.contentDocument) { const iframeDoc = iframe.contentDocument; const bodyText = iframeDoc.body ? iframeDoc.body.textContent || '' : ''; if (bodyText.includes('error occurred') || bodyText.includes('rate limit') || bodyText.includes('exceeded')) { console.warn('Giscus: Error detected in iframe after timeout'); showGiscusNotice(container, 'rate_limit'); } } else { console.warn('Giscus: Loading timeout, possibly rate limited'); showGiscusNotice(container, 'rate_limit'); } } catch (e) { // Can't access iframe due to CORS, assume rate limit console.warn('Giscus: Loading timeout, assuming rate limited'); showGiscusNotice(container, 'rate_limit'); } } loadingTimeout = null; }, 8000); // Reduced to 8 second timeout for faster detection container.appendChild(script); } // Create and insert giscus container with lazy loading async function loadGiscus() { const newPath = window.location.pathname; // Exclude paths that should not have comments const excludedPaths = ['/', '/zh', '/ja', '/ko']; // Skip if current path is in excluded list or contains API/search paths if (excludedPaths.includes(newPath) || newPath.includes('/api/') || newPath.includes('/search')) { return; } currentPath = newPath; cleanupGiscus(); const contentContainer = await findContentContainer(); if (!contentContainer) { console.warn('Giscus: Could not find suitable content container'); return; } // Create giscus container with placeholder const giscusContainer = document.createElement('div'); giscusContainer.className = 'giscus-container'; // Add placeholder for lazy loading const placeholder = createGiscusPlaceholder(); giscusContainer.appendChild(placeholder); // Insert at the end of content, but before any navigation const navElements = contentContainer.querySelectorAll('nav, .pagination, [class*="nav"]:last-child'); if (navElements.length > 0) { const lastNav = navElements[navElements.length - 1]; contentContainer.insertBefore(giscusContainer, lastNav); } else { contentContainer.appendChild(giscusContainer); } // Setup lazy loading setupLazyLoading(giscusContainer); } // Handle SPA navigation function setupSPAHandling() { // Listen for URL changes (SPA navigation) let lastUrl = location.href; new MutationObserver(() => { const url = location.href; if (url !== lastUrl) { lastUrl = url; scheduleGiscusLoad(SPA_LOAD_DELAY_MS); } }).observe(document, {subtree: true, childList: true}); // Also listen for popstate events window.addEventListener('popstate', () => { scheduleGiscusLoad(SPA_LOAD_DELAY_MS); }); // Listen for pushstate/replacestate (modern SPA frameworks) const originalPushState = history.pushState; const originalReplaceState = history.replaceState; history.pushState = function() { originalPushState.apply(history, arguments); scheduleGiscusLoad(SPA_LOAD_DELAY_MS); }; history.replaceState = function() { originalReplaceState.apply(history, arguments); scheduleGiscusLoad(SPA_LOAD_DELAY_MS); }; } // Debug functions for testing notice messages window.giscusDebug = { // Force show rate limit notice showRateLimitNotice: () => { const container = document.querySelector('.giscus-container'); if (container) { showGiscusNotice(container, 'rate_limit'); } else { console.warn('No giscus container found. Wait for page to load giscus placeholder first.'); } }, // Force show network notice showNetworkNotice: () => { const container = document.querySelector('.giscus-container'); if (container) { showGiscusNotice(container, 'network'); } else { console.warn('No giscus container found. Wait for page to load giscus placeholder first.'); } }, // Reset to placeholder resetToPlaceholder: () => { const container = document.querySelector('.giscus-container'); if (container) { container.innerHTML = ''; const placeholder = createGiscusPlaceholder(); container.appendChild(placeholder); setupLazyLoading(container); giscusLoaded = false; } }, // Test URL generation testUrls: () => { const searchUrl = generateDiscussionUrl(); const mappedNumber = getMappedDiscussionNumber(window.location.pathname); console.log('Current page path:', window.location.pathname); console.log('Normalized term:', normalizeGiscusPath(window.location.pathname)); console.log('Mapped discussion number:', mappedNumber); console.log('Discussion/search URL:', searchUrl); return { searchUrl, mappedNumber }; } }; // Initialize function init() { addStyles(); setupSPAHandling(); setupGiscusErrorListener(); // Add debug info console.log('Giscus Debug Commands Available:'); console.log('- giscusDebug.showRateLimitNotice() - Show rate limit notice'); console.log('- giscusDebug.showNetworkNotice() - Show network notice'); console.log('- giscusDebug.resetToPlaceholder() - Reset to placeholder'); console.log('- giscusDebug.testUrls() - Test URL generation for current page'); if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', () => { scheduleGiscusLoad(INITIAL_LOAD_DELAY_MS); }); } else { scheduleGiscusLoad(INITIAL_LOAD_DELAY_MS); } } init(); })();

​Descripción general

​API de uso común

Descripción general

API de uso común