Itzuli Stanza MCP

Xingolak

巴斯克语翻译对齐可视化

🇺🇸 英语 | 🔴⚪🟢 篮子

Xingolak Demo

Xingolak （巴斯克语意为“丝带”）是一个交互式网络应用程序，可以可视化英语和巴斯克语翻译之间的单词和语法结构如何对齐。通过将翻译与深入的语言分析联系起来，Xingolak揭示了英语和巴斯克语在表达意义方面的迷人差异。

Xingolak做什么

Xingolak接受任何英文文本，将其翻译成巴斯克语，并向您展示这两种语言在多个语言层面上是如何对应的。它不仅显示并排翻译，还绘制了连接相关单词和概念的动画“丝带”，帮助您理解：

• 哪些英语单词对应哪些巴斯克语单词
• 语法角色如何在语言之间转换
• 英语语法在巴斯克语单词中重新分布

该应用程序揭示了英语（严重依赖词序）和巴斯克语（使用丰富的形态标记和灵活的词序）之间的深层结构差异。

理解三个分析层

Xingolak从三个不同的语言层面分析了翻译对齐：

🟢 词汇的

显示英语单词与其直接巴斯克语对应词之间的词典级对应关系。此层显示：

• 基本的逐字翻译
• 英语概念直接映射到巴斯克语单词的情况
• 跨语言的词汇关系

🟣 语法关系

演示每种语言如何标记句子角色和关系。此层显示：

• 英语如何使用语序来显示关系（主语动词宾语）
• 巴斯克语如何使用格后缀和动词一致性
• 语言表示“谁在对谁做什么”的不同方式

🟠 特性

揭示语法信息如何在单词中分布。该层暴露：

• 英语时态标记如何在多个巴斯克语单词中传播
• 在每种语言中都存在明确性、否定性和一致性
• 嵌入单词形式中的“隐藏”语法信息

运作原理

Xingolak使用复杂的人工智能管道来生成这些可视化：

English Text → Itzuli API → Stanza NLP → Claude AI → Interactive Visualization
     ↓             ↓            ↓           ↓              ↓
  "Input text"  Translation  Linguistic   Alignment    Animated ribbons
                            Analysis     Generation      & interactions

1. 翻译：您的英文文本将使用以下语言翻译成巴斯克语 返回API
2. 语言分析：这两篇文章都是用 斯坦福大学的Stanza NLP 识别语法结构
3. 对齐生成：Claude AI分析两种语言结构以生成精确的对齐
4. 可视化：web界面呈现显示这些连接的交互式功能区

主要特点

🎯 交互式单词探索

• 悬停 查看任何单词的连接
• 点击 固定单词并详细探索其对齐方式
• 切换图层 观察不同类型的语言关系

🌍 多语言界面

整个界面支持四种语言：

• 英语 -功能齐全
• Euskera（巴斯克语） -母语界面
• 西班牙语（西班牙语） -完成西班牙语本地化
• 法语（法语） -完整的法语翻译

📱 响应式设计

• 在台式机和移动设备上无缝工作
• 处理复杂句子结构的自适应布局
• 流畅的动画，揭示语言关系

♿ 无障碍功能

• 全屏阅读器支持，带有详细的aria标签
• 所有交互元素的键盘导航
• 高对比度可视化选项

入门指南

必需的API密钥

要运行Xingolak，您需要访问两个API：

1. 返回API密钥

API提供高质量的英语↔ 巴斯克语翻译。

• 拿到你的钥匙：参观 返回.vicomtech.org/en/api/ 并填写表格以请求访问API
• 用法：英语和巴斯克语之间的翻译
• 成本：定价详细信息不公开-通过API申请表与他们联系以获取信息

2. API密钥

Claude AI生成复杂的语言对齐，为可视化提供动力。

• 拿到你的钥匙：注册地址： console.anthropic.com
• 用法：语言分析和对齐生成
• 成本：查看当前价格 anthropic.com

安装和设置

1. 克隆存储库:

git clone https://github.com/your-repo/itzuli-stanza-mcp
cd itzuli-stanza-mcp

1. 设置后端:

cd backend
# Follow backend/README.md for detailed setup instructions

1. 设置前端:

cd frontend
npm install
npm run dev

1. 配置API密钥 遵循后端文档中的设置指南。

项目结构

itzuli-stanza-mcp/
├── frontend/          # Xingolak web application (TypeScript + React)
└── backend/           # NLP processing pipeline (Python)
    ├── core/          # Core translation and analysis workflows
    ├── alignment_server/  # HTTP API for frontend integration
    └── mcp_server/    # Claude MCP server integration

文档

• 后端设置 -完整的Python后端设置指南
• 系统架构 -详细的技术架构
• 后端设置（Euskera） -巴斯克语设置指南
• 建筑（Euskera） -巴斯克语建筑文档

关于名字

Xingolak （发音为“sheen-go-lock”）在巴斯克语中意为“丝带”，反映了丝带连接跨语言相关概念的视觉隐喻。这个名字既体现了界面的视觉设计，也体现了跨不同语言系统绑定意义的语言连接的概念。