Equipo Producción SciELO Brasil

Marcación, generación de XML y control de calidad

www. .org Scientific Electronic Library Online

¿Qué hacer después de la marcación?

Finalizada la marcación de todos los archivos de un número, se inicia el proceso de control de calidad de los archivos en XML. Es un proceso distinto del usado en el flujo HTML, una vez que se usa el archivo fuente (XML) para las validaciones y verificación del contenido y no solo el sitio local.

Herramientas de soporte Style Checker

Herramienta en la nube que presenta informes de conformidad de uno XML en relación a especificación de SciELO PS.

Herramientas de soporte Style Checker

¿Cómo validar archivos .xml a través del Style Checker?

¿Cómo verificar/encontrar errores? ¿Qué es un error de DTD? ¿Qué es um error de especificación SciELO

PS? ¿Cómo interpretar los resultados y corregir los

archivos?

Herramientas de soporte Style Checker

Entre en http://manager.scielo.org/tools/validators/stylechecker/

Herramientas de soporte Style Checker

Seleccione el archivo .xml para ser validado

Herramientas de soporte Style Checker

Haga un clic en “validar”

Herramientas de soporte Style Checker - DTD

Validación contra DTD: Inclusión de elementos no permitidos en otros

elementos, como <named-content> del tipo <country> insertado en el elemento <institution>. Es decir que el elemento <country> no está declarado como hijo del elemento <institution> y, por esa razón, no puede estar insertado en este elemento.

Errores de DTD: relacionadas a la estructura del XML cuando validado contra la JATs v1.0.

Herramientas de soporte Style Checker

Si hay alguno error, se presentará como sigue:

``?``: el símbolo, el grupo de símbolos entre paréntesis,

inmediatamente anterior es opcional, i.e., ocurre Zero o una vez.

``*``: el símbolo, el grupo de símbolos entre paréntesis, inmediatamente

anterior puede ocurrir Zero o más veces.

``+``: el símbolo, o grupo de símbolos entre paréntesis, inmediatamente

anterior puede ocurrir una o más veces.

``()``: representa un grupo.

``|``: representa o conectivo lógico "O" exclusivo.

Más formas de evaluar los errores presentados pueden ser consultados

en el grupo de discusión acerca del XML.

Herramientas de soporte Style Checker – Errores comunes DTD

Herramientas de soporte Style Checker – Errores comunes DTD

Orden de los elementos en [name]

Estructura en [element-citation]

Herramientas de soporte Style Checker – Errores comunes DTD

En este caso, el año “2014” no fue marcado

Herramientas de soporte Style Checker – Errores comunes DTD

Herramientas de soporte Style Checker - Estilo

Errores de Estilo: relacionados a la estructura del XML cuando validado contra el estilo determinado en SciELO PS, o sea, adecuada estructuración de un elemento o atributo de acuerdo con la exigencia del SciELO PS vigente.

Validación contra Estilo SciELO PS: Presentación del elemento <funding-statement>

dentro del elemento <funding-group> cuando los datos de financiamiento son presentados en nota o identificación detallada de las afiliaciones. Es decir que para SciELO es importante que estos elementos sean identificados de la manera descripta en la documentación para que resultados sean generados a partir de eses elementos.

Herramientas de soporte Style Checker - Estilo

Inclusión del atributo @xml:lang en elementos que no permiten tal calificador

Herramientas de soporte Style Checker – Errores comunes de Estilo

Herramientas de soporte Style Checker – Errores comunes de Estilo

Atributo de @country en el elemento [country] no definido

Herramientas de soporte Style Checker – Errores comunes de Estilo

Si debe ignorar un error cuando no hay el dato en el artículo marcado: El validador verifica una nota de pie del

tipo @finantial-disclosure y apunta la falta de marcación del elemento [fn-group] del tipo [funding-statement] en [front].

Herramientas de soporte Style Checker – Cuando ignorar el error

Herramientas de soporte Style Checker – Erros comunes de Estilo

Herramientas de soporte Package Maker

Herramienta integrada al programa de marcaje que genera y valida paquetes para PMC y SciELO;

También puede ser usada localmente sin la necesidad del uso de programa de marcaje.

Herramientas de soporte Package Maker

Genera tres tipo de informes: Errores fatales: que impiden la publicación

del XML; Errores: que deben ser analizados y

corregidos, más no impiden su publicación; Alertas: indican que puede haber algún

problema en la marcación del elemento o atributo, más no es tan grave cuanto a los tipos anteriores.

Herramientas de soporte Package Maker

Sus validaciones engloban: DTD y estilo SciELO/PMC: apunta errores

de estructura de acuerdo con las versiones 1.3 y 1.4 del SciELO PS;

Contenido: donde se verifica la ausencia de datos obligatorios y/o inclusión de dato equivocado dependiendo del tipo de elemento marcado.

Herramientas de soporte Package Maker

A partir del programa de marcaje, acceda a la carpeta ?bin/xml y haga un clic en xml_package_maker.py

Herramientas de soporte Package Maker

Será abierta una pantalla para selección de la carpeta para validación:

Herramientas de soporte Package Maker

En la secuencia, haga un clic en “XML Package Maker”

Herramientas de soporte Package Maker

El programa iniciará la validación de los archivos

Herramientas de soporte Package Maker

Al finalizar el proceso, abrirá automáticamente el informe en su browser.

Herramientas de soporte Package Maker

En las pantallas se verifica: Las carpetas, archivos generados y su dirección

Herramientas de soporte Package Maker

En las pantallas se verifica: El informe resumido de los errores

encontrados, la versión del programa usada y la fecha de validación

Herramientas de soporte Package Maker

El informe de metadatos del número: licencia, ISSN, título NLM etc.

Herramientas de soporte Package Maker

El informe de validación de los XML contra la DTD, estilo SciELO PS y contenido

Herramientas de soporte Package Maker

Herramientas de soporte Package Maker

El informe general del paquete, dónde es posible rápidamente verificar si los metadatos marcados están correctos, es decir: Nombre de archivo; Secciones; Tipo de artículo; Autores; Resúmenes; Palabras-clave; Idioma del artículo principal; Afiliaciones; Tipos de referencias.

Herramientas de soporte Package Maker

Herramientas de soporte Package Maker

El informe fuentes, dónde es posible verificar si una misma fuente fue marcada con tipos diferentes de referencia bibliográfica

Herramientas de soporte Package Maker

Como resultado se tiene: Una carpeta generada en la dirección

indicada en el primer informe, con las carpetas:

Herramientas de soporte Package Maker

Cada carpeta tendrá un contenido específico. Errors: archivos del proceso de validación,

donde los archivos .err presentan el resultado por archivo del proceso de validación y el archivo .html, las pantallas de los informes.

Herramientas de soporte Package Maker

Herramientas de soporte Package Maker

¡OJO! La carpeta pmc_package sólo tendrá archivos si el título NLM esté llenado en la title. En nuestro ejemplo, como no hay indicación del título, la carpeta se generó vacía.

Carpeta PMC_SciELO: con los archivos adecuados para el estilo PMC.

Herramientas de soporte Package Maker

Carpeta scielo_package: con los archivos adecuados para el estilo SciELO PS.

Herramientas de soporte Package Maker

Carpeta scielo_package_zips: con los archivos compactados y nombrados de acuerdo con la especificación de SciELO PS

Herramientas de soporte

¡ VAMOS A LA PRACTICA!