| english | spanish | synonym | observation |
|---|---|---|---|
| aesthetics | estéticas | NA | NA |
| assignment operator | operador de asignación | NA | NA |
| atomic vectors | vectores atómicos | NA | NA |
| back slash | barra invertida | NA | NA |
| backtick | acento grave | NA | NA |
| base R | R base | NA | NA |
| by default | por defecto | NA | NA |
| click | hacer clic | NA | NA |
| console | consola | NA | NA |
| debugging | depurar | NA | NA |
| dataset | conjunto de datos | set de datos | NA |
| facet | faceta | NA | NA |
| input | input | NA | la palabra existe como anglicismo en español.No se traduce |
| intercept | ordenada al origen | NA | NA |
| key | clave | NA | NA |
| legend | leyenda | NA | NA |
| list-columns | columnas-lista | NA | NA |
| log-transformation | transformación logarítmica | NA | NA |
| mapping | mapear | NA | NA |
| match | coincidencia | NA | NA |
| missing values | valores faltantes | NA | NA |
| modelling | modelado | NA | NA |
| named list | lista nombrada | NA | NA |
| partial matching | coincidencia parcial | NA | NA |
| parse | segmentar | analizar | depende del contexto |
| placeholder | marcador de posición | NA | NA |
| query | consulta | NA | NA |
| raw data | datos sin procesar | datos crudos | NA |
| regular expression | expresión regular | NA | NA |
| test set | datos de validación | set de validación | NA |
| training set | datos de entrenamiento | set de entrenamiento | NA |
| tidy data | datos ordenados | NA | NA |
| feedback | devolución | retroalimentación | NA |
| call stack | pila de llamada | NA | NA |
| chunking | particionar | fragmentar | NA |
| loop | bucle | NA | NA |
| path | ruta de acceso | NA | NA |
| stack | pila | NA | NA |
| stack frame | marco de pila | NA | NA |
| best practices | buenas prácticas | NA | NA |
| test | test | NA | en el contexto de test unitarios |
| issue | issue | NA | en el contexto de git |
| push | push | NA | en el contexto de git |
| unit tests | tests unitarios | NA | NA |
| badge | etiqueta | NA | NA |
| deprecated | obsoleto | NA | NA |
| defunct | caduco | NA | NA |
| branch | rama | NA | en el contexto de git |
| cheatsheet | guía rápida | NA | NA |
| cheat sheet | guía rápida | NA | NA |
| r universe | r universe | NA | NA |
| runiverse | runiverse | NA | NA |
| r-universe | r-universe | NA | NA |
4 Orientaciones para la traducción
4.1 A. Organización del trabajo
Después de realizar la traducción de la guía y todos los materiales relacionados se realizarán dos revisiones de cada capítulo y una edición final de toda la guía en su conjunto. Se buscará, de ser posible, que las personas que revisen tengan origen en diferentes países para poder considerar las diferentes formas en que hablamos español en todo el mundo.
4.2 B. Aspectos a tener en cuenta para la traducción del texto
1. Usar una voz conversacional en lugar de una voz formal o académica.
2. Al traducir buscamos generar una versión clara en español lo que en el capítulo está escrito en inglés. En algunos casos eso puede implicar alterar el orden de las palabras y signos de puntuación de una oración o agregar más elementos que no estaban en el texto original. Lo importante es que la traducción se lea lo más natural posible en español, respetando el mensaje que se quiso transmitir en el original.
3. La variedad dialectal del español que usaremos en la traducción es la de Latinoamérica La decisión es consistente con otras traducciones realizadas en la comunidad R de habla hispana. Además, el posible público destinatario que la habla es más amplio. Intentaremos generar una versión lo más neutra posible, por lo que:
- Evitaremos expresiones o usos locales/regionales, es decir, que no están extendidos en toda Latinoamérica.
- No utilizaremos el voseo (vos/vosotros). La guia rOpenSci Packages: Development, Maintenance, and Peer Review está dirigido a una segunda persona, así que para mantener lo mas posible la neutralidad la traduciremos como tú > Ejemplo: … We hope that you’ll find the guide > … esperamos que encuentres esta guía; You can view updates > … Puedes ver actualizaciones).
4. Género gramatical. A diferencia del inglés, el español tiene género gramatical (masculino, femenino y muy pocos neutros). Estas son las convenciones para manejar el género gramatical cuando aparezcan en el texto. Las situaciones que no estén contempladas en la guía las discutiremos para tomar una decisión y las agregaremos a este listado.
En principio, intentaremos ajustar la redacción para evitar tener que asignar un género: por ejemplo, en esta frase: “… We are thankful for all authors, reviewers and guest editors”. se podría traducir como: Agradecemos a todas las personas que han sido autoras, revisoras y editoras invitadas.
-
Si no podemos evitar usar marca de género, lo más aceptado por el momento es el desdoblamiento, femenino-masculino o masculino-femenino, que puede ser de dos maneras, por ejemplo: las/los autoras/es, los/las revisores/as; o bien los y las autores y autoras, etc.
En esta traducción, al desdoblar:Vamos a utilizar los/las ó las/los privilegiando la agilidad y fluidez del texto, que el mismo se entienda y que sea claro el mensaje
Para que haya coherencia a lo largo del texto y mostrar que no hay una determinada jerarquía alternaremos el uso del femenino masculino primero, entre capítulos y el uso será consistente durante todo el capítulo.
Acuerdos: el uso de las barras puede entorpecer la lectura, aquí algunas opciones a tener en cuenta que pueden darle más fluidez al texto y respetar el lenguaje no sexista:
| Opción | Alternativa |
|---|---|
| del/de la revisora | del equipo revisor |
| al/a la editora docente | al conjunto de editores y editoras |
- La lectura del lenguaje no sexista con las conjunciones “al” y “del” es complicada.
Caso de capítulo los/las: dejar el masculino en la conjunción, pero no en el sustantivo si este tiene marca de género: “Al autor/a”.
Caso de capítulo las/los: dejar el femenino en el artículo, pero no en el sustantivo si este tiene marca de género: “A la desarrolladora/or”.
5. El español es una lengua menos repetitiva que el inglés. Como los verbos tienen marca de persona, género y número, tenemos la flexibilidad de poder omitir el sujeto, ya que por contexto se suele entender a qué nos estamos refiriendo. En todos los casos, hay que tratar de pensar cómo suena más natural en español y cómo queda más claro para quien lee.
6. Hay regularidades que no siempre se cumplen. Por ejemplo, en inglés los adjetivos se anteponen a los sustantivos, ej: simple model, correct answer, etc., mientras que en español suele ser al revés: ponemos los adjetivos después del sustantivo: modelo simple, respuesta correcta, etc. Sin embargo, hay casos en que en español la forma “no marcada”, es decir, la que nos suena más natural, es con el adjetivo al principio:
Ejemplo: > …There’s a better way… > …Hay una mejor manera…
En general, ante dudas de este tipo, pensar en qué es lo que suena más natural/normal en español.
7. El español tiene más modos y tiempos verbales que el inglés Al traducir, por lo tanto, se debe priorizar la forma verbal que sea mejor para expresar el sentido del fragmento en español, no la que parezca ser literal del inglés.
8. Las expresiones idiomáticas no son traducibles de manera literal. En caso de que las hubiere, hay que proponer una traducción que permita entender el sentido de expresión original. A veces existen expresiones de similar significado.
Ejemplo: > …Birds of a feather, drawn together… > …Ellos se crian y el viento los amontona…
9. Toma distancia para revisar. Cuando trabajamos mucho rato en un texto cuesta identificar errores de tipeo. Como sugerencia, una vez que termines la revisón del capítulo o sección deja pasar un tiempo (algunas horas o un día) antes de hacer la última lectura y enviarla. Eso hace más fácil que salten a la vista este tipo de detalles y permite que quienes hagan la revisión se concentren en la calidad de la traducción más que en correcciones ortotipográficas. También es útil revisar el texto en una versión con formato (compilada como pdf o html), ya que seguramente algunos errores serán más visibles que en la versión cruda. Si tienes la posibilidad, una impresión en papel, tanto de la versión cruda como de la compilada, también ayuda a ver más claro los errores.
4.3 C. Traducción (o no) de términos técnicos
Hay términos técnicos que será necesario traducir y otros que no. Para decidir tomemos en cuenta si existe una versión en español extendida o si se suele utilizar la versión original en inglés.
Como fuentes de consulta se pueden utilizar Wikipedia, GLosario y el diccionario bilingüe de Enseñar Tecnología en Comunidad
4.3.0.1 1. Términos técnicos que se mantienen
Estos términos deben ir en un formato especial (por ejemplo cursiva). De ser pertinente, se debe ofrecer una posible traducción al español, ya que en algunos casos permite entender mejor el concepto que está detrás y determinar qué género gramatical asignarle.
En el [Chapter @glosario] de rOpenSci se cuenta con el listado actualizado de términos técnicos que se mantienen.
4.3.0.2 2. Términos técnicos que se traducen
Los términos técnicos que se traducen también se listan y actualizan en el [Chapter @glosario]. Recordar que la primera aparición en el texto puede acompañarse con la palabra en inglés entre paréntesis para ayudar a entender el contexto y el significado.
Además, tengamos en cuenta como escribir estos términos del Latín:
| Latin | Español |
|---|---|
| i.e. (id est) | “es decir” |
| e.g. (exempli gratia) | por ejemplo, abreviatura “p. ej.” |
4.3.0.3 3. Material referenciado en la guía
Cuando se encuentre una referencia a la denominación de material mencionado en el libro, como títulos de libros, nombres de instituciones, sitios web, guías, etc. Se deja el título/nombre original en Inglés con la letra en cursiva y se aclara entre paréntesis una traducción del título/nombre en español.
4.3.0.4 4. Código
Traducir:
nombres de variables;
nombres de constantes;
comentarios;
funciones y sus parámetros, solo cuando son ejemplos de funciones generadas por la persona que desarrolla: si un fragmento de código crea una función como ejemplo, podemos poner su nombre y el de sus parámetros en español.
ejemplo:
Código original:
inside <- function(point, lower, higher) {
if (point <= lower) {
return false
} else if (point >= higher) {
return false
} else {
return true
}
}
Traducción al Español:
adentro <- function(punto, mas_bajo, mas_alto) {
if (punto <= mas_bajo) {
return false
} else if (punto >= mas_alto) {
return false
} else {
return true
}
}No se traducen los nombres de funciones y sus parámetros correspondientes al lenguaje R y sus paquetes. Se debe ofrecer una traducción de estos elementos la primera vez que aparecen.
Ejemplo:
Original: Use message() and warning() to communicate with the user in your functions
Traducción: Usa message() — del inglés mensaje — y warning() — del inglés advertencia — para comunicarte con quien use tus funciones.
Tampoco se traducen los caminos relativos a archivos.
4.4 D. Aspectos de ortografía / gramática del español
- Ni los demostrativos ni el adverbio “solo” se tildan.
- Días y meses se escriben con minúscula en español.
- Los títulos llevan mayúscula solo en la palabra inicial (salvo que incluyan un nombre propio).
- Para consultar la forma convencional de una abreviatura en español, revisar este enlace.
| Palabra | Abreviatura |
|---|---|
| por ejemplo | p. ej. |
4.5 E. Aspectos de puntuación del español
-
Uso de las comas antes del y: no usarla, excepto que:
sea necesario para darle claridad al texto;
sea necesario luego de una enumeración anterior, según este ejemplo:
- “Preparé el examen y tomé un café”: va sin coma
- “Preparé el examen y la clase de la semana siguiente, y tomé un café”: va con coma para distinguir del “y” de la primera parte de la oración.
Fuente: punto 2 de https://www.rae.es/dpd/coma
-
Punto y paréntesis:
- Si hay una oración completa dentro del paréntesis, el punto va adentro. (Por ejemplo si acá sigue un comentario extra sobre algo que decidió poner en una oración aparte, creo que lo hace con acotaciones.)
- Si el paréntesis es una aclaración dentro de la oración, el punto va afuera (este caso).
5 Glosario
Este glosario se desarrolla en el marco de las traducciones del material de rOpenSci. Sirve de apoyo a la tarea de determinar qué términos técnicos se traducen y cuales no. También es la fuente que determina que palabras preferimos utilizar antes la posibilidad de contar con más de una opción.
Como fuentes de consulta para generar nuestro glosario y mantenerlo actualizado se pueden utilizar Wikipedia, GLosario y el diccionario bilingüe de Enseñar Tecnología en Comunidad
5.1 Fuente
5.2 Glosario
5.3 F. Fuentes
Estas directrices de traducción se basan en la experiencia y los documentos generados durante la traducción de Enseñar Tecnología en Comunidad. También consultamos y tuvimos en cuenta la guía para traductores de Programming Historian, el proyecto de traducción colaborativa de “R para Ciencia de Datos” y el Glosario y lineamientos para las traducciones al español de The Carpentries.