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

Equipo Producción SciELO Brasil

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

www. .org Scientific Electronic Library Online

http://www.scielo.org/

¿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.


¿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?


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

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


Seleccione el archivo .xml para ser validado


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.


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

https://groups.google.com/forum/#!topic/scielo-xml/MbW_0qoTVCs


Orden de los elementos en [name]

Estructura en [element-citation]


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


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


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


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.


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.


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.


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


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


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


El programa iniciará la validación de los archivos


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


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


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

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


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


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



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.



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


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

indicada en el primer informe, con las carpetas:


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.



¡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.


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


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!

Documents

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