Anotación Ruby

1.1 Qué es ruby?

Ruby es el término utilizado para una sentencia de texto asociada con otra sentencia de texto, la que se refiere como texto base. El texto ruby se utiliza para proveer una anotación corta del texto base asociado. Mayormente se utiliza para suministrar una lectura (guía de pronunciación). Las anotaciones se usan frecuentemente en Japón en muchos tipos de publicaciones, que incluyen libros y revistas. También se utilizan en China, especialmente en libros de texto.

El texto ruby usualmente se presenta al lado del texto base, con una tipografía más pequeña. El nombre “ruby”, de hecho, se originó del nombre de la fuente tamaño 5.5pt en la imprenta británica, que es casi la mitad del tamaño 10pt comúnmente utilizado en textos normales. La Figura 1.1 muestra un ejemplo, con tres ideogramas (kanji) como texto base, y seis hiragana que le dan la lectura (shinkansen - tren bala japonés).

La tipografía oriental ha desarrollado varias características que no aparecen en la tipografía occidental. La mayoría de las mismas se pueden tratar apropiadamente con lenguajes tales como CSS o XSL. Sin embargo, se requieren marcas adicionales para definir la asociación entre el texto base y el texto ruby.

Esta especificación define tal marca, diseñada para ser usada con el XHTML, de manera que el texto ruby se encuentre disponible en la Web sin utilizar controladores de salida especiales o gráficos. A pesar de que esta especificación nos da el ejemplo de la interpretación actual para facilitar a la mayoría de los lectores el entendimiento de la marca, tales ejemplos son sólo informativos. Este documento no especifica ningún mecanismo para la presentación o el estilo, eso parte de los lenguajes de hojas de estilo respectivos.

A veces, más de un texto ruby es asociado con el mismo texto base. Un ejemplo típico es indicar ambos significados así como la lectura para el mismo texto base. En tales casos, los textos ruby pueden aparecer en ambos lados del texto base. El texto ruby antes del texto base se utiliza a menudo para indicar la lectura, el texto ruby luego del texto base se usa para indicar el significado. La Figura 1.2 nos muestra un ejemplo de texto base con dos textos ruby, utilizando hiragana y Letras Latinas en la lectura.

Más aún, cada texto ruby puede asociarse con partes diferentes, pero superpuestas, del texto base, como vemos en el siguiente ejemplo:

En este ejemplo, el texto base es la fecha “10 31 2002”. Un texto ruby es la frase “Fecha de Vencimiento”. El mismo está asociado con el texto base entero. El otro texto ruby tiene 3 partes: “Mes”, “Día” y “Año” Cada parte se asocia con una parte diferente del texto base. “Mes” se asocia con “10”, “Día” se asocia con “31” y “Año” se asocia con “2002”.

1.2 Visión General de las Marcas en Ruby

Las marcas definidas en esta especificación están diseñadas para cubrir todos los casos antes mencionados, ya sean marcas para uno o dos textos ruby asociados con el mismo texto base y marcas para asociaciones de subseries del/los texto(s) ruby con componentes del texto base.

Existen dos variantes de las marcas que se le aplican al texto llamadas marcas ruby simples y marcas ruby complejas. Las marcas ruby simples asocian un texto ruby simple con una sentencia del texto base. La marca ruby simple también puede especificar un mecanismo de soporte que permita exhibir el texto ruby mediante browsers (de antiguas versiones) que no conocen acerca de las marcas. La marca ruby compleja puede asociar dos textos ruby con un texto base, y puede definir una asociación más detallada entre los componentes del texto ruby y el texto base. Sin embargo, la marca ruby compleja no provee de un mecanismo de soporte para browsers que no asimilen marcas ruby.

Esta sección nos brinda un panorama acerca de las marcas para ruby definido en esta especificación. Una definición formal y completa puede encontrarse en la Sección 2.

<ruby>  <rb>WWW</rb>  <rt>World Wide Web</rt></ruby>

<ruby>  <rb>WWW</rb>  <rp>(</rp><rt>World Wide Web</rt><rp>)</rp></ruby>

<ruby>
  <rbc>
    <rb>10</rb>
    <rb>31</rb>
    <rb>2002</rb>
  </rbc>
  <rtc>
    <rt>Month</rt>
    <rt>Day</rt>
    <rt>Year</rt>
  </rtc>  <rtc>
    <rt rbspan="3">Expiration Date</rt>
  </rtc></ruby>

3.1 Ruby en la Web versus el uso de la tipográfica tradicional

El término “ruby” en Japonés sólo se utiliza para un texto visualmente representado al lado del texto base. Las consideraciones para tales casos se pueden encontrar en la sección 3.2 (tamaño de fuente), sección 3.3 (posicionamiento), y sección 3.4 (presentación de la marca ruby). Este tipo de presentación debería utilizarse dondequiera que sea posible. Sin embargo, introducir a ruby en la Web puede dar lugar a algunos fenómenos y problemas que no se encuentran presentes en la tipografía tradicional. La marca estructural para ruby, como se la define en esta especificación, no garantiza que el texto ruby siempre aparezca al lado del texto base. Existe una amplia variedad de dispositivos de salida, ya sean actuales o futuros, para documentos marcados con XHTML. Los siguientes son posibles escenarios y razones para interpretaciones diferentes:

• En agentes de usuarios no visuales, como browsers de voz y usuarios de braile, sólo es posible la interpretación secuencial. Vea la sección 3.5 para mayores consideraciones acerca de la interpretación no visual.
• En dispositivos de exhibición de baja resolución, puede no ser viable exhibir el texto ruby en su tamaño normal. Se pueden utilizar sustituciones. Consulte la sección 3.6 para detalles adicionales.
• Para propósitos educacionales, puede ser interesante en algunos casos ocultar el texto ruby y que aparezca como un pop-up. Esto es imposible de plasmar en el papel, pero es fácil de lograr en un dispositivo dinámico de exhibición.

3.2 Tamaño de la fuente del texto ruby

En el uso típico, el tamaño de la fuente del texto ruby es normalmente la mitad del tamaño de la fuente del texto base. De hecho, el nombre “ruby” se originó del nombre del tamaño de la fuente 5.5pt de la imprenta británica, que es la mitad del tamaño de fuente de 10pt que comúnmente se utiliza en el texto normal.

3.3 Posicionamiento del texto ruby

Existen varias posiciones donde el texto ruby puede aparecer allegado al texto base. Debido a que los textos asiáticos pueden representarse tanto en forma vertical como horizontal, los términos “antes” y “después” se utilizan antes que “arriba” y “abajo” o “lado derecho” o “lado izquierdo”. Las palabras “antes” y “después” deberían interpretarse como “antes”/”después” de la línea que contiene al texto base. La correspondencia se describe en la siguiente tabla:

Los textos ruby frecuentemente se colocan antes del texto base (ver Figura 1.1 y Figura 3.2). A veces, y en especial en documentos educativos horizontales, el texto ruby puede aparecer luego del texto base, es decir, por debajo (ver Figura 3.1). En Chino, es bastante común que el texto ruby Pinyin aparezca luego del texto base. También puede aparecer luego del texto base en un esquema vertical (ver Figura 3.3). En todos estos casos, la dirección de escritura del texto ruby es la misma que la del texto base, que es vertical si el texto base es vertical, y horizontal si el texto base también lo es.

En los textos tradicionales chinos, el texto ruby “Bopomofo” puede aparecer junto al lado derecho del texto base, aún en un esquema horizontal.

Note que las marcas de entonación Bopomofo (en rojo en el ejemplo anterior) parecen estar en una columna separada (junto al lado derecho del texto ruby Bopomofo) y de esta manera podrían verse como “ruby en ruby”. Sin embargo, están simplemente codificadas como parte del texto ruby. Los detalles de esta codificación no son tratados en este documento.

3.4 Presentación de la marca ruby

Esta especificación no formula cómo será exhibida la marca ruby. Las hojas de estilo, en general, se utilizarán para especificar el comportamiento exacto de la marca ruby.

Para que las hojas de estilo pueda aplicar el estilo, o para que otros mecanismos presenten al texto ruby de manera apropiada, es muy importante proveer la información suficiente acerca de la función de cada componente. El siguiente ejemplo ilustra el uso del atributo de clase que le permite a las hojas de estilo definir la presentación exacta del texto ruby. La clase "reading" se utiliza para un texto ruby que indica lectura. La clase "annotation" se usa para indicar un texto ruby que se usa para anotaciones. El atributo xml:lang indica el lenguaje del texto.

<ruby xml:lang="ja">
  <rbc>
    <rb>斎</rb>
    <rb>藤</rb>
    <rb>信</rb>
    <rb>男</rb>
  </rbc>
  <rtc class="reading">
    <rt>さい</rt>    <rt>とう</rt>
    <rt>のぶ</rt>
    <rt>お</rt>
  </rtc>
  <rtc class="annotation">
    <rt rbspan="4" xml:lang="en">
W3C Associate Chairman</rt>
  </rtc></ruby>

La utilización de hojas de estilo que especifican un texto horizontal, presentando a la lectura antes del texto base y a la anotación luego del texto base, puede llevar a que se interprete la marca de la siguiente manera:

3.5 Consideraciones para la presentación no visual

Los documentos que contienen marca ruby en algunos casos necesitan interpretarse por medio de agentes no visuales, como browsers de voz o agentes braile. Para tales escenarios, es importante comprender que:

• Pueden resultar apropiadas diferentes presentaciones, según el usuario y la situació.
• El texto ruby que representa lectura puede ser tratado de forma diferente que el texto ruby que contiene otro tipo de información.
• Para una interpretación no visual apropiada, es importante indicar la función de cada texto ruby.
• Existen a menudo algunas diferencias entre la lectura indicada por el texto ruby y la pronunciación real.
• El lector puede estar interesado en obtener información acerca del texto base (expresado en ideogramas.

Según las necesidades del usuario, la forma en la que debería leerse un texto puede variar desde una lectura muy rápida y “precipitada” a una muy cuidadosa y detallada. Esto nos puede llevar a considerar diferentes maneras de tratar al texto ruby en una presentación no visual, ya sea salteándolo durante la lectura rápida o explorando su estructura y los caracteres reales utilizados durante la lectura detallada.

En el caso frecuente de que los textos ruby representan la lectura, la presentación tanto del texto base como del texto ruby puede producir duplicaciones molestas. Un sintetizador del discurso puede pronunciar correctamente el texto base utilizando un diccionario, o en otros casos, puede seleccionar la pronunciación adecuada basándose en la lectura provista por el texto ruby.

No todos los textos ruby representan pronunciaciones. Los autores deberían distinguir a los textos ruby utilizados para diferentes propósitos mediante el atributo class . Esta premisa se demostró anteriormente al utilizar class="reading" para los textos ruby que indican lectura.

El texto ruby que indica lectura puede no producir la pronunciación correcta aún en los casos donde la escritura utilizada parece, a primera vista, perfectamente fonética. Por ejemplo, Bopomofo se asocia independientemente para cada carácter del texto base, y no se reflejan el sonido dependiente del contexto o los cambios de entonación. De manera similar, en Japonés, pueden ocurrir irregularidades silábicas, como la utilización de "は" (hiragana ha) para el sufijo pronunciado "わ" (wa), o de vocales para indicar alargamiento. Para tales casos, los autores pueden proveer la pronunciación real con una marca especial diseñada para estos propósitos, o pueden confiar en el sistema de presentación auditiva para manejar estos casos de manera correcta.

3.6 Alternativas para el elemento rp

Si el autor no está interesado acerca del mecanismo de sustitución para los agentes de usuarios que no conozcan acerca de la marca ruby o no soporten hojas de estilo CSS2 [CSS2] o XSL [XSL] , entonces los elementos rp no serán necesarios.

Sin embargo, es posible encerrar entre paréntesis al texto ruby como sustitución si por ejemplo la resolución del dispositivo no es apropiada para la presentación tradicional de ruby. Al utilizar [CSS2], el paréntesis se puede generar utilizando la propiedad de ‘contenido' ([CSS2], sección 12.2) con los before and :after pseudo-elements ([CSS2], sección 12.1), en el siguiente fragmento:

rt:before { content: "(" }rt:after { content: ")" }

En este ejemplo, el paréntesis se generará en forma automática alrededor del elemento rt . Se asume que las reglas de estilo mencionadas se utilizan juntas con las reglas de estilo que posicionan al texto ruby en línea. La generación del paréntesis no presenta problemas con XSLT [XSLT].