Skip to content

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:

bash
npx degit wsj-br/ai-i18n-tools/examples/<name> <name>
cd <name>
pnpm install

Ejemplos 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.

bash
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.txt

En 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:

bash
cd examples/dotnet-console
dotnet test

degit 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? ​

Lista de ejemplos ​

EjemploIdeal paraCopiar con degitEjecutar
console-appLa aplicación más pequeña que funciona con cadenas de interfaz de usuario t() + traducción de READMEnpx degit wsj-br/ai-i18n-tools/examples/console-app console-apppnpm start
nextjs-appReact / Next.js + plurales + panel de control; documentación anidada de Docusaurus + README plano + recursos SVGnpx degit wsj-br/ai-i18n-tools/examples/nextjs-app nextjs-apppnpm dev (aplicación :3030; cd docs-site && pnpm start para documentación :3040)
docusaurus-docsSolo sitio de documentación de Docusaurus (preset docusaurus)npx degit wsj-br/ai-i18n-tools/examples/docusaurus-docs docusaurus-docspnpm start (:3100; compilación + servicio, el menú de configuración regional funciona)
astro-websitePágina de destino de Astro: HTML de página completa + híbrido t()npx degit wsj-br/ai-i18n-tools/examples/astro-website astro-websitepnpm dev
astro-docsSitio de documentación de Astro Starlightnpx degit wsj-br/ai-i18n-tools/examples/astro-docs astro-docspnpm dev (:3050)
vitepress-docsSitio de documentos de VitePress + JSON de tema (pt-BR, zh-Hans)npx degit wsj-br/ai-i18n-tools/examples/vitepress-docs vitepress-docspnpm run docs:dev (:3060)
nextra-docsNextra 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-docspnpm run dev (:3070)
fumadocs-docsFumadocs 4 MDX + meta.json / catálogo de IU (pt, zh, analizador de puntos)npx degit wsj-br/ai-i18n-tools/examples/fumadocs-docs fumadocs-docspnpm run dev (:3080)
plain-htmlHTML 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-htmlpnpm dev (:3090)
plain-html-docsHTML plano como documentos: una página por configuración regional, imágenes localizadas, hreflangnpx degit wsj-br/ai-i18n-tools/examples/plain-html-docs plain-html-docspnpm dev (:3092)
multi-providerElija o compare un proveedor de LLM (-P / --provider)npx degit wsj-br/ai-i18n-tools/examples/multi-provider multi-providerai-i18n-tools translate-docs -P openai --force
test-markdownPrueba de regresión de traducción de markdown / CJK (Devanagari, MDX)npx degit wsj-br/ai-i18n-tools/examples/test-markdown test-markdownpnpm build
intlayer-migrationIntlayer .content.ts → t() (migrate-intlayer, restablecer + informe de agente de IA)npx degit wsj-br/ai-i18n-tools/examples/intlayer-migration intlayer-migrationpnpm reset && pnpm dev (:3091)
intlayer-translateMantener 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-translatepnpm reset && pnpm translate (pnpm dev :3093)
python-streamlitPanel de control de Streamlit, t() / _(), JSON de cadena de origennpx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlitpython3 -m venv .venv && pip install -r requirements.txt && streamlit run app.py
python-flaskFlask + Jinja, t() / _(), JSON de cadena de origennpx degit wsj-br/ai-i18n-tools/examples/python-flask python-flaskpython3 -m venv .venv && pip install -r requirements.txt && flask --app app run
python-fastapiFastAPI, local de ContextVar, t() / _(), JSON de cadena de origennpx degit wsj-br/ai-i18n-tools/examples/python-fastapi python-fastapipython3 -m venv .venv && pip install -r requirements.txt && uvicorn app:app
python-gettextCLI de GNU gettext existente; extract / translate-ui actualiza .po y .monpx degit wsj-br/ai-i18n-tools/examples/python-gettext python-gettextpython3 app.py --lang es
dotnet-consoleComprobaciones xUnit de I18n.cs: JSON incrustado, reserva de cultura, {0}, plurales y Configurenpx degit wsj-br/ai-i18n-tools/examples/dotnet-console dotnet-consoledotnet test
dotnet-resxComprobaciones xUnit de I18nResx.cs y satélites .resx de cadena de origennpx degit wsj-br/ai-i18n-tools/examples/dotnet-resx dotnet-resxdotnet 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.

Publicado bajo la licencia MIT.