Skip to content

docs: add Turkish (tr) localization to documentation site #1630

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Wibias merged 13 commits into from
Aug 13, 2026
Merged

docs: add Turkish (tr) localization to documentation site #1630

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
f18bdaa
docs: add Turkish (tr) localization to documentation site
ardakrt Aug 13, 2026
e97ab46
docs: address CodeRabbit review feedback on Turkish docs
ardakrt Aug 13, 2026
b4a47c8
Merge branch 'dev' of https://github.com/lidge-jun/opencodex into doc…
ardakrt Aug 13, 2026
1fe4dfe
docs: refine Cross-Platform CI description in Turkish PR quality docs
ardakrt Aug 13, 2026
a92beb6
docs: add full Turkish coverage for all guides, reference, benchmarks…
ardakrt Aug 13, 2026
ee043e7
docs: clarify Windows CI matrix trigger in Turkish PR quality docs
ardakrt Aug 13, 2026
2035c95
docs: resolve CodeRabbit review feedback on Turkish docs and frontier…
ardakrt Aug 13, 2026
c182c69
docs: translate all remaining guide and reference pages into full Tur…
ardakrt Aug 13, 2026
316a885
docs: enrich Turkish documentation pages preserving full technical ta…
ardakrt Aug 13, 2026
b96cc1d
docs: address CodeRabbit feedback on video bridge, opencode caution, …
ardakrt Aug 13, 2026
c80da85
docs: preserve strict fail-fast localization contracts and remove sil…
ardakrt Aug 13, 2026
0266109
docs(i18n): complete 1-to-1 full canonical Turkish documentation tran…
ardakrt Aug 13, 2026
9bb5834
docs(i18n): format and wrap Turkish documentation paragraphs for cano…
ardakrt Aug 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
99 changes: 50 additions & 49 deletions docs-site/astro.config.mjs
View file
Open in desktop

Large diffs are not rendered by default.

6 changes: 3 additions & 3 deletions docs-site/src/components/FrontierBoards.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ import data from "../data/frontier-benchmarks.json";
import { FRONTIER_STRINGS } from "../data/frontier-i18n";

interface Props {
locale?: "en" | "ko" | "zh-cn" | "ru" | "ja";
locale?: "en" | "ko" | "zh-cn" | "ru" | "ja" | "tr";
/** Comma-separated board ids to render; omit for all boards. */
boards?: string;
/** Show the page-level subtitle (overview pages only). */
Expand All @@ -19,14 +19,14 @@ interface Props {

const { locale = "en", boards: boardsProp, intro = false } = Astro.props;
const include = boardsProp ? new Set(boardsProp.split(",").map(s => s.trim()).filter(Boolean)) : null;
const strings = FRONTIER_STRINGS[locale] as Record<string, string>;
const strings = (FRONTIER_STRINGS[locale] ?? FRONTIER_STRINGS.en) as Record<string, string>;
const fallback = FRONTIER_STRINGS.en as Record<string, string>;
const t = (key: string): string => strings[key] ?? fallback[key] ?? key;
const fill = (key: string, vars: Record<string, string>): string =>
Object.entries(vars).reduce((acc, [k, v]) => acc.replace(`{${k}}`, v), t(key));

// The PR i18n has no column-header key for "score" — keep a tiny local map.
const SCORE_HEADER: Record<string, string> = { en: "Score", ko: "점수", "zh-cn": "得分", ru: "Балл", ja: "スコア" };
const SCORE_HEADER: Record<string, string> = { en: "Score", ko: "점수", "zh-cn": "得分", ru: "Балл", ja: "スコア", tr: "Puan" };
/** Dataset tags are kebab-case; i18n keys are camelCase (cheap-subagent → cheapSubagent). */
const tagKey = (tag: string): string => tag.replace(/-([a-z])/g, (_, c) => c.toUpperCase());

Expand Down
68 changes: 35 additions & 33 deletions docs-site/src/components/Header.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,16 +19,17 @@ const prefix = locale ? `${base}${locale}/` : base;
type NavLink = { label: string; href: string };
type NavGroup = { label: string; links: NavLink[] };

const t = (en: string, ko: string, zh: string, ru: string, ja: string) =>
locale === 'ko' ? ko : locale === 'zh-cn' ? zh : locale === 'ru' ? ru : locale === 'ja' ? ja : en;
const t = (en: string, ko: string, zh: string, ru: string, ja: string, tr?: string) =>
locale === 'ko' ? ko : locale === 'zh-cn' ? zh : locale === 'ru' ? ru : locale === 'ja' ? ja : locale === 'tr' ? (tr ?? en) : en;

type LanguageOption = { code: 'root' | 'ko' | 'zh-cn' | 'ru' | 'ja'; label: string };
type LanguageOption = { code: 'root' | 'ko' | 'zh-cn' | 'ru' | 'ja' | 'tr'; label: string };
const languages: LanguageOption[] = [
{ code: 'root', label: 'English' },
{ code: 'ko', label: '한국어' },
{ code: 'zh-cn', label: '简体中文' },
{ code: 'ru', label: 'Русский' },
{ code: 'ja', label: '日本語' },
{ code: 'tr', label: 'Türkçe' },
];
const currentLanguage = languages.find(({ code }) => code === (locale ?? 'root')) ?? languages[0];

Expand All @@ -42,60 +43,61 @@ const languageHref = (code: LanguageOption['code']) =>
`${code === 'root' ? base : `${base}${code}/`}${routeSuffix}`;

const themeLabels = {
auto: t('Auto', '자동', '自动', 'Авто', '自動'),
light: t('Light', '라이트', '浅色', 'Светлая', 'ライト'),
dark: t('Dark', '다크', '深色', 'Тёмная', 'ダーク'),
auto: t('Auto', '자동', '自动', 'Авто', '自動', 'Otomatik'),
light: t('Light', '라이트', '浅色', 'Светлая', 'ライト', 'Açık'),
dark: t('Dark', '다크', '深色', 'Тёмная', 'ダーク', 'Koyu'),
};
const themeName = t('Theme', '테마', '主题', 'Тема', 'テーマ');
const themeName = t('Theme', '테마', '主题', 'Тема', 'テーマ', 'Tema');
const themeCycleHint = t(
'Click to use the next theme',
'클릭하여 다음 테마로 전환',
'点击切换到下一个主题',
'Нажмите, чтобы включить следующую тему',
'クリックして次のテーマに切り替え',
'Sonraki temaya geçmek için tıklayın',
);

const groups: NavGroup[] = [
{
label: t('Getting Started', '시작하기', '开始使用', 'Начало работы', 'はじめに'),
label: t('Getting Started', '시작하기', '开始使用', 'Начало работы', 'はじめに', 'Başlangıç'),
links: [
{ label: t('Installation', '설치', '安装', 'Установка', 'インストール'), href: `${prefix}getting-started/installation/` },
{ label: t('Quickstart', '빠른 시작', '快速开始', 'Быстрый старт', 'クイックスタート'), href: `${prefix}getting-started/quickstart/` },
{ label: t('How It Works', '동작 원리', '工作原理', 'Как это работает', '仕組み'), href: `${prefix}getting-started/how-it-works/` },
{ label: t('Agent Quickstart', '에이전트 퀵스타트', 'Agent 快速上手', 'Быстрый старт для агентов', 'エージェント向けクイックスタート'), href: `${prefix}getting-started/for-agents/` },
{ label: t('Installation', '설치', '安装', 'Установка', 'インストール', 'Kurulum'), href: `${prefix}getting-started/installation/` },
{ label: t('Quickstart', '빠른 시작', '快速开始', 'Быстрый старт', 'クイックスタート', 'Hızlı Başlangıç'), href: `${prefix}getting-started/quickstart/` },
{ label: t('How It Works', '동작 원리', '工作原理', 'Как это работает', '仕組み', 'Nasıl Çalışır'), href: `${prefix}getting-started/how-it-works/` },
{ label: t('Agent Quickstart', '에이전트 퀵스타트', 'Agent 快速上手', 'Быстрый старт для агентов', 'エージェント向けクイックスタート', 'Ajanlar İçin Hızlı Başlangıç'), href: `${prefix}getting-started/for-agents/` },
],
},
{
label: t('Guides', '가이드', '指南', 'Руководства', 'ガイド'),
label: t('Guides', '가이드', '指南', 'Руководства', 'ガイド', 'Kılavuzlar'),
links: [
{ label: t('Providers', '프로바이더', '提供商', 'Провайдеры', 'プロバイダー'), href: `${prefix}guides/providers/` },
{ label: t('Model Routing', '모델 라우팅', '模型路由', 'Маршрутизация моделей', 'モデルルーティング'), href: `${prefix}guides/model-routing/` },
{ label: t('Combos', '콤보', '组合', 'Комбо', 'コンボ'), href: `${prefix}guides/combos/` },
{ label: t('Codex Integration', 'Codex 통합', 'Codex 集成', 'Интеграция с Codex', 'Codex 連携'), href: `${prefix}guides/codex-integration/` },
{ label: t('Codex App Model Picker', 'Codex App 모델 선택기', 'Codex App 模型选择器', 'Селектор моделей Codex App', 'Codex App モデルピッカー'), href: `${prefix}guides/codex-app-models/` },
{ label: t('Providers', '프로바이더', '提供商', 'Провайдеры', 'プロバイダー', 'Sağlayıcılar'), href: `${prefix}guides/providers/` },
{ label: t('Model Routing', '모델 라우팅', '模型路由', 'Маршрутизация моделей', 'モデルルーティング', 'Model Yönlendirme'), href: `${prefix}guides/model-routing/` },
{ label: t('Combos', '콤보', '组合', 'Комбо', 'コンボ', 'Kombolar'), href: `${prefix}guides/combos/` },
{ label: t('Codex Integration', 'Codex 통합', 'Codex 集成', 'Интеграция с Codex', 'Codex 連携', 'Codex Entegrasyonu'), href: `${prefix}guides/codex-integration/` },
{ label: t('Codex App Model Picker', 'Codex App 모델 선택기', 'Codex App 模型选择器', 'Селектор моделей Codex App', 'Codex App モデルピッカー', 'Codex App Model Seçici'), href: `${prefix}guides/codex-app-models/` },
{ label: 'Claude Code', href: `${prefix}guides/claude-code/` },
{ label: t('Sidecars: Search & Vision', '사이드카: 검색 & 비전', '边车：搜索与视觉', 'Сайдкары: поиск и зрение', 'サイドカー: 検索 & ビジョン'), href: `${prefix}guides/sidecars/` },
{ label: t('Image Bridge', '이미지 브릿지', '图像桥接', 'Image Bridge', '画像ブリッジ'), href: `${prefix}guides/image-bridge/` },
{ label: t('Video Bridge', '비디오 브릿지', '视频桥接', 'Video Bridge', '動画ブリッジ'), href: `${prefix}guides/video-bridge/` },
{ label: t('Web Dashboard', '웹 대시보드', '网页控制台', 'Веб-дашборд', 'ウェブダッシュボード'), href: `${prefix}guides/web-dashboard/` },
{ label: t('Sub-agent Surface', '서브에이전트 서피스', '子代理界面', 'Интерфейс подагентов', 'サブエージェントサーフェス'), href: `${prefix}guides/sub-agent-surface/` },
{ label: t('Sidecars: Search & Vision', '사이드카: 검색 & 비전', '边车：搜索与视觉', 'Сайдкары: поиск и зрение', 'サイドカー: 検索 & ビジョン', "Sidecar'lar: Arama & Görme"), href: `${prefix}guides/sidecars/` },
{ label: t('Image Bridge', '이미지 브릿지', '图像桥接', 'Image Bridge', '画像ブリッジ', 'Image Bridge'), href: `${prefix}guides/image-bridge/` },
{ label: t('Video Bridge', '비디오 브릿지', '视频桥接', 'Video Bridge', '動画ブリッジ', 'Video Bridge'), href: `${prefix}guides/video-bridge/` },
{ label: t('Web Dashboard', '웹 대시보드', '网页控制台', 'Веб-дашборд', 'ウェブダッシュボード', 'Web Kontrol Paneli'), href: `${prefix}guides/web-dashboard/` },
{ label: t('Sub-agent Surface', '서브에이전트 서피스', '子代理界面', 'Интерфейс подагентов', 'サブエージェントサーフェス', 'Alt Ajan Arayüzü'), href: `${prefix}guides/sub-agent-surface/` },
],
},
{
label: t('Reference', '레퍼런스', '参考', 'Справочник', 'リファレンス'),
label: t('Reference', '레퍼런스', '参考', 'Справочник', 'リファレンス', 'Referans'),
links: [
{ label: 'CLI', href: `${prefix}reference/cli/` },
{ label: t('Configuration', '설정', '配置', 'Конфигурация', '設定'), href: `${prefix}reference/configuration/` },
{ label: t('Adapters', '어댑터', '适配器', 'Адаптеры', 'アダプター'), href: `${prefix}reference/adapters/` },
{ label: t('Architecture', '아키텍처', '架构', 'Архитектура', 'アーキテクチャ'), href: `${prefix}reference/architecture/` },
{ label: t('Proxy API Formats', '프록시 API 형식', '代理 API 格式', 'Форматы API прокси', 'プロキシAPI形式'), href: `${prefix}reference/proxy-formats/` },
{ label: t('Management API', '관리 API', '管理 API', 'API управления', '管理API'), href: `${prefix}reference/management-api/` },
{ label: t('Configuration', '설정', '配置', 'Конфигурация', '設定', 'Yapılandırma'), href: `${prefix}reference/configuration/` },
{ label: t('Adapters', '어댑터', '适配器', 'Адаптеры', 'アダプター', 'Adaptörler'), href: `${prefix}reference/adapters/` },
{ label: t('Architecture', '아키텍처', '架构', 'Архитектура', 'アーキテクチャ', 'Mimari'), href: `${prefix}reference/architecture/` },
{ label: t('Proxy API Formats', '프록시 API 형식', '代理 API 格式', 'Форматы API прокси', 'プロキシAPI形式', 'Proxy API Formatları'), href: `${prefix}reference/proxy-formats/` },
{ label: t('Management API', '관리 API', '管理 API', 'API управления', '管理API', "Yönetim API'si"), href: `${prefix}reference/management-api/` },
],
},
];

const contributing: NavLink = {
label: t('Contributing', '기여하기', '贡献', 'Участие в проекте', 'コントリビュート'),
label: t('Contributing', '기여하기', '贡献', 'Участие в проекте', 'コントリビュート', 'Katkıda Bulunma'),
href: `${prefix}contributing/`,
};
---
Expand All @@ -104,7 +106,7 @@ const contributing: NavLink = {
<div class="title-wrapper sl-flex">
<SiteTitle />
</div>
<nav class="glass-nav print:hidden" aria-label={t('Main', '주 메뉴', '主导航', 'Основная навигация', 'メイン')}>
<nav class="glass-nav print:hidden" aria-label={t('Main', '주 메뉴', '主导航', 'Основная навигация', 'メイン', 'Ana Menü')}>
<ul>
{
groups.map((group, i) => (
Expand Down Expand Up @@ -174,7 +176,7 @@ const contributing: NavLink = {
aria-haspopup="menu"
aria-expanded="false"
aria-controls="language-menu"
aria-label={t('Select language', '언어 선택', '选择语言', 'Выбрать язык', '言語を選択')}
aria-label={t('Select language', '언어 선택', '选择语言', 'Выбрать язык', '言語を選択', 'Dil seçin')}
>
<Icon name="translate" class="preference-icon" />
<span>{currentLanguage.label}</span>
Expand Down Expand Up @@ -206,7 +208,7 @@ const contributing: NavLink = {
aria-haspopup="true"
aria-expanded="false"
aria-controls="lp-menu-panel"
aria-label={t('Menu', '메뉴', '菜单', 'Меню', 'メニュー')}
aria-label={t('Menu', '메뉴', '菜单', 'Меню', 'メニュー', 'Menü')}
>
<svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true">
<path d="M4 6h16M4 12h16M4 18h16" />
Expand Down
Loading
Loading