Files
ESPDocs/lib/searchIndex.js
T
Lucas RayanandAntigravity c1bd2c7e11
CI / Lint e auditorias (push) Successful in 1m51s
CI / Trivy (dependências e segredos) (push) Successful in 15s
CI / Imagem Docker (linux/arm64) (push) Successful in 2m41s
feat(i18n): English localization (phase 3)
- Translate content to English across messages/en.json, data/en, lib/data/en, and public/exemplos/en
- Implement localized routing, slugs, and language negotiation with fallback to en
- Build dedicated search index for English with strict book exclusion
- Update components and pages to dynamically render localized strings and datasets
- Verify full structural parity and exact 1:1 match on Portuguese pages via comparator

Co-Authored-By: Antigravity <noreply@google.com>
2026-11-01 14:17:13 -03:00

148 lines
7.4 KiB
JavaScript

import seriesDataPt from "@/public/series.json";
import frameworksDataPt from "@/public/frameworks.json";
import { categoriasGlossario as glossarioPt } from "@/lib/glossarioData";
import { errosCatalogo as errosPt } from "@/lib/diagnosticoData";
import { COMPONENTES_REGISTRY as componentesPt } from "@/lib/componentRegistryData";
import { montarConhecimento as montarConhecimentoPt } from "@/lib/searchTopics";
import seriesDataEn from "@/data/en/series.json";
import frameworksDataEn from "@/data/en/frameworks.json";
import { categoriasGlossario as glossarioEn } from "@/lib/data/en/glossario";
import { errosCatalogo as errosEn } from "@/lib/data/en/diagnostico";
import { COMPONENTES_REGISTRY as componentesEn } from "@/lib/data/en/componentes";
import { montarConhecimento as montarConhecimentoEn } from "@/lib/data/en/topicos";
import { readFileSync, existsSync } from "node:fs";
import path from "node:path";
/**
* Índice de busca do site, montado no servidor a partir dos mesmos dados que
* alimentam as páginas. Uma série, termo ou erro novo entra sozinho na busca.
*
* Cada entrada: { id, tipo, titulo, descricao, href, keywords }
* `keywords` guarda texto extra pesquisável (não exibido).
*/
const PAGINAS_PT = [
{ titulo: "Início", descricao: "Página inicial do ESPDocs", href: "/", keywords: "home inicio" },
{ titulo: "Todas as Séries", descricao: "Pinouts, especificações e restrições de cada série ESP32", href: "/series", keywords: "chips pinout especificações" },
{ titulo: "Comparador de Séries", descricao: "Compare até 4 modelos lado a lado", href: "/comparacao", keywords: "comparar comparação versus" },
{ titulo: "Catálogo de Placas", descricao: "Placas de desenvolvimento, conectores e compras", href: "/catalogo", keywords: "placas dev boards comprar devkit" },
{ titulo: "Seletor Inteligente", descricao: "Descubra o chip ideal para o seu projeto", href: "/seletor", keywords: "quiz escolher recomendar" },
{ titulo: "Diagnóstico de Erros", descricao: "Solucione brownout, bootloop, WDT e falhas", href: "/diagnostico", keywords: "erro problema bug falha" },
{ titulo: "Frameworks & SDKs", descricao: "ESP-IDF, Arduino, Rust, RainMaker e mais", href: "/frameworks", keywords: "sdk" },
{ titulo: "Component Registry", descricao: "Catálogo de drivers e gerador de idf_component.yml", href: "/componentes", keywords: "bibliotecas drivers yml" },
{ titulo: "Glossário Técnico", descricao: "Conceitos essenciais de hardware e software", href: "/glossario", keywords: "termos dicionário significado" },
{ titulo: "O Livro", descricao: "Microcontroladores ESP32: conectividade, eficiência e desempenho", href: "/livro", keywords: "livro book capa comprar" },
{ titulo: "Sobre o Projeto", descricao: "História, autor e Ciência Embarcada", href: "/sobre", keywords: "autor contato" },
];
const PAGINAS_EN = [
{ titulo: "Home", descricao: "ESPDocs homepage", href: "/en", keywords: "home" },
{ titulo: "All Series", descricao: "Pinouts, specifications and restrictions for each ESP32 series", href: "/en/series", keywords: "chips pinout specifications" },
{ titulo: "Series Comparator", descricao: "Compare up to 4 models side by side", href: "/en/compare", keywords: "compare comparison versus" },
{ titulo: "Board Catalog", descricao: "Development boards, pinouts and purchasing", href: "/en/catalog", keywords: "boards dev boards devkit buy" },
{ titulo: "Smart Selector", descricao: "Find the ideal chip for your project", href: "/en/selector", keywords: "quiz choose recommend selector" },
{ titulo: "Error Diagnostics", descricao: "Troubleshoot brownout, bootloop, WDT and crashes", href: "/en/diagnostics", keywords: "error problem bug crash issue" },
{ titulo: "Frameworks & SDKs", descricao: "ESP-IDF, Arduino, Rust, RainMaker and more", href: "/en/frameworks", keywords: "sdk" },
{ titulo: "Component Registry", descricao: "Driver catalog and idf_component.yml generator", href: "/en/components", keywords: "libraries drivers yml components" },
{ titulo: "Technical Glossary", descricao: "Essential hardware and software concepts", href: "/en/glossary", keywords: "terms dictionary definition meaning" },
{ titulo: "About the Project", descricao: "History, author and open source", href: "/en/about", keywords: "author contact" },
];
const cortar = (texto = "", max = 140) => (texto.length > max ? `${texto.slice(0, max - 1).trimEnd()}…` : texto);
export function construirIndiceBusca(locale = "pt") {
const isEn = locale === "en";
const paginas = isEn ? PAGINAS_EN : PAGINAS_PT;
const seriesData = isEn ? seriesDataEn : seriesDataPt;
const frameworksData = isEn ? frameworksDataEn : frameworksDataPt;
const categoriasGlossario = isEn ? glossarioEn : glossarioPt;
const errosCatalogo = isEn ? errosEn : errosPt;
const componentes = isEn ? componentesEn : componentesPt;
const montarConhecimento = isEn ? montarConhecimentoEn : montarConhecimentoPt;
const prefixo = isEn ? "/en" : "";
const slugSeries = `${prefixo}/series`;
const slugFrameworks = `${prefixo}/frameworks`;
const slugGlossario = isEn ? "/en/glossary" : "/glossario";
const slugDiagnostico = isEn ? "/en/diagnostics" : "/diagnostico";
const slugComponentes = isEn ? "/en/components" : "/componentes";
const itens = [];
for (const p of paginas) {
itens.push({ tipo: "pagina", ...p, keywords: p.keywords });
}
for (const [chave, s] of Object.entries(seriesData)) {
itens.push({
tipo: "serie",
titulo: chave,
descricao: cortar(`${s.nome_completo ?? ""} — ${s.descricao ?? ""}`),
href: `${slugSeries}/${chave}`,
keywords: [s.arquitetura, s.wifi, s.bluetooth, s.frequencia, s.nucleos].filter(Boolean).join(" "),
});
}
for (const [chave, f] of Object.entries(frameworksData)) {
itens.push({
tipo: "framework",
titulo: f.nome ?? chave,
descricao: cortar(`${f.nome_completo ?? ""} — ${f.descricao ?? ""}`),
href: `${slugFrameworks}/${encodeURIComponent(chave)}`,
keywords: [f.linguagem, f.tipo, f.funcao_principal].filter(Boolean).join(" "),
});
}
for (const cat of categoriasGlossario) {
for (const t of cat.termos) {
const slug = t.termo.toLowerCase().replace(/[\s()/²]+/g, "-");
itens.push({
tipo: "glossario",
titulo: t.termo,
descricao: cortar(t.definicao),
href: `${slugGlossario}#${slug}`,
keywords: [cat.nome, t.exemplo].filter(Boolean).join(" "),
});
}
}
for (const e of errosCatalogo) {
itens.push({
tipo: "erro",
titulo: e.titulo,
descricao: cortar(e.resumo),
href: `${slugDiagnostico}#${e.id}`,
keywords: [e.logSerial, ...(e.sintomas ?? [])].filter(Boolean).join(" "),
});
}
for (const c of componentes) {
itens.push({
tipo: "componente",
titulo: c.titulo,
descricao: cortar(c.descricao),
href: slugComponentes,
keywords: [c.name, c.namespace, ...(c.tags ?? [])].filter(Boolean).join(" "),
});
}
const conexoes = {};
for (const chave of Object.keys(seriesData)) {
const pastaConexoes = isEn ? path.join(process.cwd(), "data", "en", "conexoes") : path.join(process.cwd(), "public", "conexoes");
const arquivo = path.join(pastaConexoes, `${chave}.json`);
if (existsSync(arquivo)) {
conexoes[chave] = JSON.parse(readFileSync(arquivo, "utf8"));
} else {
const fallback = path.join(process.cwd(), "public", "conexoes", `${chave}.json`);
if (existsSync(fallback)) conexoes[chave] = JSON.parse(readFileSync(fallback, "utf8"));
}
}
return {
itens: itens.map((item, i) => ({ id: i, ...item })),
series: montarConhecimento(seriesData, conexoes),
};
}