4. Usando VS Code
Como comentamos en la primera página de la Wiki, VS Code es uno de los mejores IDEs que podemos utilizar para poder registrar, administrar y publicar los cambios que hacemos a la traducción. Aunque el objetivo principal del programa es ayudar a los programadores, sigue siendo extremadamente útil para nuestro caso por la necesidad de subir las cosas al repositorio de Github. Por tanto, para los que no estén acostumbrados a su uso, se recomienda encarecidamente leer esta sección.
Una vez instalado VS Code desde su sitio web para tu SO concreto, necesitas crear el entorno de trabajo de tu traducción y, a ser posible, vincularlo con el GitHub de la traducción para poder registrar todos los cambios que vayas haciendo y poder subirlos cómodamente. Para ello, debemos clonar nuestro repositorio de GitHub seleccionando la opción "Clone Git Repository" y escribiendo el link en la barra de arriba cuando aparezca "Clone from GitHub":
Después, deberás elegir un directorio donde se almacenará la traducción que podrá estar sincronizada con GitHub. Es mejor crear una nueva carpeta para esto, para evitar que te puedas confundir. Cuando elijas una carpeta, se creará dentro otra llamada RimWorld-Spanish, donde estarán todos los archivos. ¡Listo! Ahora ya puedes ver los cambios que hagas a medida que modifiques archivos.
IMPORTANTE: En la esquina inferior izquierda aparece el nombre de la rama en la que estás trabajando actualmente. Nosotros utilizamos test-translations actualmente, por lo que si quieres cambiar a esta rama, dale a master (aparece por defecto siempre) y, arriba, selecciona "test-translations" dentro de la categoría branches, como se ve en la captura.
NOTA: Para poder subir cambios al repositorio, asegúrate de haber solicitado a los de Ludeon acceso al repositorio para la cuenta de GitHub que quieras utilizar. Si no, no podrás subir cosas como se explicará aquí.
Para poder subir actualizaciones al repositorio, necesitas descargarte una extensión como puede ser GitHub Actions. Puedes hacerlo desde la pestaña de los cuatro cuadrados de la barra lateral.
Una vez instalado, es posible que en ese mismo momento o al reiniciar VS Code te pida acceso a tu cuenta de GitHub. Sigue los pasos una vez le des a "Sign in to GitHub", en la esquina inferior derecha.
Una vez hayas iniciado sesión, solo queda hacer un commit. Cuando modificas un archivo, en la pestaña "Source Control" aparecerán toods los cambios que hayas realizado hasta ese momento. Para subir los cambios, solo deberás escribir un comentario breve explicando los cambios que has realizado, darle a Commit y darle a Sync Changes.
Una expresión regular (regex) es una secuencia de caracteres que define un patrón de búsqueda en texto. Se utilizan para encontrar, reemplazar o validar cadenas de texto de manera flexible. Pueden contener caracteres especiales que representan clases de caracteres, cuantificadores, grupos, entre otros elementos, lo que permite construir patrones complejos para manipular texto eficientemente. En nuestro contexto, nos ayudará a encontrar problemas que pueden existir en nuestras traducciones y buscar términos para conseguir homogeneizar todo.
Algunos códigos son los siguientes. Los que hayan sido usados al menos una vez para comprobar toda la traducción, tendrán un ✅ (no significa necesariamente que el problema que busquen no exista en la última versión de la traducción):
-
<li>((?!->).)*<\/li>- Este código busca reglas de formación de texto en las que falte la flecha ->, que es parte integral de la sintaxis. En ocasiones, al editar texto, nos podemos comer parte del código que usan los XML para poder leer adecuadamente las traducciones. Por eso, puede ayudarnos a evitar errores. -
<(.*)>.*(PAWN_pronoun).*</\1>- Este código busca en las traducciones toda cadena traducida que contenga "PAWN_pronoun". Esto nos ayuda a eliminarlos más fácilmente. -
<(.*)>.*('.*').*</\1>- ✅ Este código busca en las traducciones toda cadena traducida que contenga texto entre comillas simples ('TEXTO'). En el juego, usamos por defecto el símbolo de comillas dobles ("), no comillas simples ('). De esta forma, podemos localizar y cambiar a nuestra adaptación símbolos como este. -
<(.*)>.* </\1>- ✅ Este código busca en las traducciones toda cadena traducida que contenga un espacio al final. No distingue entre las frases que sí deben tenerlo (en inglés, aparece doble espacio al final) y no deben tenerlo (en inglés, aparece solo un espacio al final), pero puede venir bien para revisar que no nos dejamos un espacio sin querer. -
<(.*)>.*un .*world.*</\1>- ✅ Este código busca en las traducciones toda cadena traducida que contenga alguna palabra de un mundo, como "un glitterworld" o "un feralworld".
Puedes buscar estas expresiones desde el buscador del IDE desde el icono de la lupa de la izquierda, seleccionando la opción "Use Regular expression" o pulsando Alt+R. Opcionalmente, haciendo clic en los tres puntitos, puedes especificar si incluir o excluir alguna carpeta o tipo de archivo en particular en los campos de abajo.
Si necesitas saber qué hace cada expresión dentro de un patrón en VS Code particularmente, puedes ir al siguiente enlace.
Si necesitas hacer pruebas con tus propias expresiones regulares fuera de VS Code u obtener información sobre su uso en otros lenguajes de programación, puedes usar la página Regex101, que ofrece información útil sobre tu expresión, y te deja probarla en tiempo real si le suministras un texto de ejemplo.