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