feat(i18n): Spanish localization (phase 4)
CI / Lint e auditorias (push) Successful in 1m31s
CI / Trivy (dependências e segredos) (push) Successful in 10s
CI / Imagem Docker (linux/arm64) (push) Successful in 2m23s

Complete implementation of Spanish (es-419) language support:
- Canonical catalogs and data: messages/es.json, data/es/**, lib/data/es/**, public/exemplos/es/**
- Canonical slugs: /es/series, /es/catalogo, /es/comparacion, /es/componentes, /es/diagnostico, /es/frameworks, /es/glosario, /es/selector, /es/acerca
- Dedicated search index at /api/busca/es with Spanish accent normalization
- Strict exclusion of book references in Spanish routes and catalogs
- Language selector and root negotiation with es active (ENABLED_LOCALES = ['pt', 'en', 'es'])
- Extended verification suite: check-i18n, smoke-imagem and verifica-vazamentos

Co-Authored-By: Antigravity <noreply@google.com>
This commit is contained in:
Lucas RayanandAntigravity committed 2026-11-01 19:50:20 -03:00
1 parent 0940814522
commit 660b28c09d
72 files changed
+17848 -947

No files matched your search

+56 -12
View File
@@ -12,6 +12,13 @@ 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 seriesDataEs from "@/data/es/series.json";
import frameworksDataEs from "@/data/es/frameworks.json";
import { categoriasGlossario as glossarioEs } from "@/lib/data/es/glossario";
import { errosCatalogo as errosEs } from "@/lib/data/es/diagnostico";
import { COMPONENTES_REGISTRY as componentesEs } from "@/lib/data/es/componentes";
import { montarConhecimento as montarConhecimentoEs } from "@/lib/data/es/topicos";
import { readFileSync, existsSync } from "node:fs";
import path from "node:path";
@@ -50,24 +57,57 @@ const PAGINAS_EN = [
{ titulo: "About the Project", descricao: "History, author and open source", href: "/en/about", keywords: "author contact" },
];
const PAGINAS_ES = [
{ titulo: "Inicio", descricao: "Página de inicio de ESPDocs", href: "/es", keywords: "home inicio" },
{ titulo: "Todas las Series", descricao: "Distribución de pines, especificaciones y restricciones de cada serie ESP32", href: "/es/series", keywords: "chips distribución de pines especificaciones" },
{ titulo: "Comparador de Series", descricao: "Compare hasta 4 modelos lado a lado", href: "/es/comparacion", keywords: "comparar comparación versus" },
{ titulo: "Catálogo de Placas", descricao: "Placas de desarrollo, conectores y compras", href: "/es/catalogo", keywords: "placas dev boards comprar devkit" },
{ titulo: "Selector Inteligente", descricao: "Descubra el chip ideal para su proyecto", href: "/es/selector", keywords: "quiz elegir recomendar selector" },
{ titulo: "Diagnóstico de Errores", descricao: "Solucione brownout, bucles de arranque, WDT y fallos", href: "/es/diagnostico", keywords: "error problema fallo crash" },
{ titulo: "Frameworks y SDKs", descricao: "ESP-IDF, Arduino, Rust, RainMaker y más", href: "/es/frameworks", keywords: "sdk" },
{ titulo: "Component Registry", descricao: "Catálogo de controladores y generador de idf_component.yml", href: "/es/componentes", keywords: "bibliotecas controladores drivers yml" },
{ titulo: "Glosario Técnico", descricao: "Conceptos esenciales de hardware y software", href: "/es/glosario", keywords: "términos diccionario significado" },
{ titulo: "Acerca del Proyecto", descricao: "Historia, autor y código abierto", href: "/es/acerca", keywords: "autor contacto código abierto" },
];
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 isEs = locale === "es";
const prefixo = isEn ? "/en" : "";
let paginas = PAGINAS_PT;
let seriesData = seriesDataPt;
let frameworksData = frameworksDataPt;
let categoriasGlossario = glossarioPt;
let errosCatalogo = errosPt;
let componentes = componentesPt;
let montarConhecimento = montarConhecimentoPt;
if (isEn) {
paginas = PAGINAS_EN;
seriesData = seriesDataEn;
frameworksData = frameworksDataEn;
categoriasGlossario = glossarioEn;
errosCatalogo = errosEn;
componentes = componentesEn;
montarConhecimento = montarConhecimentoEn;
} else if (isEs) {
paginas = PAGINAS_ES;
seriesData = seriesDataEs;
frameworksData = frameworksDataEs;
categoriasGlossario = glossarioEs;
errosCatalogo = errosEs;
componentes = componentesEs;
montarConhecimento = montarConhecimentoEs;
}
const prefixo = isEn ? "/en" : isEs ? "/es" : "";
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 slugGlossario = isEn ? "/en/glossary" : isEs ? "/es/glosario" : "/glossario";
const slugDiagnostico = isEn ? "/en/diagnostics" : isEs ? "/es/diagnostico" : "/diagnostico";
const slugComponentes = isEn ? "/en/components" : isEs ? "/es/componentes" : "/componentes";
const itens = [];
@@ -130,7 +170,11 @@ export function construirIndiceBusca(locale = "pt") {
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 pastaConexoes = isEn
? path.join(process.cwd(), "data", "en", "conexoes")
: isEs
? path.join(process.cwd(), "data", "es", "conexoes")
: path.join(process.cwd(), "public", "conexoes");
const arquivo = path.join(pastaConexoes, `${chave}.json`);
if (existsSync(arquivo)) {
conexoes[chave] = JSON.parse(readFileSync(arquivo, "utf8"));