feat(i18n): English localization (phase 3)
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

- 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>
This commit is contained in:
Lucas RayanandAntigravity committed 2026-11-01 14:17:13 -03:00
1 parent 22b1f26aed
commit c1bd2c7e11
61 files changed
+18182 -1225

No files matched your search

+54 -16
View File
@@ -2,8 +2,12 @@
import { useEffect, useState } from "react";
import { Check, Copy, ExternalLink } from "lucide-react";
import { usePathname } from "next/navigation";
export default function CodeExample({ framework }) {
const pathname = usePathname() || "";
const isEn = pathname === "/en" || pathname.startsWith("/en/");
const examplesUrl = framework?.exemplos;
const [sample, setSample] = useState("");
@@ -20,18 +24,36 @@ export default function CodeExample({ framework }) {
const exemploPath = framework.exemplo;
if (!exemploPath) {
setSample(`// Exemplos completos: ${examplesUrl || "ver repositório"}\n`);
setSample(
isEn
? `// Full examples: ${examplesUrl || "see repository"}\n`
: `// Exemplos completos: ${examplesUrl || "ver repositório"}\n`
);
return;
}
const url = exemploPath.startsWith("/") ? exemploPath : `/${exemploPath}`;
// Se locale for en, busca primeiro em /exemplos/en/
let url = exemploPath.startsWith("/") ? exemploPath : `/${exemploPath}`;
if (isEn && url.startsWith("/exemplos/") && !url.startsWith("/exemplos/en/")) {
url = url.replace("/exemplos/", "/exemplos/en/");
}
let cancelled = false;
setLoading(true);
fetch(url)
.then((res) => {
if (!res.ok) throw new Error(`HTTP ${res.status}`);
if (!res.ok) {
// Fallback para o arquivo original se não achar a versão traduzida
const fallbackUrl = exemploPath.startsWith("/") ? exemploPath : `/${exemploPath}`;
if (fallbackUrl !== url) {
return fetch(fallbackUrl).then((r2) => {
if (!r2.ok) throw new Error(`HTTP ${r2.status}`);
return r2.text();
});
}
throw new Error(`HTTP ${res.status}`);
}
return res.text();
})
.then((text) => {
@@ -39,14 +61,22 @@ export default function CodeExample({ framework }) {
if (text && text.trim().length > 0) {
setSample(text);
} else {
setSample("// O arquivo de exemplo está vazio. Consulte o repositório oficial.\n");
setError("arquivo vazio");
setSample(
isEn
? "// The example file is empty. Refer to the official repository.\n"
: "// O arquivo de exemplo está vazio. Consulte o repositório oficial.\n"
);
setError(isEn ? "empty file" : "arquivo vazio");
}
})
.catch((err) => {
if (cancelled) return;
setSample("// Não foi possível carregar o exemplo.\n// Consulte o repositório oficial para exemplos completos.\n");
setError(err.message || "falha ao carregar");
setSample(
isEn
? "// Could not load example.\n// Refer to official repository for complete examples.\n"
: "// Não foi possível carregar o exemplo.\n// Consulte o repositório oficial para exemplos completos.\n"
);
setError(err.message || (isEn ? "load failure" : "falha ao carregar"));
})
.finally(() => {
if (!cancelled) setLoading(false);
@@ -55,7 +85,7 @@ export default function CodeExample({ framework }) {
return () => {
cancelled = true;
};
}, [framework?.exemplo, framework?.exemplos]);
}, [framework?.exemplo, framework?.exemplos, isEn]);
const lines = (sample || "").replace(/\n$/, "").split("\n");
@@ -71,20 +101,26 @@ export default function CodeExample({ framework }) {
<div className="card p-5 sm:p-7">
<div className="flex flex-wrap items-start justify-between gap-4">
<div>
<h2 className="font-display text-xl font-semibold tracking-[-0.03em] text-ink">Exemplo de código</h2>
<p className="mt-1 text-sm text-muted">Trecho de partida em {framework?.linguagem}. Ajuste pinos e configuração à sua placa.</p>
<h2 className="font-display text-xl font-semibold tracking-[-0.03em] text-ink">
{isEn ? "Code example" : "Exemplo de código"}
</h2>
<p className="mt-1 text-sm text-muted">
{isEn
? `Starter snippet in ${framework?.linguagem}. Adjust pins and configuration for your board.`
: `Trecho de partida em ${framework?.linguagem}. Ajuste pinos e configuração à sua placa.`}
</p>
</div>
<div className="flex flex-wrap items-center gap-2">
<button type="button" onClick={handleCopy} className="btn btn-ghost btn-sm">
{copied ? <Check className="h-4 w-4 text-ok" aria-hidden="true" /> : <Copy className="h-4 w-4" aria-hidden="true" />}
<span role="status">{copied ? "Copiado" : "Copiar"}</span>
<span role="status">{copied ? (isEn ? "Copied" : "Copiado") : (isEn ? "Copy" : "Copiar")}</span>
</button>
{examplesUrl && (
<a href={examplesUrl} target="_blank" rel="noopener noreferrer" className="btn btn-ghost btn-sm">
Mais exemplos
{isEn ? "More examples" : "Mais exemplos"}
<ExternalLink className="h-4 w-4" aria-hidden="true" />
<span className="sr-only"> (abre em nova aba)</span>
<span className="sr-only">{isEn ? " (opens in new tab)" : " (abre em nova aba)"}</span>
</a>
)}
</div>
@@ -93,9 +129,9 @@ export default function CodeExample({ framework }) {
<div className="code-panel mt-5" aria-busy={loading}>
<div className="flex items-center justify-between border-b border-white/10 px-4 py-2.5 text-xs text-[#a6afbd]">
<span className="font-mono">{framework?.nome}</span>
<span>{loading ? "Carregando exemplo…" : framework?.linguagem}</span>
<span>{loading ? (isEn ? "Loading example…" : "Carregando exemplo…") : framework?.linguagem}</span>
</div>
<pre tabIndex={0} aria-label={`Código de exemplo em ${framework?.linguagem}`}>
<pre tabIndex={0} aria-label={isEn ? `Code example in ${framework?.linguagem}` : `Código de exemplo em ${framework?.linguagem}`}>
<code>
{lines.map((line, idx) => (
<span key={idx} className="flex">
@@ -109,7 +145,9 @@ export default function CodeExample({ framework }) {
{error && (
<p role="alert" className="callout callout-warn mt-4">
Não foi possível carregar o exemplo local ({error}). Use “Mais exemplos” para ver o código oficial.
{isEn
? `Could not load local example (${error}). Use “More examples” to view official code.`
: `Não foi possível carregar o exemplo local (${error}). Use “Mais exemplos” para ver o código oficial.`}
</p>
)}
</div>