/** * Generate and validate sitemap with hreflang tags for multilingual docs * https://developers.google.com/search/docs/specialty/international/localized-versions * * Only updates lastmod dates when actual page changes are detected */ const fs = require('fs'); const path = require('path'); const { execSync } = require('child_process'); const BASE_URL = 'https://www.helius.dev/docs'; // Locale set is derived from i18n.json via the single source of truth in // scripts/locales.js. LANGUAGES keeps the same shape this file used inline: // { [code]: { code, name, urlPrefix, isDefault } }, source (en) first, then // targets. LOCALE_DIRS is the non-source locale dir names (zh, ja, ...); nav // page paths in localized nav are prefixed with these. const { SOURCE, LANGUAGES, LOCALE_DIRS } = require('./locales'); function getFileLastModified(filePath) { try { // --no-show-signature keeps lastmod as YYYY-MM-DD even when git verifies // commit signatures and gpg/ssh noise would otherwise leak into stdout. const output = execSync(`git log -1 --no-show-signature --format=%cs -- "${filePath}"`, { cwd: path.join(__dirname, '..'), encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }); const match = String(output).match(/\d{4}-\d{2}-\d{2}/); return match ? match[0] : new Date().toISOString().split('T')[0]; } catch (error) { // File not in git yet or git not available, use current date return new Date().toISOString().split('T')[0]; } } function getLocUrl(page, langConfig) { // Mintlify canonicalizes folder index.mdx pages by dropping trailing /index. // "index" → locale root; "shred-delivery/index" → "/shred-delivery". const canonicalPage = page === "index" || page === `${langConfig.code}/index` ? "" : page.replace(/\/index$/, ""); const pagePath = canonicalPage ? `/${canonicalPage}` : ""; return `${BASE_URL}${langConfig.urlPrefix}${pagePath}`; } function findLlmsTxtFiles(docsRoot) { const llmsFiles = []; function walkDir(dir, relativePath = '') { const entries = fs.readdirSync(dir, { withFileTypes: true }); for (const entry of entries) { const fullPath = path.join(dir, entry.name); const relPath = relativePath ? `${relativePath}/${entry.name}` : entry.name; if (entry.isDirectory()) { // Skip localized dirs (their llms.txt is emitted per-locale below), node_modules, .git, etc. if (![...LOCALE_DIRS, 'node_modules', '.git', 'scripts'].includes(entry.name)) { walkDir(fullPath, relPath); } } else if (entry.name === 'llms.txt') { // Build URL path from directory path + filename llmsFiles.push({ filePath: fullPath, urlPath: relativePath ? `${relativePath}/llms.txt` : 'llms.txt' }); } } } walkDir(docsRoot); return llmsFiles; } function extractPagesFromNavigation(navigation, language = 'en') { const pages = []; function traverseGroups(groups) { for (const group of groups) { if (group.pages) { for (const page of group.pages) { if (typeof page === 'string') { pages.push(page); } else if (typeof page === 'object' && page.group && page.pages) { traverseGroups([page]); } } } if (group.groups) { traverseGroups(group.groups); } } } if (navigation.languages) { const langNav = navigation.languages.find(lang => lang.language === language); if (langNav) { // Nav containers hold groups, which hold pages. The nav uses `tabs`; // older structures used `anchors`/`dropdowns`, and groups can also sit // directly on the language. Traverse whichever exist so page discovery // works regardless of structure. (Previously this read only `anchors`, // which a tabs-based nav lacks — so extraction returned zero pages and // the sitemap contained no doc pages, English or localized.) for (const container of ['tabs', 'anchors', 'dropdowns']) { for (const item of langNav[container] || []) { // traverseGroups treats item as a group node, covering both its // .pages and nested .groups in a single pass. traverseGroups([item]); } } if (langNav.groups) traverseGroups(langNav.groups); } } return pages; } function generateSitemap() { try { const docsRoot = path.join(__dirname, '..'); const docsPath = path.join(docsRoot, 'docs.json'); const docs = JSON.parse(fs.readFileSync(docsPath, 'utf8')); const allLanguages = {}; for (const langCode of Object.keys(LANGUAGES)) { const pages = extractPagesFromNavigation(docs.navigation, langCode); allLanguages[langCode] = pages.map(p => p.replace(new RegExp(`^(${LOCALE_DIRS.join('|')})/`), '')); } const uniquePages = new Set(); for (const pages of Object.values(allLanguages)) { pages.forEach(page => uniquePages.add(page)); } let sitemap = '\n'; sitemap += '${url}\n`; sitemap += ` ${lastmod}\n`; sitemap += ' \n'; } // Generate a entry for each language version of each page for (const page of Array.from(uniquePages).sort()) { for (const [langCode, langConfig] of Object.entries(LANGUAGES)) { // Only generate URL entry if this language has this page if (!allLanguages[langCode].includes(page)) continue; const locUrl = getLocUrl(page, langConfig); // Get last modified date from git for this language's file const mdxPath = langConfig.urlPrefix ? path.join(docsRoot, langConfig.urlPrefix.substring(1), `${page}.mdx`) : path.join(docsRoot, `${page}.mdx`); const lastmod = getFileLastModified(mdxPath); sitemap += ' \n'; sitemap += ` ${locUrl}\n`; sitemap += ` ${lastmod}\n`; // Add alternate links for all available language versions for (const [altLangCode, altLangConfig] of Object.entries(LANGUAGES)) { if (allLanguages[altLangCode].includes(page)) { const hrefUrl = getLocUrl(page, altLangConfig); sitemap += ` \n`; } } // x-default always points to the source (English) version const defaultUrl = getLocUrl(page, LANGUAGES[SOURCE]); sitemap += ` \n`; sitemap += ' \n'; } } sitemap += '\n'; const outputPath = path.join(docsRoot, 'sitemap.xml'); const oldSitemap = fs.existsSync(outputPath) ? fs.readFileSync(outputPath, 'utf8') : ''; // Write new sitemap fs.writeFileSync(outputPath, sitemap, 'utf8'); // Check if anything actually changed (ignoring just date changes on unchanged files) const changed = oldSitemap !== sitemap; // Count total URL entries across all languages let totalUrlEntries = 0; for (const [langCode] of Object.entries(LANGUAGES)) { totalUrlEntries += allLanguages[langCode].length; } console.log(`✓ Sitemap generated: ${uniquePages.size} unique pages`); console.log(`✓ URL entries: ${totalUrlEntries} (across ${Object.keys(LANGUAGES).length} languages)`); console.log(`✓ llms.txt files: ${llmsFiles.length}`); console.log(`✓ Languages: ${Object.keys(LANGUAGES).join(', ')}`); console.log(`✓ Changed: ${changed ? 'Yes' : 'No (dates preserved)'}`); // Quick validation const urlCount = (sitemap.match(//g) || []).length; const expectedUrlCount = totalUrlEntries + llmsFiles.length; if (urlCount === expectedUrlCount) { console.log('✓ Validation passed'); return true; } else { console.error(`❌ Validation failed: expected ${expectedUrlCount} URLs, got ${urlCount}`); return false; } } catch (error) { console.error('❌ Error:', error.message); return false; } } if (require.main === module) { const success = generateSitemap(); process.exit(success ? 0 : 1); } module.exports = { generateSitemap };

​在 Solana 上立即进行保密转账。

​什么是 Solana 环

​为什么选择 Solana 环的隐私

Solana 原生性能

一个 Solana 交易

链上可编程隐私

企业的自定义环

​用例

私密上下行入口

支付和汇款

支付卡

金融科技和机构

交易、资金管理 & RWAs

智能商业

​开始使用

​学习

概念

启动演示

​集成

嵌入式私密钱包

私密钱包

私密上下行通道

企业的自定义环

​基本指南

私密余额之间的转账

存入私密余额

读取私密余额

提取至公共余额

读取私密历史记录

​示例

TypeScript 客户端

Rust 客户端

托管程序

交换程序

​AI 工具

AI 助力开发

​资源

端点

SDK

地址

Zolana 源代码

​没找到您要找的？

在 Solana 上立即进行保密转账。

什么是 Solana 环

为什么选择 Solana 环的隐私

用例

开始使用

学习

集成

基本指南

示例

AI 工具

资源

没找到您要找的？