node-red-contrib-knx-ultimate/scripts/inject-wiki-header.js

Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control and ETS group address importer. Easy to use and highly configurable.

#!/usr/bin/env node
/*
 Injects/updates a compact navigation header below the language bar on every wiki page.
 The header is localized based on filename prefix: it- / de- / zh-CN- / (default EN).
 It is wrapped between markers so it can be updated idempotently:
   <!-- NAV START -->
   ... one-line header ...
   <!-- NAV END -->
 Insertion point: right after the language bar and before the first '---' separator when present.
*/

const fs = require('fs');
const path = require('path');

const ROOT = process.cwd();
const WIKI_DIR = path.resolve(ROOT, '..', 'node-red-contrib-knx-ultimate.wiki');
const ABS = 'https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/';
const MENU_CFG = path.join(__dirname, 'wiki-menu.json');

function listMarkdown(dir) {
  const out = [];
  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
    const p = path.join(dir, e.name);
    if (e.isDirectory()) out.push(...listMarkdown(p));
    else if (e.isFile() && e.name.endsWith('.md')) out.push(p);
  }
  return out;
}

function detectLang(fileBase) {
  if (fileBase.startsWith('it-')) return 'it';
  if (fileBase.startsWith('de-')) return 'de';
  if (fileBase.startsWith('zh-CN-')) return 'zh';
  return 'en';
}

function slugify(title) { return title.replace(/ /g, '+'); }

function pageUrl(lang, title) {
  const slug = slugify(title);
  const pref = lang === 'en' ? '' : (lang === 'zh' ? 'zh-CN-' : lang + '-');
  return ABS + pref + slug;
}

const LABELS = {
  en: {
    nav: 'Navigation', home: 'Home',
    overview: 'Overview', changelog: 'Changelog', faq: 'FAQ', security: 'Security', docsLang: 'Docs: Language bar',
    knxMain: 'KNX Device', gateway: 'Gateway', device: 'Device', protections: 'Protections',
    knxOther: 'Other KNX Nodes', scene: 'Scene Controller', watchdog: 'WatchDog', logger: 'Logger', global: 'Global Context', alerter: 'Alerter', load: 'Load Control', viewer: 'Viewer', autoresp: 'Auto Responder', ha: 'HA Translator',
    hue: 'HUE', bridge: 'Bridge', light: 'Light', battery: 'Battery', button: 'Button', contact: 'Contact', devsw: 'Device SW update', lightsensor: 'Light sensor', motion: 'Motion', sceneH: 'Scene', tapdial: 'Tap Dial', temperature: 'Temperature', zigbee: 'Zigbee connectivity',
    samples: 'Samples',
  },
  it: {
    nav: 'Navigazione', home: 'Home',
    overview: 'Panoramica', changelog: 'Changelog', faq: 'FAQ', security: 'Sicurezza', docsLang: 'Docs: Barra lingue',
    knxMain: 'Nodo KNX Dispositivo', gateway: 'Gateway', device: 'Dispositivo', protections: 'Protezioni',
    knxOther: 'Altri Nodi KNX', scene: 'Scene Controller', watchdog: 'WatchDog', logger: 'Logger', global: 'Global Context', alerter: 'Alerter', load: 'Controllo Carico', viewer: 'Viewer', autoresp: 'Auto Responder', ha: 'Traduttore HA',
    hue: 'HUE', bridge: 'Bridge', light: 'Luce', battery: 'Batteria', button: 'Pulsante', contact: 'Contatto', devsw: 'Aggiornamento SW', lightsensor: 'Sensore Luce', motion: 'Movimento', sceneH: 'Scena', tapdial: 'Tap Dial', temperature: 'Temperatura', zigbee: 'Connettività Zigbee',
    samples: 'Esempi',
  },
  de: {
    nav: 'Navigation', home: 'Startseite',
    overview: 'Übersicht', changelog: 'Changelog', faq: 'FAQ', security: 'Sicherheit', docsLang: 'Doku: Sprachleiste',
    knxMain: 'KNX Geräteknoten', gateway: 'Gateway', device: 'Gerät', protections: 'Knotenschutz',
    knxOther: 'Weitere KNX‑Knoten', scene: 'Szenencontroller', watchdog: 'WatchDog', logger: 'Logger', global: 'Global Context', alerter: 'Alerter', load: 'Laststeuerung', viewer: 'Viewer', autoresp: 'Auto‑Responder', ha: 'HA‑Übersetzer',
    hue: 'HUE', bridge: 'Bridge', light: 'Licht', battery: 'Batterie', button: 'Taster', contact: 'Kontaktsensor', devsw: 'Geräte‑SW‑Update', lightsensor: 'Lichtsensor', motion: 'Bewegung', sceneH: 'Szene', tapdial: 'Tap Dial', temperature: 'Temperatur', zigbee: 'Zigbee‑Konnektivität',
    samples: 'Beispiele',
  },
  zh: {
    nav: '导航', home: '首页',
    overview: '概览', changelog: '更新日志', faq: '常见问题', security: '安全', docsLang: '文档：语言栏',
    knxMain: 'KNX 设备', gateway: '网关', device: '设备', protections: '节点保护',
    knxOther: '其他 KNX 节点', scene: '场景控制器', watchdog: '看门狗', logger: '日志节点', global: '全局上下文', alerter: '告警器', load: '负载控制', viewer: '查看器', autoresp: '自动响应', ha: 'HA 翻译器',
    hue: 'HUE', bridge: 'Bridge', light: '灯', battery: '电池', button: '按钮', contact: '接触', devsw: '设备软件更新', lightsensor: '光照传感器', motion: '运动', sceneH: '场景', tapdial: 'Tap Dial', temperature: '温度', zigbee: 'Zigbee 连接',
    samples: '示例',
  },
};

function buildHeader(lang) {
  const L = LABELS[lang];
  const mk = (t) => pageUrl(lang, t);
  const cfg = JSON.parse(fs.readFileSync(MENU_CFG, 'utf8'));

  const lines = [];
  lines.push(`${L.nav}: [${L.home}](${mk('Home')})`);

  for (const section of cfg.sections) {
    const sLabel = section.labels[lang] || section.labels.en;
    const parts = [];
    for (const it of section.items) {
      const label = (it.labels && (it.labels[lang] || it.labels.en)) || 'Link';
      const href = it.type === 'url' ? it.url : mk(it.page);
      parts.push(`[${label}](${href})`);
    }
    lines.push(`${sLabel}: ${parts.join(' • ')}`);
  }

  return lines.join('\n');
}

function updateFile(file) {
  const base = path.basename(file);
  if (base === '_Sidebar.md' || base === '_Footer.md') return false;
  const lang = detectLang(base);
  const header = buildHeader(lang);
  const NAV_START = '<!-- NAV START -->';
  const NAV_END = '<!-- NAV END -->';

  const content = fs.readFileSync(file, 'utf8');
  const lines = content.split(/\r?\n/);
  if (!lines.length) return false;
  if (!lines[0].startsWith('🌐 Language:')) return false; // enforce language bar presence

  // If header exists, replace block
  const startIdx = lines.findIndex(l => l.trim() === NAV_START);
  const endIdx = lines.findIndex(l => l.trim() === NAV_END);
  if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
    const prev = lines.slice(startIdx + 1, endIdx).join('\n');
    if (prev.trim() === header.trim()) return false; // no change
    lines.splice(startIdx, endIdx - startIdx + 1, NAV_START, header, NAV_END);
    fs.writeFileSync(file, lines.join('\n'), 'utf8');
    return true;
  }

  // Insert below language bar and before first '---' separator when present
  let insertAt = 1;
  const sepIdx = lines.slice(1, 6).findIndex(l => l.trim() === '---');
  if (sepIdx !== -1) insertAt = 1 + sepIdx; // place right before the '---'

  lines.splice(insertAt, 0, NAV_START, header, NAV_END);
  fs.writeFileSync(file, lines.join('\n'), 'utf8');
  return true;
}

const files = listMarkdown(WIKI_DIR);
let changed = 0, skipped = 0;
for (const f of files) {
  try {
    if (updateFile(f)) changed++; else skipped++;
  } catch (e) {
    console.error('Error processing', f, e.message);
  }
}
console.log(`Header injected/updated in ${changed} pages. Unchanged/skipped: ${skipped}.`);