Marcación, generación de XML y control de calidad
Transcript of Marcación, generación de XML y control de calidad
![Page 1: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/1.jpg)
Equipo Producción SciELO Brasil
Marcación, generación de XML y control de calidad
www. .org Scientific Electronic Library Online
![Page 2: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/2.jpg)
¿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.
![Page 3: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/3.jpg)
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.
![Page 4: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/4.jpg)
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?
![Page 5: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/5.jpg)
Herramientas de soporte Style Checker
Entre en http://manager.scielo.org/tools/validators/stylechecker/
![Page 6: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/6.jpg)
Herramientas de soporte Style Checker
Seleccione el archivo .xml para ser validado
![Page 7: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/7.jpg)
Herramientas de soporte Style Checker
Haga un clic en “validar”
![Page 8: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/8.jpg)
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.
![Page 9: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/9.jpg)
Herramientas de soporte Style Checker
Si hay alguno error, se presentará como sigue:
![Page 10: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/10.jpg)
``?``: 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
![Page 11: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/11.jpg)
Herramientas de soporte Style Checker – Errores comunes DTD
Orden de los elementos en [name]
![Page 12: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/12.jpg)
Estructura en [element-citation]
Herramientas de soporte Style Checker – Errores comunes DTD
![Page 13: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/13.jpg)
En este caso, el año “2014” no fue marcado
Herramientas de soporte Style Checker – Errores comunes DTD
![Page 14: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/14.jpg)
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.
![Page 15: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/15.jpg)
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
![Page 16: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/16.jpg)
Inclusión del atributo @xml:lang en elementos que no permiten tal calificador
Herramientas de soporte Style Checker – Errores comunes de Estilo
![Page 17: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/17.jpg)
Herramientas de soporte Style Checker – Errores comunes de Estilo
![Page 18: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/18.jpg)
Atributo de @country en el elemento [country] no definido
Herramientas de soporte Style Checker – Errores comunes de Estilo
![Page 19: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/19.jpg)
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
![Page 20: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/20.jpg)
Herramientas de soporte Style Checker – Erros comunes de Estilo
![Page 21: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/21.jpg)
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.
![Page 22: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/22.jpg)
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.
![Page 23: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/23.jpg)
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.
![Page 24: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/24.jpg)
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
![Page 25: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/25.jpg)
Herramientas de soporte Package Maker
Será abierta una pantalla para selección de la carpeta para validación:
![Page 26: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/26.jpg)
Herramientas de soporte Package Maker
En la secuencia, haga un clic en “XML Package Maker”
![Page 27: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/27.jpg)
Herramientas de soporte Package Maker
El programa iniciará la validación de los archivos
![Page 28: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/28.jpg)
Herramientas de soporte Package Maker
Al finalizar el proceso, abrirá automáticamente el informe en su browser.
![Page 29: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/29.jpg)
Herramientas de soporte Package Maker
En las pantallas se verifica: Las carpetas, archivos generados y su dirección
![Page 30: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/30.jpg)
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
![Page 31: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/31.jpg)
Herramientas de soporte Package Maker
El informe de metadatos del número: licencia, ISSN, título NLM etc.
![Page 32: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/32.jpg)
Herramientas de soporte Package Maker
El informe de validación de los XML contra la DTD, estilo SciELO PS y contenido
![Page 33: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/33.jpg)
Herramientas de soporte Package Maker
![Page 34: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/34.jpg)
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.
![Page 35: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/35.jpg)
Herramientas de soporte Package Maker
![Page 36: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/36.jpg)
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
![Page 37: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/37.jpg)
Herramientas de soporte Package Maker
Como resultado se tiene: Una carpeta generada en la dirección
indicada en el primer informe, con las carpetas:
![Page 38: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/38.jpg)
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.
![Page 39: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/39.jpg)
Herramientas de soporte Package Maker
![Page 40: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/40.jpg)
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.
![Page 41: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/41.jpg)
Herramientas de soporte Package Maker
Carpeta scielo_package: con los archivos adecuados para el estilo SciELO PS.
![Page 42: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/42.jpg)
Herramientas de soporte Package Maker
Carpeta scielo_package_zips: con los archivos compactados y nombrados de acuerdo con la especificación de SciELO PS
![Page 43: Marcación, generación de XML y control de calidad](https://reader031.fdocumento.com/reader031/viewer/2022021421/586689131a28abb4408b6b03/html5/thumbnails/43.jpg)
Herramientas de soporte
¡ VAMOS A LA PRACTICA!