En el ámbito del desarrollo del Programa SciELO con base en sus líneas prioritarias de acción en pro de la profesionalización e internacionalización de las revistas científicas que indexa, la adopción de la marcación de los textos completos en XML representa un avance crítico que todas las colecciones y revistas deberán adoptar en el futuro próximo. Tratase de un cambio significativo que afecta los sistemas tradicionales de edición de revistas científicas. En el Modelo SciELO de publicación el archivo con el texto completo en XML pasa a ser considerado como fuente primaria para preservación digital y generación de los diferentes formatos de presentación como el HTML, el PDF, el ePUB, etc. La estructura del archivo es descrita en el SciELO Publishing Schema (PS) que es basado en la norma NISO Journal Article Tag Suite (JATS). La gestión y operación de servicios de publicación con textos estructurados en el formato XML según el SciELO PS, permite la identificación detallada y precisa de los elementos bibliográficos de los artículos, contribuí para mejorar la calidad bibliográfica de los textos, su indización e interoperabilidad en la Web, la preservación digital y la posibilidad de publicación en diferentes tipos de formatos y presentación en diversos dispositivos. En ese sentido, el Taller de Actualización la Metodología SciELO tiene como objetivo intercambiar informaciones y experiencias acerca del flujo de publicación basado en el SciELO PS de manera a facilitar su adopción. El taller comprende aspectos teóricos y prácticos acerca de la metodología SciELO y de los programas utilizados para generación de los archivos en XML de acuerdo con el SciELO PS-v1.3.

1. Equipo Producción SciELO Brasil
Control de calidad de los números antes del
envío para procesamiento
www. .org
Scientific Electronic Library Online

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

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

5. Herramientas de soporte
Style 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?

6. Herramientas de soporte
Style Checker
 Entre en http://manager.scielo.org/tools/validators/stylechecker/

7. Herramientas de soporte
Style Checker
 Seleccione el archivo .xml para ser validado

8. Herramientas de soporte
Style Checker
 Haga un clic en “validar”
Resultado esperado
para todos los archivos
XML

9. Herramientas de soporte
Style Checker
• Representación de errores

10. SciELO Style Cheker
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.

11. SciELO Style Cheker
Errores de estilo
En 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

12. Ejemplo 1: Marcación incompleta de datos de
financiamiento
Estructura necessária en el
XML para esto caso

13. Ejemplo 2: Presencia indebida de atributo de
idioma en <article-title>
SciELO Style Cheker
Errores de estilo
Inclusión del atributo
@xml:lang en <article-title>
que no permite tal
calificador

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

15. SciELO Style Cheker
Errores de DTD:
Ejemplo 1: Presencia indebida del elemento <named-content>
No es permitido <named-
content> dentro de <institution>

16. SciELO Style Cheker
Errores de DTD:
Ejemplo 2: Estructura incoherente del elemento <name>

17. Ejemplo 3: Estructura en [element-citation]
SciELO Style Cheker
Errores de DTD:
En este caso, el año
“2000” no fue marcado

18.  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

19. ¡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 SciELO
SPS o JATS para su resolución.
Ejercicio 1

20. Herramientas de soporte
Package 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.

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

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

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

24. Package Maker
 Será abierta una pantalla para selección de la
carpeta para validación:
Utilizando el programa

25. Package Maker
• En la secuencia, haga un clic en “XML Package
Maker”
Utilizando el programa

26. Package Maker
• El programa iniciará la validación de los archivos
Utilizando el programa

27. Package Maker
 Al finalizar el proceso, abrirá automáticamente el
informe en su browser.
Comprendiendo a los informes

28. Package Maker
 Las carpetas, archivos generados y su dirección
Comprendiendo a los informes

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

30. Package Maker
 El informe de metadatos del número: licencia,
ISSN, título NLM etc.
Comprendiendo a los informes

31. Package Maker
 El informe de validación de los XML contra la
DTD, estilo SciELO PS y contenido
Compreendiendo a los informes

32. Package Maker
Comprendiendo a los informes

33. Package Maker

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

35. Package Maker
Comprendiendo a los informes

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

38. Package Maker
Comprendiendo a los informes
• Errores en la marcación de referencias

39. Package Maker
 Carpetas generadas después de la validación

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

41. Herramientas de soporte
Package 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.

42. Package Maker
 Carpeta scielo_package:
Para donde son exportados los archivos al final
de la validación de XPM

43. Herramientas de soporte
Package Maker
 Carpeta scielo_package_zips:
Contiene los archivos compactados y
nombrados de acuerdo con la especificación de
SciELO PS

44. Herramientas de soporte
¡ VAMOS A LA PRACTICA!

45. Ejercicio 2
Itilizando el XPM localice la carpeta
EJERCICIO_2_XPM.
Seguido haga la validación de los
archivos.
Revise os informes y haga los ajustes
cuando necessário.
Lembrate!
Puede concultar la documetación
SciELO SPS