Equipo Producción SciELO Brasil

Control de calidad de los números antes delenvío para procesamiento

www. .orgScientific 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.

Presupuestos

• Realizar el control de calidad centrado en el producto final de la marcación de los archivos

• Revisión de la marcación de los archivos XML a través de validadores y visualmente

• Identificar posibles errores y hacer los ajustes cuando necesario

Herramientas de soporteStyle Checker

• Herramienta en la nube que presentainformes de conformidad de uno XML enrelación a especificación de SciELO PS.

Herramientas de soporteStyle Checker

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

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

PS?• ¿Qué es un error de DTD?• ¿Cómo interpretar los resultados y corregir los

archivos?

Herramientas de soporteStyle Checker

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

Herramientas de soporteStyle Checker

Seleccione el archivo .xml para ser validado

Herramientas de soporteStyle Checker

Haga un clic en “validar”

Resultado esperado para todos los archivos XML

Herramientas de soporteStyle Checker

• Representación de errores

SciELO Style ChekerErrores 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.

SciELO Style ChekerErrores de estiloEn esto caso observase que hay una nota de pie do tipo “financial-disclosure” que presupone la existencia de datos de financiamiento. Si embargo estos datos no están marcados en el XML

Ejemplo 1: Marcación incompleta de datos de financiamiento

Estructura necessária en elXML para esto caso

Ejemplo 2: Presencia indebida de atributo de idioma en <article-title>

SciELO Style ChekerErrores de estilo

Inclusión del atributo @xml:lang en <article-title>que no permite tal calificador

SciELO Style Cheker

Errores de DTD: Son relacionados a la estructura del XML cuando validados contra la JATs v1.0.

Estructuras no permitidas de acuerdo con la DTD declarada

SciELO Style ChekerErrores de DTD:

Ejemplo 1: Presencia indebida del elemento <named-content>

No es permitido <named-content> dentro de <institution>

SciELO Style ChekerErrores de DTD:

Ejemplo 2: Estructura incoherente del elemento <name>

Ejemplo 3: Estructura en [element-citation]

SciELO Style ChekerErrores de DTD:

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

Más formas de evaluar los errores presentados pueden ser consultados en el grupo de discusión acerca del XML.

Herramientas de soporteStyle Checker – Errores comunes DTD

¡Vamos a la practica!

En la carpeta EJERCICIO_1_SCIELO_STYLE_CHECKER hay archivos con errores de estilo o errores de DTD y archivos con ambos.Utilice el validador SciELO Stylecker y localice errores en los archivos XML y haga las correcciones necesarias a cada ocurrencia.Si necesario, utilice la documentación SciELOSPS o JATS para su resolución.

Ejercicio 1

Herramientas de soportePackage Maker

Herramienta integrada al programa de marcación que genera y valida paquetes para PMC y SciELO;

También puede ser usada localmente sin la necesidad del uso de programa de marcacíon.

Herramientas de soportePackage 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 soportePackage 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.

Package Maker

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

Utilizando el programa

Package Maker

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

Utilizando el programa

Package Maker

• En la secuencia, haga un clic en “XML PackageMaker”

Utilizando el programa

Package Maker

• El programa iniciará la validación de los archivosUtilizando el programa

Package Maker

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

Comprendiendo a los informes

Package Maker

Las carpetas, archivos generados y su dirección

Comprendiendo a los informes

Package Maker

El informe resumido de los errores encontrados, la versión del programa usada y la fecha de validación

Comprendiendo a los informes

Package Maker

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

Comprendiendo a los informes

Package Maker

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

Compreendiendo a los informes

Package MakerComprendiendo a los informes

Package Maker

Herramientas de soportePackage 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.

Package Maker

Comprendiendo a los informes

Package Maker

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

Comprendiendo a los informes

Package Maker

Comprendiendo a los informes

• Errores en la marcación de referencias

Package Maker

Carpetas generadas después de la validación

Package Maker

Carpeta “Errors”: Tendrá un contenido específico del proceso de validación.Los archivos .err presentan el resultado por archivo del proceso de validación y el archivo .html, las pantallas de los informes.

Herramientas de soportePackage Maker

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

Carpeta “PMC_SciELO”: Tendrá archivos adecuados para el estilo

PMC.

Package Maker

Carpeta scielo_package: Para donde son exportados los archivos al final de la validación de XPM

Herramientas de soportePackage Maker

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

Herramientas de soporte

¡ VAMOS A LA PRACTICA!

Ejercicio 2Itilizando el XPM localice la carpeta EJERCICIO_2_XPM.Seguido haga la validación de losarchivos. Revise os informes y haga los ajustes cuando necessário.

Lembrate! Puede concultar la documetaciónSciELO SPS