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

Transcripción

1 Scientific Electronic Library Online Marcación, generación de XML y control de calidad Equipo Producción SciELO Brasil

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

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

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

5 Style Checker Entre en

6 Style Checker Seleccione el archivo.xml para ser validado

7 Style Checker Haga un clic en validar

8 Style Checker - DTD Errores de DTD: relacionadas a la estructura del XML cuando validado contra la JATs v1.0. 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.

9 Style Checker Si hay alguno error, se presentará como sigue:

10 Style Checker Errores comunes DTD ``?``: 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.

11 Style Checker Errores comunes DTD Orden de los elementos en [name]

12 Style Checker Errores comunes DTD Estructura en [element-citation]

13 Style Checker Errores comunes DTD En este caso, el año 2014 no fue marcado

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

15 Style Checker - Estilo 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.

16 Style Checker Errores comunes de Estilo Inclusión del en elementos que no permiten tal calificador

17 Style Checker Errores comunes de Estilo

18 Style Checker Errores comunes de Estilo Atributo en el elemento [country] no definido

19 Style Checker Cuando ignorar el error Si debe ignorar un error cuando no hay el dato en el artículo marcado: El validador verifica una nota de pie del y apunta la falta de marcación del elemento [fn-group] del tipo [funding-statement] en [front].

20 Style Checker Erros comunes de Estilo

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

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

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

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

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

26 En la secuencia, haga un clic en XML Package Maker

27 El programa iniciará la validación de los archivos

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

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

30 En las pantallas se verifica: El informe resumido de los errores encontrados, la versión del programa usada y la fecha de validación

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

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

33

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

35

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

37 Como resultado se tiene: Una carpeta generada en la dirección indicada en el primer informe, con las carpetas:

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

39

40 Carpeta PMC_SciELO: con los archivos adecuados para el estilo PMC. 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.

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

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

43 VAMOS A LA PRACTICA!