<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Kevin Zúñiga on Medium]]></title>
        <description><![CDATA[Stories by Kevin Zúñiga on Medium]]></description>
        <link>https://medium.com/@kevinzuniga?source=rss-17cf8c2d4a2b------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/2*jIyNmqnNgeF4OUtoXZPRMA.jpeg</url>
            <title>Stories by Kevin Zúñiga on Medium</title>
            <link>https://medium.com/@kevinzuniga?source=rss-17cf8c2d4a2b------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 06:03:05 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@kevinzuniga/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Guía para agregar i18next a un webapp react sin morir en el intento]]></title>
            <link>https://medium.com/@kevinzuniga/gu%C3%ADa-para-agregar-i18next-a-un-webapp-react-sin-morir-en-el-intento-9465b17b1798?source=rss-17cf8c2d4a2b------2</link>
            <guid isPermaLink="false">https://medium.com/p/9465b17b1798</guid>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[multilanguage]]></category>
            <category><![CDATA[react]]></category>
            <category><![CDATA[i18next]]></category>
            <category><![CDATA[reactjs]]></category>
            <dc:creator><![CDATA[Kevin Zúñiga]]></dc:creator>
            <pubDate>Fri, 15 May 2020 02:31:20 GMT</pubDate>
            <atom:updated>2020-05-15T02:31:20.123Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QgWryBIALuk1kN1mC7cLdg.png" /></figure><p>Buscando en internet, luego de muchos intentos de encontrar una buena documentación de cómo hacerlo, encontré un par de post donde indican una manera más clara cómo lograr el objetivo, pero con un problema muy grande… No me daban la posibilidad de hacer el switch del idioma sin perder la página en la que me encuentro.</p><p>Quizás no es un problema tan grave, pero en mi caso era primordial no perder la página ya que podría perder viabilidad la solución. Por eso creé este tutorial, por si alguno está en la misma encrucijada o no tienen tanta experiencia en React y su el componente de multi-lenguaje y puedan salir victoriosos. Espero que sea de su ayuda este artículo.</p><h3>Manos a la obra</h3><h4>Instalación de dependencias</h4><p>La dependecia principal que vamos a utilizar para hacer nuestra aplicación multi-idioma es<a href="https://www.i18next.com/"> <strong>i18next,</strong></a><strong> </strong>además de otras que serán necesarias para el funcionamiento.</p><p>La instalación es muy sencilla y se realiza de la siguiente manera, por medio de <strong>npm</strong>:</p><p><strong>i18next</strong></p><pre>npm i i18next</pre><p><strong>i18next-browser-languagedetector</strong></p><pre>npm i i18next-browser-languagedetector</pre><p><strong>react-i18next</strong></p><pre>npm i react-i18next</pre><p>El <strong><em>package json</em></strong> debe verse de la siguiente forma:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/0d77fdd29cb9760cbbec60b510fd155f/href">https://medium.com/media/0d77fdd29cb9760cbbec60b510fd155f/href</a></iframe><h4>Primeros pasos</h4><p>Luego de agregar las dependencias, es necesario crear un archivo donde se define la configuración del i18next. Éste archivo tendrá las opciones requeridas para que funcione correctamente la traducción. No importa donde se cree este archivo ni como se llame, (éstas caracteristicas dependerán de la naturaleza de cada proyecto), lo único necesario es que exista y que tenga las siguientes características como mínimo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c3fa4f8a94a18581d5c431d236ceeb88/href">https://medium.com/media/c3fa4f8a94a18581d5c431d236ceeb88/href</a></iframe><p>Aspectos importantes de la configuración:</p><ul><li><strong>supportedLanguages</strong>: Definimos cuáles lenguajes vamos a tener en la aplicación, para este ejemplo solo he definido inglés (en) y español (es).</li><li><strong>ns</strong>: Ésta opción nos ayuda a indicar cuales traducciones vamos a tener funcionando, ¡sí, podemos tener mas de uno!. Se colocan de la siguiente forma: <strong>[“translation1”, “translation2”, “translation”, …] </strong>tantos como sean necesarios.</li><li><strong>loadPath</strong>: nos da la oportunidad de definir en qué lugar se encuentran los archivos de idioma donde se encuentran las traducciones de nuestras vistas. Cada traducción definida en la opción <strong>ns</strong> debe tener un archivo asociado con el mismo nombre en la path indicado en esta opción.</li><li><strong>debug</strong>: nos permite ver los logs generados en la consola del browser para el proyecto en desarrollo. Una vez pase a producción, debe colocarse en <strong>false.</strong></li></ul><p>Una vez configurado correctamente, es hora de crear nuestro archivo de traducción en la misma carpeta que colocamos en la variable <strong>localPath </strong>anteriormente. La estructura de carpetas debe ser la siguiente:</p><pre>public<br>└-locales<br>  └- en<br>  └- es</pre><p><strong>Importante</strong>: debe de existir una carpeta por cada idioma que se defino en <strong>supportedLanguages</strong></p><p>Una vez tengamos la estructura de carpetas creada, creamos nuestros archivos de traducción. Como lo mencioné anteriormente, es necesario que tengan el mismo nombre definido en la opción <strong>ns. </strong>Para este caso, tenemos que crear en la carpeta <strong><em>es</em></strong> y <strong><em>en</em></strong> un archivo con el siguiente nombre: <strong><em>translation.json</em></strong></p><h4>Para continuar</h4><p>Con la configuración de las opciones del <strong>i18next </strong>y la estructura de la carpeta defina, es hora de agregar nuestra configuración al archivo <strong><em>index.js. </em></strong>Para ésto es necesario agregar la siguiente línea:</p><pre>import &quot;./i18n&quot;;</pre><p>Seguido de esto, debemos crear dos componentes, uno llamado <strong><em>farewells.js</em></strong> y el otro <strong><em>greeting.js.</em></strong></p><p>Este paso lo indico simplemente para comprender la funcionalidad y ver los cambios que hay que aplicar para ver la traducción en marcha.</p><p><strong><em>farewells.js</em></strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c2822bc14aa595366d81b72a236a89e5/href">https://medium.com/media/c2822bc14aa595366d81b72a236a89e5/href</a></iframe><p><strong><em>greeting.js</em></strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/be8802e02922aeacd51232b78ad6d514/href">https://medium.com/media/be8802e02922aeacd51232b78ad6d514/href</a></iframe><p>Son componentes simples que solo muestran un título.</p><h4>Vamos agregar las traducciones</h4><p>A continuación, vamos a proceder agregar las traducciones a los archivos<strong> </strong>previamente creados, llamados <strong><em>translation.json </em></strong>(Los textos que vamos agregar son sencillos y para funcionalidad del ejemplo)</p><p><strong><em>en/translation.json</em></strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7d60af8cc3785291dee46f5b0e54720b/href">https://medium.com/media/7d60af8cc3785291dee46f5b0e54720b/href</a></iframe><p>Ya que es algo fácil, les dejo de tarea que hagan la traducción al español.</p><h4>La magia</h4><p>Llegó la hora de agregar el componente que nos va ayudar hacer el cambio de idioma sin perder la ruta en el URL, por ejemplo: si estamos en <strong>localhost/es/greeting</strong> y queremos cambiar a ingles, la URL quedaría <strong>localhost/en/greeting</strong>.</p><p>Nuestro componente se va llamar <strong><em>switcher.js</em></strong> y tiene el siguiente código:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7dc62e5f8df533fa42ce92f473625b91/href">https://medium.com/media/7dc62e5f8df533fa42ce92f473625b91/href</a></iframe><h4>Aquí es donde pone bonito</h4><p>Vamos crear un nuevo componente que se va a encargar de la navegación de nuestra aplicación, no es complejo ni fuera de lo común, es unicamente agregar la funcionalidad de traducción. El componente va a tener el nombre de navigation.js y tiene el siguiente código:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/8986f4b8373a717f48a403f95693733b/href">https://medium.com/media/8986f4b8373a717f48a403f95693733b/href</a></iframe><p>Debemos analizar ciertas inclusiones que están el archivo para que todo quede claro.</p><ul><li><strong>withTranslation()</strong>: Lo importante aquí es entender que esta función, en el ejemplo, no recibe parámetro porque contamos con un solo archivo de traducción default. Si no fuera así y la traducción estuviera en otro archivo es necesario que se agregue cual es el archivo de la siguiente manera: <strong>withTranslation(“customTranslation”)</strong>.</li><li><strong>path={`/:lang(en|es)/${“greeting”}`}</strong>: Esta línea de código es esencial para definir la ruta, por lo que vamos analizarla por partes: <br>1- <strong>/:lang(en|es)</strong>: nos indica cuales son los idiomas que están disponibles. Si requerimos agregar un nuevo idioma, debe agregarse en éste apartado también.<br>2- <strong>${“greeting”}</strong>: Es una<a href="https://developer.mozilla.org/es/docs/Web/JavaScript/Referencia/template_strings"> plantilla de cadena de texto</a>, que nos indica cual es la ruta.</li><li><strong>Switcher</strong>: es nuestro componente que se encarga de cambiar de un idioma a otro sin perder la ruta, lo agregamos en el paso anterior.</li></ul><h4>Ya casi listo.</h4><p>Llegando a este punto, solo falta unos pasitos más, agregar nuestro componente de <strong><em>navigation.js </em></strong>al archivo <strong><em>App.js</em></strong> como primer paso:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/076f77fe341e2a63af168987ea35dece/href">https://medium.com/media/076f77fe341e2a63af168987ea35dece/href</a></iframe><p>Como segundo paso, debemos aplicar la traducción a nuestros componentes creados previamente <strong><em>farewells.js</em></strong> y <strong><em>greeting.js</em></strong>, de la siguiente forma:</p><p><strong><em>farewells.js</em></strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/48389db8133ce0363ff7596a886f2854/href">https://medium.com/media/48389db8133ce0363ff7596a886f2854/href</a></iframe><p>Lo importante de comprender aquí es que definimos el uso del componente <strong>useTranslation() </strong>que, en el caso de realizar una traducción en específico solo debemos de incluir el nombre por parámetros. Otro punto importante es que <strong>t(“Bye”) </strong>nos hace referencia <strong>Key</strong> en el <strong>json</strong> <strong><em>translation.json</em></strong>.</p><p>Como lo hice anteriormente, el cambio solo se aplica a un archivo por lo que les toca a ustedes hacer lo mismo con el archivo <strong><em>greeting.js.</em></strong></p><h4>Funcionando</h4><p>Al correr el proyecto deberian de ver algo similar a esto:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/756/1*Nu-NBzSaOZeUmzYpGdPIkA.png" /></figure><p>Para su facilidad, he creado un <strong>sandbox</strong> en <strong>codesandbox.io</strong>, que les sea posible interactuar con el desarrollo y ver cómo funciona. Les recomiendo realizar paso por paso para que comprender mejor la funcionalidad y lo adapten mejor a su desarrollo.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fcodesandbox.io%2Fembed%2Fg0lp2&amp;display_name=CodeSandbox&amp;url=https%3A%2F%2Fcodesandbox.io%2Fs%2Fg0lp2&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=codesandbox" width="1000" height="500" frameborder="0" scrolling="no"><a href="https://medium.com/media/317015977b77592444eac740010bca11/href">https://medium.com/media/317015977b77592444eac740010bca11/href</a></iframe><p>El código tambien esta disponible en <strong>github.com:</strong></p><p><a href="https://github.com/kevter/Multi-language-react">kevter/Multi-language-react</a></p><h4>Conclusión</h4><p>Una vez aquí, tendrán unejemplo funcional de como utilizar i18next en un proyecto de React. Espero que les funcione correctamente y comprendan el proceder, ya que, no es complejo ,simplemente no ha sido bien explicado anteriormente.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9465b17b1798" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>