PC World 2002 September

home *** CD-ROM | disk | FTP | other *** search

/ PC World 2002 September / PCWorld_2002-09_cd.bin / Komunik / amaya / 9x / amaya-Win98-6.2.exe / _SETUP.1 / Annotations.html.es < prev next >

Wrap

Extensible Markup Language | 2002-06-11 | 24.6 KB | 469 lines

<?xml version="1.0" encoding="iso-8859-1"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>Anotaciones en Amaya</title> <meta name="GENERATOR" content="amaya 5.2" /> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> </head> <body xml:lang="es" lang="es"> <table border="0" summary="toc"> <tbody> <tr> <td><img alt="W3C" src="../images/w3c_home" /> <img alt="Amaya" src="../images/amaya.gif" /></td> <td><a href="MakeBook.html" accesskey="p"><img alt="previa" src="../images/left.gif" /></a> <a href="Manual.html" accesskey="t"><img alt="arriba" src="../images/up.gif" /></a> <a href="Configure.html" accesskey="n"><img alt="siguiente" src="../images/right.gif" /></a> </td> </tr> </tbody> </table> <ul> <li><a href="#What">┐QuΘ es una Anotaci≤n?</a></li> <li><a href="#Local">Anotaciones Locales y Remotas</a></li> <li><a href="#Annotation">El Men· Anotaciones</a></li> <li><a href="#Configurat">Preparando la Configuraci≤n para las Anotaciones</a></li> <li><a href="#Creating1">Creando una Anotaci≤n</a></li> <li><a href="#Deleting">Borrando una Anotaci≤n</a></li> <li><a href="#Loading">Cargando y Presentando Anotaciones</a></li> <li><a href="#Navigating">Navegando entre Anotaciones</a></li> <li><a href="#Moving">Moviendo Anotaciones</a></li> <li><a href="#Issues1">Problemas con Anotaciones y Documentos Modificados</a></li> </ul> <div id="Annotations"> <h2>Anotaciones en Amaya</h2> <h3><a name="What">┐QuΘ es una Anotaci≤n?</a></h3> La anotaciones son comentarios, notas, explicaciones, u otro tipo de observaciones que pueden adjuntarse a un documento Web o a una parte seleccionada del documento. Como son externas es posible anotar cualquier documento Web de manera independiente, sin necesidad de editar ese documento. Desde el punto de vista tΘcnico, las anotaciones normalmente son vistas como metadatos, ya que dan informaci≤n adicional sobre una porci≤n existente de datos. En este proyecto, para describir las anotaciones usamos un <a href="http://www.w3.org/RDF/">RDF</a> <a href="http://www.w3.org/2000/10/annotation-ns">annotation schema</a> especial. Las anotaciones pueden guardarse localmente o en uno o mßs servidores de anotaciones. Cuando un documento es hojeado, Amaya llama a cada uno de esos servidores, solicitando las anotaciones relacionadas con el documento. Actualmente Amaya presenta las anotaciones con los iconos de anotaci≤n ( <img src="../images/annot.png" alt="Icono lßpiz de anotaci≤n" /> ) que estßn visualmente incrustados en el documento, como se muestra en la figura de abajo. Si el usuario hace un ·nico clic sobre un icono de anotaci≤n, el texto que ha sido anotado se resalta. Si el usuario hace doble clic sobre este icono, el texto de la anotaci≤n y otros metadatos se presentan en una ventana aparte. <img src="../images/annotationicon-es.png" alt="icono de anotaci≤n (= lßpiz)" /> Una anotaci≤n tiene muchas propiedades, incluyendo: <ul> <li>Localizaci≤n fφsica: ┐La anotaci≤n estß almacenada en un archivo local o en una servidor de anotaciones?</li> <li>Alcance: ┐Estß la anotaci≤n asociada a todo el documento o s≤lo a un fragmento de ese documento?</li> <li>Tipo de anotaci≤n: 'Anotaci≤n', 'Comentario', 'Consulta', ...</li> </ul> <h3 id="Local">Anotaciones locales y remotas</h3> Amaya puede guardar datos de anotaciones en un sistema de archivo local (llamado "anotaciones locales") o en la Web (llamado "anotaciones remotas"). Anotaciones remotas son las almacenadas en servidores de anotaciones y pueden ser descargadas y almacenadas por cualquiera que tenga los apropiados derechos de acceso, tal como en el caso de otros documentos <acronym title="HyperText Markup Language" xml:lang="en" lang="en">HTML</acronym>. TambiΘn nos referimos a anotaciones remotas como anotaciones p·blicas o compartidas, ya que pueden ser vistas por otras personas. Si deseas instalar tu propio servidor de anotaciones, por favor, ve a <a href="http://www.w3.org/1999/02/26-modules/User/Annotations-HOWTO.html">Annotation-Server-HOWTO</a>. El usuario no necesita un servidor para hacer una anotaci≤n local. Las anotaciones locales se almacenan en el <a href="/home/kahan/Amaya/doc/amaya/Configure.html">directorio de preferencias de usuario</a>, en un directorio especial llamado "<code>annotations</code>", y s≤lo puede ser visto por el due±o (de acuerdo a c≤mo estΘ organizado el sistema de derechos de acceso). Este directorio estß conformado por tres tipos de ficheros: <dl> <dt>annot.index</dt> <dd>asocia <acronym title="Uniform Resource Locator" xml:lang="en" lang="en">URLs</acronym> con los archivos en los que se almacenan los metadatos de las anotaciones.</dd> <dt>index + random suffix</dt> <dd>un fichero que almacena el metadato de las anotaciones relacionadas con una <acronym title="Uniform Resource Locator" xml:lang="en" lang="en">URL</acronym> dada. El metadato se especifica con RDF.</dd> <dt>annot + random suffix.html</dt> <dd>contiene el cuerpo de una anotaci≤n, almacenado como <acronym title="EXtensible HTML" xml:lang="en" lang="en">XHTML</acronym>.</dd> </dl> Un usuario puede, en cualquier momento, convertir una anotaci≤n local en una compartida usando la opci≤n de men· Anotaciones/Post anotaci≤n. Si esta operaci≤n tiene Θxito, la anotaci≤n local serß borrada ya que serß movida a un servidor de anotacion. La siguiente secci≤n describe c≤mo indicar el nombre del servidor en el que deberφan colocarse las anotaciones. <h3 id="Annotation">Men· Anotaciones</h3> La mayorφa de los comandos necesarios para manejar anotaciones se encuentran en el men· Anotaciones mostrado abajo. Los comandos se explican mßs adelante en este documento, en el contexto de las metas del usuario cuando maneja anotaciones. <img src="../images/annotationsmenu-es.png" alt="Men· Anotaciones" /> <h3 id="Configurat">Preparando la Configuraci≤n para las Anotaciones</h3> El men· de configuraci≤n de anotaciones se encuentra bajo la opci≤n de men· Anotaciones/Configurar. La siguiente figura muestra la versi≤n Windows de este men·. La versi≤n Unix tiene una interfaz de usuario un tanto diferente, pero las mismas funcionalidades. <img src="../images/configurebox-es.png" alt="cuadro de dißlogo de configuraci≤n" /> <dl> <dt>Anotaci≤n de usuario</dt> <dd>Un campo que estß asociado con cada nueva anotaci≤n como el autor de la anotaci≤n. Amaya utiliza, por defecto, el identificador de usuario de la persona, cuando crea el campo de metadato autor. La selecci≤n de la anotaci≤n de usuario le permite a un usuario cambiar este nombre por uno mßs significativo, por ejemplo, en vez de <code>u1723242</code> (que hace felφz a mi administrador de sistema) <code>marja</code> (que es el que usan otras personas normalmente cuando hablan conmigo).</dd> <dt>Servidores de Anotaciones</dt> <dd>Este campo le dice a Amaya quΘ servidores debe contactar cuando busque anotaciones. Se pueden especificar uno o mßs servidores. Hemos reservado el nombre de servidor localhost para decirle a Amaya que queremos buscar anotaciones locales. Esto no significa que estemos poniendo en marcha un servidor local de anotaciones. Si este fuera el caso, necesitarφamos indicar la <acronym title="Uniform Resource Locator" xml:lang="en" lang="en">URL</acronym> completa. Bajo Unix, los servidores de anotaci≤n se especifican como una lista separada por espacios. Bajo Windows, son a±adidos uno tras otro tecleando sus nombres directamente en el cuadro de dißlogo, utilizando la tecla <code>Enter</code> para a±adir uno nuevo. Por defecto, el campo para servidores de anotaciones indica un <code>localhost</code>. Truco: Si quieres deshabilitar temporalmente un servidor de anotaci≤n, a±ade el carßcter "-" antes de su <acronym title="Uniform Resource Locator" xml:lang="en" lang="en">URL</acronym>. Amaya lo ignorarß. </dd> <dt>Autocargar anotaciones locales/Autocargar anotaciones remotas</dt> <dd>Esta opci≤n le dice a Amaya si solicita o no anotaciones, automßticamente (esto es, consultar a los servidores de anotaciones) cada vez que una <acronym title="Uniform Resource Locator" xml:lang="en" lang="en">URL</acronym> es navegada. Si no estß seleccionada, entonces el usuario tiene que invocar manualmente la funci≤n Cargar anotaciones desde el men· Anotaciones. N≤tese que si se selecciona la opci≤n <code>autocargar anotaciones remotas</code>, puede haber un retraso mientras Amaya resuelve el nombre de DNS de los servidores de anotaci≤n. Por defecto ambas opciones aparecen sin seleccionar.</dd> <dt>Deshabilitar autocarga remota en cada inicio</dt> <dd>Si esta opci≤n estß seleccionada, Amaya restablecerß la opci≤n <code>autocargar anotaciones remotas</code> cada vez que se inicie. Esta opci≤n puede ser ·til si estßs trabajando desconectado a ratos, pero seguirß queriendo autocargar las anotaciones locales, y las remotas de vez en cuando, por ejemplo, cuando te conectas durante un rato.</dd> <dt>Servidor de publicaci≤n</dt> <dd>Este campo define el servidor en el que serßn publicadas las anotaciones. Las anotaciones locales se guardan siempre en una base de datos local, independientemente del valor de este campo. Por defecto este campo estß vacφo. Advierte que el servidor de publicaci≤n no estß incluido automßticamente en la lista de servidores a ser consultados, se debe indicar el nombre del servidor de publicaci≤n en ambos campos, en cualquier orden que t· elijas. </dd> </dl> <h3 id="Creating">Creando una anotaci≤n</h3> Esta versi≤n de Amaya soporta dos tipos de anotaciones: anotaciones que se refieren a un documento completo y anotaciones que se refieren a un punto especφfico o selecci≤n en un documento. Para anotar un documento completo, tan solo selecciona la opci≤n de men· <h2></h2> Anotaciones/Anotar documento. Para anotar un punto, pon el cursor en cualquier punto en el documento y selecciona la opci≤n de men· Anotaciones/Seleccionar anotaci≤n. Para anotar una selecci≤n, selecciona algo en el documento, y luego usa la opci≤n de men· Anotaciones/Anotar selecci≤n. En todos estos casos aparecerß una ventana de anotaci≤n (ver la figura siguiente). El contenido de esta ventana muestra el metadato de la anotaci≤n, dentro de un recuadro, y el cuerpo de la anotaci≤n. <img src="../images/annotationwindow-es.png" alt="cuadro de dißlogo de configuraci≤n de anotaciones" /> Normalmente, el metadato consiste en el nombre del autor, el tφtulo del documento anotado, el tipo de anotaci≤n, la fecha de creaci≤n, y la fecha de ·ltima modificaci≤n. Algunos de los campos de metadatos tienen propiedades especiales. El campo documento fuente es tambiΘn un enlace que apunta de vuelta al texto anotado. Si el usuario hace doble clic sobre Θl, al igual que se sigue cualquier otro enlace en Amaya, el documento anotado serß obtenido y el texto anotado aparecerß resaltado. El campo tipos de anotaci≤n permite al usuario clasificar la anotaci≤n y cambiar su tipo. Haz doble clic sobre el texto "tipo de anotaci≤n" para ver la lista de tipos disponibles. Describiremos mßs abajo c≤mo pueden los usuarios definir tambiΘn, sus propios tipos de anotaciones. Finalmente, el campo ┌ltima modificaci≤n se actualiza automßticamente cada vez que se guarda una anotaci≤n. Debajo, el ßrea principal es el ßrea del cuerpo de anotaci≤n. Muestra el contenido actual y puede ser editada como si estuviΘramos editando cualquier otro documento <acronym title="HyperText Markup Language" xml:lang="en" lang="en">HTML</acronym>, .N.B., aunque todavφa no se pueden incluir imßgenes en el cuerpo. Algunas de las caracterφsticas pueden no estar listas en la versi≤n inicial, tales como la vista Estructura. Guardar una anotaci≤n es equivalente a guardar cualquier otro documento en Amaya. El usuario s≤lo necesita seleccionar el comando Archivo/Guardar (o utilizar su equivalente atajo de teclado o bot≤n del men·). Las anotaciones locales se guardan en el directorio "annotations" y las anotaciones remotas se guardan en el servidor de publicaci≤n de anotaciones donde son almacenadas si el usuario ha escrito el acceso. Para convertir una anotaci≤n local en una compartida, el usuario necesita usar el comando Anotaciones/Publicar anotaci≤n y la anotaci≤n serß guardada en el Servidor de publicaci≤n que estΘ definido en el men· de configuraci≤n. Si esta operaci≤n tiene Θxito, la anotaci≤n local serß borrada y las futuras operaciones de guardado irßn directamente al servidor de anotaciones. En la versi≤n inicial, Amaya no soporta una operaci≤n de guardado de una copia de una anotaci≤n remota en el directorio local de anotaciones. Algunos comandos aplicados al documento en la ventana Documento Amaya se aplicarßn al documento de anotaci≤n en la ventana Anotaci≤n. Por ejemplo, el cuerpo de una anotaci≤n puede imprimirse con el comando Archivo/Imprimir o recargado con el comando Archivo/Recargar documento. (Nota: Algunas de estas caracterφsticas pueden no estar incluφdas a·n). <h3 id="Deleting">Borrando una Anotaci≤n</h3> El comando del men· Anotaciones/Borrar anotaci≤n permite borrar una anotaci≤n. Se puede invocar este comando desde una ventana de anotaci≤n abierta. TambiΘn se puede borrar una anotaci≤n desde el documento anotado seleccionando primero la anotaci≤n, haciendo un ·nico clic sobre el icono de anotaci≤n, y luego llamando a este comando de men·. <h3 id="Loading">Cargando y Presentando Anotaciones</h3> El comando Cargar Anotaciones le dice a Amaya que cargue las anotaciones asociadas a la <acronym title="Uniform Resource Locator" xml:lang="en" lang="en">URL</acronym> del documento que estß siendo navegado en esa ventana. Amaya consultarß al servidor de anotaciones, que estΘ indicado en el cuadro de dißlogo Anotaciones/Configurar, pidiΘndole cualquier anotaci≤n relevante. Las anotaciones pueden descargarse tambiΘn automßticamente siempre que se carga una nueva pßgina seleccionando la casilla de verificaci≤n Autocargar anotaciones en el cuadro de dißlogo Anotaciones/Configurar. Notese que en esta versi≤n de Amaya, al interrogar a un servidor de anotaciones devolverß todas las anotaciones que estßn asociadas a un documento. En una versi≤n futura serß posible usar un men· personalizado para refinar la cadena de interrogantes que se envφa a los servidores. El men· Anotaciones/Filtro local permite al usuario mostrar o esconder los iconos de anotaci≤n desde la vista de documento, por ejemplo, para concentrarse en aquello que realmente le interesan o para hacer mßs fßcil la lectura de un documento lleno de anotaciones. El usuario puede mostrar o esconder anotaciones por tres tipos de metadatos: por el nombre de autor de la anotaci≤n, por el tipo de anotaci≤n, y por el nombre de servidor de anotaci≤n. Para aplicar uno de estos filtros, necesitas hacer clic en el bot≤n de opci≤n para seleccionar un tipo de anotaci≤n dado y, luego en el correspondiente bot≤n de acci≤n. Los comandos Mostrar todo y Esconder todo se aplican a todas las anotaciones. Un peque±o e inc≤modo caracter a modo de prefijo se±ala el estado de una entrada dada. Este caracter puede ser tanto un espacio (' '), un asterisco ('*') o un gui≤n ('-') para declarar que esas anotaciones que pertenecen a esa entrada dada estßn todas visibles, todas escondidas,o parcialmente visibles, respectivamente. Ten en cuenta que el men· filtro s≤lo muestra las anotaciones que conoce que existen en el momento de su invocaci≤n. Si a±ades nuevas anotaciones entretanto, tendrßs que destruir este men· e invocarlo de nuevo para verlas. Advierte que para cada anotaci≤n, el usuario de anotaci≤n se muestra concatenando el nombre del autor con el nombre del servidor de anotaci≤n en el que estß almacenada la anotaci≤n, tal como se muestra en la siguiente figura. <img src="../images/localfilter-es.png" alt="cuadro de dißlogo del filtro local" /> <h3 id="Navigating">Navegando entre Anotaciones</h3> La anotaciones aparecen como enlaces en la ventana Enlaces que puede abrirse mediante el comando Vistas/Mostrar enlaces. En esta ventana las anotaciones aparecen marcadas con el mismo icono del lßpiz, usado en las anotaciones en la ventana de documento. La ventana Enlace muestra todas las anotaciones, sin tener en cuenta si han sido escondidas con el men· Filtro Local de Anotaciones. Al igual que en la ventana de documento, un ·nico clic sobre la anotaci≤n seleccionarß el texto anotado en la ventana de documento y un doble clic abrirß la anotaci≤n. Este es un ejemplo de c≤mo navegar de un enlace de anotaci≤n a otro, incluso si la anotaci≤n no pude ser vista por el usuario debido a su discapacidad o debido a las caracterφsticas del dispositivo usado. <img src="../images/linkwindow-es.png" alt="La vista enlaces muestra las anotaciones" /> <h3 id="Moving">Moviendo anotaciones</h3> Amaya tambiΘn te permite mover una anotaci≤n a cualquier otra parte del mismo documento. Esto es interesante, por ejemplo, para manejar <a href="#Issues1">anotaciones huΘrfanas y corruptas</a>. Se puede mover una anotaci≤n a la selecci≤n actual o tambiΘn a el valor de un XPointer almacenado. Por el momento s≤lo es posible mover anotaciones en el mismo documento en el que han sido creadas. Para mover una anotaci≤n a la selecci≤n actual, primero hay que abrir la ventana de anotaci≤n. Entonces hay que hacer clic en el documento anotado y seleccionar algo en Θl. Luego, en la Ventana Anotaci≤n, invocar el men· Anotaciones/Mover a selecci≤n. Amaya moverß entonces el icono de anotaci≤n al texto seleccionado y marcarß el documento de anotaci≤n como modificado. Para conseguir que este cambio se efectivo hay que guardar la anotaci≤n, de otra manera se perderßn los cambios. Al igual que en la creaci≤n de anotaciones se puede mover una anotaci≤n a la posici≤n actual del cursor, sin tener que hacer una selecci≤n. TambiΘn se puede memorizar la posici≤n a la que se quiere mover la anotaci≤n y, entonces, moverla ahφ. Esto es ·til, por ejemplo, si se quieren mover varias anotaciones a la misma posici≤n o si se quiere desplazarse a cualquier parte del documento antes de moverlas. Para hacer esto, haz una selecci≤n (o s≤lo posiciona el cursor) en el lugar en el que quieres mover la anotaci≤n. Entonces utiliza el men· Enlace/Almacenar enlace como XPointer para almacenar internamente un XPointer que represente la selecci≤n. Finalmente, en la ventana Anotaciones, utiliza el men· Anotaciones/Mover para almacenar XPointer para mover la anotaci≤n a su nueva localizaci≤n. Al igual que antes deberßs guardar la anotaci≤n para hacer efectivo el cambio. </div> <div id="Issues"> <h3 id="Issues1">Problemas con Anotaciones y Documentos Modificados</h3> Si se estß usando anotaciones con documentos en vivo (documentos cuyos contenidos pueden ser modificados) puedes encontrar dos tipos de problemas: anotaciones huΘrfanas y anotaciones corruptas. DΘjanos antes describir un poco mßs en detalle c≤mo Amaya a±ade anotaciones a los documentos. Amaya utiliza <a href="http://www.w3.org/XML/Linking">XPointer</a> para describir d≤nde debe a±adirse una anotaci≤n a un documento. XPointer estß basado en la estructura del documento. Para construir un XPointer, por ejemplo para una selecci≤n, comenzamos desde el primer punto de la selecci≤n y vamos regresando a travΘs de la estructura del documento hasta encontrar la ruta del documento. Si un elemento tiene un atributo ID, paramos de construir el XPointer y consideramos que el comienzo de ese XPointer es el elemento que tiene ese valor de atributo ID. Por ejemplo, si miras el c≤digo <acronym title="HyperText Markup Language" xml:lang="en" lang="en">HTML</acronym> de este documento, notarßs que esta secci≤n (Problemas con anotaciones...) estß incluida dentro de un elemento DIV que tiene un atributo ID con el valor "Issues". Aquφ hay un extracto del c≤digo fuente: <pre> <div id="Issues"> <h3>Problemas con ....</h3> Si se estß usando... Amaya utiliza XPointer... ... </div></pre> Y aquφ el XPointer que apunta al segundo pßrrafo: <code>xpointer(id("Issues")/p[2])</code> El XPointer de arriba apunta al segundo elemento p, desde el elemento padre que tiene un atributo ID con el valor "Issues". (Para seleccionar un pßrrafo completo, ponemos el cursor en el pßrrafo y presionamos la tecla escape [Unix] o F2 [Windows]). N≤tese que el uso del atributo ID permite al autor del documento mover la selecci≤n completa, donde quiera en el documento, sin necesidad de actualizar el XPointer. El XPointer no depende del elemento que precede ese particular elemento DIV. Decimos que una anotaci≤n se queda huΘrfana cuando ya no puede ser a±adida a un documento, esto es, cuando el XPointer no determina nunca mßs ning·n elemento en la estructura. Esto pasa cuando una estructura de documento se modifica. Por ejemplo, el XPointer de arriba no podrφa determinar nunca mßs si eliminamos el atributo ID "Issues". Amaya te advertirß si detecta cualquier anotaci≤n huΘrfana mientras descarga una serie de anotaciones desde un servidor de anotaciones. Todas las anotaciones huΘrfanas son visibles desde la vista Enlaces y estßn asociadas con un icono que muestra un signo de interrogaci≤n superpuesto al lßpiz de anotaciones <img src="../images/annotorp.png" alt="icono de anotaciones huΘrfanas" />. Decimos que una anotaci≤n es corrupta cuando apunta a una pieza de informaci≤n err≤nea. Volviendo a nuestro ejemplo, podemos crear una anotaci≤n corrupta si intercambiamos el primer y segundo pßrrafo. El XPointer continuarß apuntando al segundo pßrrafo, a pesar de que nos gustarφa que apuntara al primer pßrrafo. Este problema se hace incluso mßs com·n cuando anotas una porci≤n de texto que puede cambiar. En la primera versi≤n, Amaya no advierte al usuario si una anotaci≤n estß corrupta. Una futura versi≤n puede avisar al usuario de la posibilidad de que una anotaci≤n pueda llegar a ser corrupta. ┐C≤mo puedes protegerte a ti mismo? Si eres el autor de un documento, intenta usar el atributo ID en lugares estratΘgicos, por ejemplo, en los elementos DIV. Amaya te permite asociar automßticamente o eliminar un atributo ID a/desde una serie de elementos por medio del comando de men· Especial/Crear/Suprimir atributos ID. En el ejemplo de arriba, nosotros podrφamos haber evitado el problema de las anotaciones corruptas si hubiΘsemos a±adido un atributo ID al segundo pßrrafo: <pre> Amaya utiliza...</pre> Un XPointer que apunta a este pßrrafo es: <code>xpointer(id("Amaya"))</code> De esta manera, el XPointer apuntarß al mismo pßrrafo, independientemente de su posici≤n en la estructura del documento. </div> <a href="MakeBook.html"><img alt="previa" src="../images/left.gif" /></a> <a href="Manual.html"><img alt="arriba" src="../images/up.gif" /></a> <a href="Configure.html"><img alt="siguiente" src="../images/right.gif" /></a> <hr /> </body> </html>