Estructuración de documentos para XML

Última actualización el 28/05/2018

Información general del panel Estructura

El panel Estructura muestra, en forma jerárquica, los elementos de un documento que se han marcado con etiquetas XML. Estos elementos se denominan elementos. Puede mover elementos en el panel Estructura para definir el orden y la jerarquía de los elementos. Un elemento consta de un icono que indica el tipo de elemento y un nombre de etiqueta.

Panel Estructura

A. Triángulo para expandir o contraer elementos B. Elemento C. Fragmento de texto D. Atributo 

Panel Estructura

A. Triángulo para expandir o contraer elementos B. Elemento C. Fragmento de texto D. Atributo 

Además, los elementos pueden proporcionar la siguiente información:

Rombo azul

Un diamante azul en el icono de un elemento significa que el elemento está vinculado a un elemento de la página; la ausencia de un diamante azul significa que el elemento no se ha vinculado a un elemento de página.

Subrayado

El nombre de la etiqueta aparece subrayado si el elemento de la página al que corresponde está seleccionado.Por ejemplo, si selecciona texto al que asignó la etiqueta Título, la palabra Título en el elemento del texto aparece subrayada en el panel Estructura. El subrayado le muestra si los elementos seleccionados en la página y los elementos del panel Estructura corresponden.

Fragmento de texto

Los primeros 32 caracteres del texto etiquetado, denominados fragmento de texto, pueden aparecer a la derecha del elemento. Estos fragmentos le ayudan a identificar el elemento de página al que corresponde un elemento.

Punto y atributo

Los atributos proporcionan información de metadatos sobre un elemento. Si hay atributos adjuntos a un elemento, aparece un punto negro junto con los nombres y valores de atributos debajo del elemento.

Usar el panel Estructura

  • Para abrir el panel Estructura, elija Ver > Estructura > Mostrar estructura.
  • Para cerrar el panel Estructura, elija Ver > Estructura > Ocultar estructura, o haga clic en el botón divisor.
  • Para expandir o contraer un elemento (y mostrar u ocultar cualquiera de sus elementos secundarios), haga clic en el triángulo situado junto al elemento.
  • Para ajustar el tamaño del panel Estructura, arrastre el botón divisor.
  • Para expandir o contraer un elemento así como todos los elementos contenidos dentro de él, mantenga pulsado Ctrl (Windows) o Comando (Mac) mientras hace clic en el triángulo situado junto al elemento.
  • Para mostrar u ocultar fragmentos de texto, elija Mostrar fragmentos de texto o Ocultar fragmentos de texto en el menú del panel Estructura.

Iconos del panel Estructura

Los siguientes iconos aparecen en el panel Estructura:

Icono

Nombre

Usar

 

Elemento raíz

Cada documento incluye un elemento raíz en la parte superior, que se puede cambiar de nombre pero no se puede mover ni eliminar.

 

Elemento de historia

Representa historias etiquetadas (uno o más marcos vinculados).

 

Elemento de texto

Representa texto etiquetado dentro de un marco.

 

Elemento gráfico

Representa un marco etiquetado que incluye una imagen colocada. Cada elemento gráfico incluye un atributo href que define la ruta o URL al archivo vinculado.

 

Elemento de texto sin colocar

Elemento de texto sin colocar que aún no está asociado con un elemento de página.

 

Elemento gráfico sin colocar

Elemento gráfico sin colocar que aún no está asociado con un elemento de página.

 

Elemento de tabla

Representa una tabla.

 

Elemento de celda de cabecera

Representa una celda en la fila de cabecera de una tabla.

 

Elemento de celda de cuerpo

Representa una celda dentro del cuerpo de una tabla.

 

Elemento de celda de pie

Representa una celda en la fila de pie de una tabla.

 

Elemento vacío

Un marco vacío está asociado con este elemento.

 

Atributo

Incluye metadatos, como palabras clave o ubicación de una imagen vinculada (atributo HREF).

 

Comentario

Incluye comentarios que aparecen en el archivo XML, pero no en el documento de InDesign.

 

Instrucción de proceso

Incluye una instrucción que activa una acción en aplicaciones que pueden leer instrucciones de procesamiento.

 

Elemento DOCTYPE

Indica a InDesign qué archivo DTD usar al validar el archivo XML.

Reorganización de elementos de estructura

Puede cambiar el orden y el rango jerárquico de elementos en el panel Estructura. Sin embargo, observe estas reglas:

  • Un documento XML requiere tener un único elemento raíz en la parte superior de la estructura. El elemento raíz contiene y es la página principal de todos los demás elementos. Solo la DTD (que aparece como elemento DOCTYPE), comentarios e instrucciones de procesamiento pueden aparecer por encima del elemento raíz en el panel Estructura.

  • Los cambios en la estructura de jerarquía XML pueden afectar la apariencia de los elementos etiquetados en las páginas de InCopy.Por ejemplo, convertir un elemento de texto en secundario de un elemento ubicado en otra parte de la estructura también mueve el texto en la maquetación.

  • No puede arrastrar un elemento de celda de tabla a un elemento de tabla o mover elementos a un elemento de tabla.

En el panel Estructura, realice una de las siguientes acciones:
  • Para mover un elemento, arrástrelo a una nueva ubicación dentro de la estructura. Aparece una línea al arrastrar para indicar dónde se va a insertar el elemento.La anchura de la línea marca el nivel dentro de la jerarquía.

  • Para convertir un elemento en secundario de otro elemento, colóquelo sobre el elemento página principal para resaltarlo o ubíquelo entre los otros elementos secundarios de la página principal, y luego suelte el botón del mouse.

  • Para descender un elemento un nivel en la jerarquía, arrástrelo justo por encima de otro elemento principal y muévalo hacia la izquierda ligeramente hasta que la línea que indica su ubicación abarque el ancho del elemento principal.

  • Para copiar o cortar un elemento, seleccionar el elemento o elementos en el panel Estructura y, a continuación, elegir Edición > Copiar o Edición > Cortar.Seleccione el elemento directamente encima del lugar donde desea insertar el elemento y elija Edición > Pegar.

Nota

Al cortar un elemento, el elemento y el contenido se cortan al portapapeles, pero el marco permanece intacto.

Inserción de un elemento principal

Insertar un elemento principal en el panel Estructura para mantener la estructura XML adecuada u organizar mejor el contenido.Antes de poder insertar un nuevo elemento principal, debe seleccionar los elementos que serán los elementos secundarios del nuevo elemento principal.Cuando se inserta el nuevo elemento principal, los elementos secundarios seleccionados descienden un nivel en la jerarquía estructural.

Con elementos secundarios seleccionados (izquierda); un elemento principal recién insertado incluye los elementos secundarios (derecha).

Con elementos secundarios seleccionados (izquierda); un elemento principal recién insertado incluye los elementos secundarios (derecha).

En el panel Estructura, seleccione los elementos que serán elementos secundarios del nuevo elemento principal que desea insertar.Tenga en cuenta lo siguiente:

  • No puede seleccionar la raíz o un elemento de nivel raíz.

  • No puede seleccionar la historia o un elemento de Nivel de historia.

  • Los elementos deben estar en el mismo nivel de la jerarquía estructural.

  • Los elementos deben ser contiguos.

  • La selección no debe incluir celdas de tabla o atributos.

En el menú del panel Estructura, elija Nuevo elemento principal o haga clic con el botón derecho (Windows) o haga clic mientras mantiene pulsada la tecla Control (Mac OS) y elija Nuevo elemento principal.

Seleccione una etiqueta para el nuevo elemento principal y haga clic en Aceptar.

Nota

Inserte un nuevo elemento principal rápidamente seleccionando Agregar etiqueta en el panel Etiquetas y, a continuación, haciendo clic en una etiqueta del panel. También puede hacer clic con el botón derecho (Windows) o hacer clic mientras mantiene pulsada la tecla Control (Mac) en un elemento que haya seleccionado en el panel Estructura, elegir Elemento principal nuevo y, a continuación, elegir un elemento.

Trabajar con atributos

Un atributo proporciona información adicional sobre un elemento XML. Cada atributo consta de un nombre y un valor.Los atributos aparecen en el panel Estructura; no se colocan en el documento ni se utilizan como contenido del documento.Incluya atributos con elementos para beneficio de archivos y aplicaciones que utilizarán los archivos XML que cree en InCopy.

Cuando etiqueta una imagen, InDesign crea automáticamente un atributo href con un valor que define la ubicación en disco del archivo de imagen.Este href atributo permite que otros archivos y aplicaciones localicen la imagen en el disco para que se pueda mostrar.

Un atributo incluye un nombre (href, en este caso) y un valor.

Puede agregar atributos a cualquier elemento excepto al elemento DOCTYPE (un archivo DTD), comentarios e instrucciones de procesamiento. Por ejemplo, para incluir palabras clave para la búsqueda en una aplicación posterior, puede crear un atributo llamado keywords.También podría crear atributos para indicar texto sustituido, realizar el seguimiento de títulos de artículos y registrar otra información relacionada con el contenido.

Nota

Si está utilizando un archivo DTD, consulte su contenido para ver qué atributos permite.Los nombres de atributos, al igual que los nombres de etiquetas, deben ajustarse al DTD.

Nota

InCopy reconoce atributos de espacio de nombres especiales que pueden especificar estilos de párrafo o de carácter, tablas y estilos de celda de tabla, así como controlar espacios en blanco.Para obtener más información, consulte la referencia técnica XML y otros recursos en www.adobe.com/go/learn_id_XMLscript.

Añadir un atributo

Seleccionar un elemento
Lleve a cabo una de las siguientes acciones:
  • Haga clic en el botón Agregar un atributo .

  • Elija Nuevo atributo en el menú del panel Estructura.

  • Haga clic con el botón derecho (Windows) o haga clic manteniendo pulsada la tecla Control (Mac OS) en el elemento seleccionado y elija Nuevo atributo.

Especifique un nombre y un valor para el atributo y, a continuación, haga clic en Aceptar.

Mostrar u ocultar atributos en el\npanel Estructura

Elija Mostrar atributos u Ocultar atributos en el menú del panel Estructura.

Es posible que tenga que hacer clic en el icono de triángulo situado junto a un elemento\npara mostrar sus atributos.

Editar o eliminar un atributo

Seleccione un atributo en el panel Estructura.
Lleve a cabo una de las siguientes acciones:
  • Para editar el atributo, haga doble clic en él o elija Editar en el menú del panel Estructura.

  • Para eliminar el atributo, haga clic en el icono Eliminar o\nelija Eliminar en el menú del panel Estructura.

Editar atributos href

InCopy crea atributos href\nautomáticamente para gestionar archivos de imagen.El atributo href\ndefine la ubicación en el disco del archivo de imagen para que el archivo\nde imagen se pueda mostrar.Al etiquetar una imagen colocada, InCopy crea un valor de atributo href\nque enumera la ruta y el nombre de archivo de la imagen.

La ruta puede ser\nun vínculo absoluto, un vínculo relativo a la misma carpeta que el archivo XML,\no un vínculo relativo a la subcarpeta Images de la carpeta donde se\nencuentra el archivo XML.Las rutas relativas son específicas de la ruta donde\nse guarda el documento.

  • Un atributo href\ncon un vínculo absoluto tiene el siguiente aspecto (en Windows\ny Mac OS):

    href=file:///C:/Images/Meadow.psd

    href=file:///Users/abhayc//Desktop/abc.jpg

  • Un atributo href a un archivo de imagen en la misma carpeta\nque el archivo XML tiene el siguiente aspecto:

    href=file:Meadow.psd

  • Un atributo href a un archivo de imagen en la subcarpeta Images tiene\nel siguiente aspecto:

    href=file:///Images/Meadow.psd

Puede editar el atributo href para especificar un nuevo vínculo a una imagen. Por ejemplo, puede editar un vínculo absoluto para convertirlo en un vínculo relativo, haciendo así que el archivo de imagen sea accesible cuando exporte el archivo.

En el panel Estructura, haga doble clic en el atributo href. (Es posible que tenga que hacer clic en el icono de triángulo junto al elemento de imagen para mostrar el atributo.)
En Valor, introduzca la nueva ruta a la imagen y, a continuación, haga clic en OK.

Agregar comentarios e instrucciones de procesamiento

Mediante InCopy, puede incluir comentarios e instrucciones de procesamiento en un archivo XML. Introduzca un comentario para incluir información descriptiva sobre un elemento. Los comentarios se pueden ver en exploradores web y editores de texto. Ayudan a otros a comprender la estructura XML y las etiquetas XML. Una instrucción de procesamiento es un comando especial específico de la aplicación. Por ejemplo, puede introducir una instrucción de procesamiento de salto de página para que una aplicación a la que exporte su archivo XML entienda dónde introducir un salto de página. Las instrucciones de procesamiento creadas por el usuario de InCopy están destinadas para su uso en otros programas; el propio InCopy no actúa sobre las instrucciones de procesamiento.

Los comentarios y las instrucciones de procesamiento aparecen en el panel Estructura. Puede mover, editar y eliminar comentarios e instrucciones de procesamiento como puede hacer con otros elementos en el panel Estructura. Sin embargo, no pueden contener elementos secundarios o atributos.

Panel Estructura de InDesign con fragmentos de texto mostrados

A. Instrucción de proceso B. Comentario 

Agregar un comentario

Seleccione el elemento sobre el que va a comentar.
Nota

Para agregar un comentario a una tabla, seleccione un elemento de celda de tabla. Puede agregar comentarios a celdas de tabla, no a tablas.

Elija Nuevo comentario en el menú del panel Estructura.
Escriba el comentario en el cuadro de diálogo Nuevo comentario.

Agregar instrucción de procesamiento

Seleccione un elemento para la instrucción de procesamiento
Nota

Para añadir una instrucción de procesamiento a una tabla, seleccione un elemento de celda de tabla.Puede añadir instrucciones de procesamiento a celdas de tabla, no a tablas.

Elija Nueva instrucción de procesamiento en el menú del panel Estructura.
Para Target, introduzca un nombre que identifique la instrucción de procesamiento para una aplicación que lee archivos XML exportados.
Para Datos, introduzca un valor que indique a la aplicación qué hacer con la instrucción de procesamiento.

Ver comentarios e instrucciones de procesamiento

Elija Mostrar comentarios o Mostrar instrucciones de procesamiento en el menú del panel Estructura.

Editar comentarios e instrucciones de procesamiento

Seleccione el comentario o la instrucción de procesamiento.
Lleve a cabo una de las siguientes acciones:
  • Haga doble clic en el comentario o la instrucción de procesamiento.

  • Elija Editar en el menú del panel Estructura.

Edite el comentario o la instrucción de procesamiento y haga clic en Aceptar.

Uso de archivos DTD para validar XML

Validar el XML en un documento significa comparar la estructura, nombres de etiqueta de elementos y atributos con las especificaciones de un archivo DTD.Para validar con un archivo DTD, primero debe cargarlo en su documento en InDesign.

Nota

Cargar un archivo DTD importa nombres de etiqueta al panel Etiquetas.Estos nombres de etiqueta importados están bloqueados; no se pueden eliminar ni cambiar de nombre excepto eliminando el archivo DTD del documento.

El elemento DOCTYPE aparece en la parte superior del panel Estructura si se ha cargado un archivo DTD en su documento.(Los DTD a veces se cargan automáticamente cuando importa un archivo XML.)Para reemplazar el archivo DTD en un documento, elimine el DTD existente y luego cargue uno nuevo.

Trabajar con archivos DTD en InDesign

A. Elemento DOCTYPE de un archivo DTD importado (panel Estructura) B. Etiqueta bloqueada del archivo DTD (panel Etiquetas) 

Cargar un archivo DTD

Cuando carga un archivo DTD, InDesign incorpora el archivo en el documento.

Lleve a cabo una de las siguientes acciones:
  • En el panel Estructura, elija Cargar DTD en el menú del panel Estructura.

  • En el panel Etiquetas, elija Cargar DTD en el menú del panel.

Seleccione un archivo DTD para importar y haga clic en Abrir.
Nota

Para ver las etiquetas definidas en el archivo DTD, abra el panel Etiquetas eligiendo Ventana > Utilidades > Etiquetas.

Ver un archivo DTD

Los archivos DTD están escritos en texto ASCII.Pueden contener instrucciones incorporadas y explicaciones que describen cómo aplicar etiquetas y ordenar elementos correctamente.En InDesign, solo puede ver un DTD que esté cargado en un documento.

Archivo DTD abierto para visualización

Lleve a cabo una de las siguientes acciones:
  • En el menú del panel Estructura, elija Ver DTD.

  • Hacer doble clic en el elemento DOCTYPE del panel Estructura.

Nota

Para imprimir un archivo DTD, copie el código de la ventana Ver DTD y péguelo en un editor de texto.

Eliminar un archivo DTD

Seleccionar Eliminar DTD en el menú del panel Estructura.

InDesign elimina la copia del archivo DTD almacenada en el documento de InDesign, no el archivo DTD original.Las etiquetas que se importaron con el archivo DTD permanecen en el panel Etiquetas pero se desbloquean.

Validar estructura XML

Cuando valida su documento, InCopy le alerta si el XML se desvía de las reglas establecidas por el archivo DTD.Sugiere formas de hacer que el XML cumpla los requisitos del archivo DTD.Puede corregir los errores uno a la vez o ver todos los errores en una ventana separada.

Panel de estructura con panel de sugerencias

A. DTD cargado B. Error o condición invalidante C. Descripción de error con sugerencia de corrección D. Número de errores E. Botón Validar F. Ver todos los errores en una ventana independiente 

panel Estructura con sección Sugerencias

A. Elemento DOCTYPE del archivo DTD asignado B. Error o condición invalidante C. Descripción del error con reparaciones recomendadas D. Número de errores E. Botón Validar F. Ver todos los errores a la vez en una ventana independiente 

Elija Ver > Estructura > Mostrar estructura.
En el panel Estructura, haga clic en el botón Validar .
Nota

Para cambiar el elemento raíz desde el cual InDesign valida, elija Opciones de DTD en el menú del panel Estructura.

Para corregir los errores mostrados en el panel Sugerencia, haga clic en una corrección sugerida para probarla o edite la estructura XML y las etiquetas directamente usando el panel Estructura y el panel Etiquetas.
Para ver otros errores, realice una de las siguientes acciones:
  • Haga clic en la flecha izquierda o flecha derecha .

  • Haga clic en el botón Ventana de error para ver todos los errores en una ventana independiente.

  • Elija Ver lista de errores en el menú del panel Estructura.

Nota

InCopy detiene la validación después de detectar 250 errores.Aparece un signo más en el cuadro Recuento de errores cuando se alcanza este límite.