Ejemplos
Proyectos ejecutables en examples/ en GitHub, cada uno con su propia configuración, salidas de configuración regional confirmadas y README. Puede explorar archivos traducidos sin una clave de API; la nueva ejecución de la traducción requiere una clave de proveedor (Proveedores y modelos).
Ejecutar de forma independiente (npx degit)
Copie un ejemplo sin clonar el repositorio completo.
Ejemplos de Node.js
Cada ejemplo de Node.js declara un rango de versión (caret range) publicado de ai-i18n-tools que coincide con la versión actual del paquete e instala la CLI desde npm:
npx degit wsj-br/ai-i18n-tools/examples/<name> <name>
cd <name>
pnpm installEjemplos de Python
python-streamlit, python-flask, python-fastapi y python-gettext no tienen package.json. Los comandos degit en la tabla siguiente son válidos. También puede descargar ai-i18n-tools-python-examples.zip desde el GitHub Release. Ese archivo zip contiene los mismos cuatro directorios. No forma parte del paquete npm y no se encuentra dentro del ejecutable independiente.
python-streamlit, python-flask y python-fastapi utilizan un virtualenv y pip install -r requirements.txt. python-gettext utiliza únicamente la biblioteca estándar. Traduzca con el ejecutable independiente.
npx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlit
cd python-streamlit
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txtEn Windows, active .venv\Scripts\activate.
Si, en cambio, clonó el repositorio completo de ai-i18n-tools, ejecute pnpm install y pnpm run build en la raíz del repositorio y, a continuación, cd examples/<name>. Los ejemplos de espacio de trabajo (Node.js) utilizan la CLI local a través de sus scripts pnpm run i18n:*, o ai-i18n-tools … directamente después de la configuración de PATH. Los ejemplos de Python en esa copia realizan la traducción con node ../../bin/ai-i18n-tools.mjs después de la compilación. Consulte Instalación — Monorepositorio clonado.
Ejemplos de .NET
dotnet-console y dotnet-resx no tienen package.json. Los comandos degit de la tabla siguiente son válidos. También puede descargar ai-i18n-tools-dotnet-examples.zip desde la versión de GitHub. Ese archivo zip contiene los mismos dos directorios y assets/dotnet, que los proyectos compilan a través de ../../assets/dotnet. No forma parte del paquete npm, y no está dentro del ejecutable independiente. Las versiones publicadas antes de ese archivo zip no lo incluyen.
Ambos son proyectos xUnit. dotnet-console comprueba I18n.cs. dotnet-resx comprueba I18nResx.cs y los satélites .resx. Ninguno llama a una API de traducción. Ejecute dotnet test en el directorio. Desde un clon completo, pnpm test:dotnet en la raíz del repositorio ejecuta ambos y omite cuando dotnet no está en PATH.
Descomprima ai-i18n-tools-dotnet-examples.zip, luego ejecute las comprobaciones desde el directorio de ejemplo. El archivo mantiene examples/ y assets/dotnet uno al lado del otro, que es la ruta que compilan los proyectos:
cd examples/dotnet-console
dotnet testdegit copia un directorio y no incluye assets/dotnet. Esos enlaces de compilación se resuelven en un clon completo o después de descomprimir el archivo zip.
¿Qué ejemplo coincide con mi proyecto?
- Una aplicación JS/TS: console-app (la más pequeña) o nextjs-app. Guía: Añadir i18n a una aplicación JS/TS.
- Una aplicación Python: python-streamlit, python-flask o python-fastapi. Guía: Añadir i18n a una aplicación Python.
- Una aplicación Django o GNU gettext: python-gettext (una herramienta de línea de comandos de gettext; no hay un directorio de ejemplo de Django). Guía: Añadir i18n a una aplicación Django / Python gettext.
- Un asistente de .NET: dotnet-console (
I18n.cs) o dotnet-resx (I18nResx.csy satélites.resx). Guías: Añadir i18n a una aplicación .NET y Añadir i18n a una aplicación .NET ResourceManager. - Un sitio web o sitio de documentación: docusaurus-docs, vitepress-docs, astro-docs, nextra-docs, fumadocs-docs, astro-website, plain-html o plain-html-docs. Guía: Añadir i18n a un sitio web o sitio de documentación.
- Un README de repositorio junto a una aplicación: console-app o nextjs-app (el ejemplo de nextjs también tiene un sitio de documentación). Guía: Añadir i18n a su README y documentos Markdown.
- Algo más: multi-provider, test-markdown e intlayer-migration.
Lista de ejemplos
| Ejemplo | Ideal para | Copiar con degit | Ejecutar |
|---|---|---|---|
| console-app | La aplicación más pequeña que funciona con cadenas de interfaz de usuario t() + traducción de README | npx degit wsj-br/ai-i18n-tools/examples/console-app console-app | pnpm start |
| nextjs-app | React / Next.js + plurales + panel de control; documentación anidada de Docusaurus + README plano + recursos SVG | npx degit wsj-br/ai-i18n-tools/examples/nextjs-app nextjs-app | pnpm dev (aplicación :3030; cd docs-site && pnpm start para documentación :3040) |
| docusaurus-docs | Solo sitio de documentación de Docusaurus (preset docusaurus) | npx degit wsj-br/ai-i18n-tools/examples/docusaurus-docs docusaurus-docs | pnpm start (:3100; compilación + servicio, el menú de configuración regional funciona) |
| astro-website | Página de destino de Astro: HTML de página completa + híbrido t() | npx degit wsj-br/ai-i18n-tools/examples/astro-website astro-website | pnpm dev |
| astro-docs | Sitio de documentación de Astro Starlight | npx degit wsj-br/ai-i18n-tools/examples/astro-docs astro-docs | pnpm dev (:3050) |
| vitepress-docs | Sitio de documentos de VitePress + JSON de tema (pt-BR, zh-Hans) | npx degit wsj-br/ai-i18n-tools/examples/vitepress-docs vitepress-docs | pnpm run docs:dev (:3060) |
| nextra-docs | Nextra 4 MDX + _meta.ts / shell de diccionario .ts, más un componente de servidor t() (pt-BR, zh-Hans) | npx degit wsj-br/ai-i18n-tools/examples/nextra-docs nextra-docs | pnpm run dev (:3070) |
| fumadocs-docs | Fumadocs 4 MDX + meta.json / catálogo de IU (pt, zh, analizador de puntos) | npx degit wsj-br/ai-i18n-tools/examples/fumadocs-docs fumadocs-docs | pnpm run dev (:3080) |
| plain-html | HTML simple + marcadores data-i18n*; JSON de configuración regional estática (interfaz de usuario estilo panel de control) | npx degit wsj-br/ai-i18n-tools/examples/plain-html plain-html | pnpm dev (:3090) |
| plain-html-docs | HTML plano como documentos: una página por configuración regional, imágenes localizadas, hreflang | npx degit wsj-br/ai-i18n-tools/examples/plain-html-docs plain-html-docs | pnpm dev (:3092) |
| multi-provider | Elija o compare un proveedor de LLM (-P / --provider) | npx degit wsj-br/ai-i18n-tools/examples/multi-provider multi-provider | ai-i18n-tools translate-docs -P openai --force |
| test-markdown | Prueba de regresión de traducción de markdown / CJK (Devanagari, MDX) | npx degit wsj-br/ai-i18n-tools/examples/test-markdown test-markdown | pnpm build |
| intlayer-migration | Intlayer .content.ts → t() (migrate-intlayer, restablecer + informe de agente de IA) | npx degit wsj-br/ai-i18n-tools/examples/intlayer-migration intlayer-migration | pnpm reset && pnpm dev (:3091) |
| intlayer-translate | Mantener Intlayer, rellenar los locales que faltan en su lugar (translate-intlayer; en + pt-BR enviados, es + zh-Hans faltantes) | npx degit wsj-br/ai-i18n-tools/examples/intlayer-translate intlayer-translate | pnpm reset && pnpm translate (pnpm dev :3093) |
| python-streamlit | Panel de control de Streamlit, t() / _(), JSON de cadena de origen | npx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlit | python3 -m venv .venv && pip install -r requirements.txt && streamlit run app.py |
| python-flask | Flask + Jinja, t() / _(), JSON de cadena de origen | npx degit wsj-br/ai-i18n-tools/examples/python-flask python-flask | python3 -m venv .venv && pip install -r requirements.txt && flask --app app run |
| python-fastapi | FastAPI, local de ContextVar, t() / _(), JSON de cadena de origen | npx degit wsj-br/ai-i18n-tools/examples/python-fastapi python-fastapi | python3 -m venv .venv && pip install -r requirements.txt && uvicorn app:app |
| python-gettext | CLI de GNU gettext existente; extract / translate-ui actualiza .po y .mo | npx degit wsj-br/ai-i18n-tools/examples/python-gettext python-gettext | python3 app.py --lang es |
| dotnet-console | Comprobaciones xUnit de I18n.cs: JSON incrustado, reserva de cultura, {0}, plurales y Configure | npx degit wsj-br/ai-i18n-tools/examples/dotnet-console dotnet-console | dotnet test |
| dotnet-resx | Comprobaciones xUnit de I18nResx.cs y satélites .resx de cadena de origen | npx degit wsj-br/ai-i18n-tools/examples/dotnet-resx dotnet-resx | dotnet test |
Cada nombre de Ejemplo enlaza a su README de GitHub con la configuración completa, los comandos y el diseño del proyecto, o explore el índice de ejemplos en el repositorio.
Los ejemplos de Node.js instalan la CLI desde npm después de pnpm install. Los cuatro ejemplos de Python usan venv y pip (python-gettext usa solo la biblioteca estándar) y el ejecutable independiente para la traducción. Los dos ejemplos de .NET son proyectos xUnit. Ejecútelos con dotnet test. También están en ai-i18n-tools-dotnet-examples.zip en la versión de GitHub.
Aviso legal
Los nombres e iconos de los productos pertenecen a sus respectivos propietarios y se utilizan únicamente con fines de identificación. Este software no está afiliado a ni respaldado por dichas marcas.