.. Como publicar XML JATS en OJS documentation master file, created by
   sphinx-quickstart on Wed Dec 14 10:31:10 2016.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

=============================
Cómo publicar XML JATS en OJS
=============================

Requerimientos
==============

* Versión de OJS <= **2.4.8**
* Versión PHP 5.0.0 en adelante con el módulo *libxslt* habilitado
* Plantilla XSL para generación de archivos HTML a partir de XML JATS

Instrucciones para activar el uso de plantillas XSL en OJS
==========================================================

Se necesita una cuenta de **administrador/editor** de la revista para poder realizar los ajustes necesarios que permitirán activar y configurar el uso de plantilla XSL en OJS.

Teniendo una sesión activa de **administrador/editor** de la revista en OJS, seleccionamos la opción **Gestor/a de la revista** (*Journal manager*).

.. image:: img/journalmanager.png
   :align: center

Dentro de la página de **Gestión de la revista** (*Journal Management*) seleccionamos la opción **Módulos del sistema** (*System Plugins*) ubicada en la sección **Páginas de gestión** (*Management Pages*).

.. image:: img/journalmanager_opts.png
   :align: center

En la página **Gestión de módulos** (*Plugin Management*) seleccionamos la opción **Módulos genéricos** (*Generic Plugins*).

.. image:: img/plugin_management.png
   :align: center

Finalmente en la página de **Módulos genéricos** (*Generic Plugins*) buscamos **Módulo de galerada XML** (*XML Galley Plugin*) y seleccionamos la opción **HABILITAR** (*ENABLE*).

.. image:: img/enable_xml_gallery.png
   :align: center

Configuración del módulo de plantillas XSL en OJS
=================================================

Con el **Módulo de galerada XML** (*XML Galley Plugin*) habilitado procedemos a la configuración del mismo, seleccionando la opción **CONFIGURACIÓN** (*SETTINGS*).

.. image:: img/xml_gallery_config.png
   :align: center

Dentro de la configuración inicial del módulo observamos que ya cuenta con una plantilla predeterminada para la visualización de archivos XML trabajados con la DTD **NLM Journal Publishing** que es previa al estándar JATS utilizado por SciELO.

.. image:: img/xml_gallery_default.png
   :align: center

Con la plantilla predeterminada podremos visualizar los documentos XML JATS, pero es recomendable tener una plantilla personalizada. Para agregar una plantilla personalizada hay que seleccionar la opción **Hoja de estilo personalizada**, seleccionar nuestro archivo XSL correspondiente a nuestra plantilla con el botón **Examinar**, dar clic en el botón **Cargar** y por último **Guardar** los cambios.

.. image:: img/xml_gallery_custom.png
   :align: center

Carga de archivos XML para publicación en OJS
=============================================

Una vez habilitado y configurado el **Módulo de galerada XML** (*XML Galley Plugin*) podremos realizar la publicación de archivos XML JATS dentro de nuestra instalación OJS.

Teniendo una sesión activa de **administrador/editor** de la revista en OJS, seleccionamos la opción **Editor/a** (*Editor*).

.. image:: img/home_editor.png
   :align: center

Dentro de la **Página principal del editor/a** (*Editor Home*) seleccionamos la opción **Archivos** (*Archives*).

.. image:: img/editor_select_archives.png
   :align: center

En la página de **Archivos** (*Archives*), dar clic en el título del artículo del cual queremos publicar su versión XML JATS.

.. image:: img/archives_select_article.png
   :align: center

En la sección **Maquetación** (*Layout*) de nuestro artículo, seleccionamos la opción **Galerada** (*Galley*), buscamos el archivo XML JATS para la publicación y procedemos con la carga del mismo.

.. image:: img/xml_gallery.png
   :align: center

Dentro de la página **Galerada** (*Galley*) de nuestro artículo tenemos la posibilidad de cargar las imágenes contenidas en el documento XML JATS. Para ello seleccionamos cada una de las imágenes con el botón **Examinar...** y procedemos con la carga.

.. image:: img/xml_gallery_imgs.png
   :align: center

Al finalizar la carga de imágenes guardamos los cambios realizados.

.. image:: img/xml_gallery_save.png
   :align: center

Como resultado tendremos disponible la versión XML de nuestros artículos.

.. image:: img/xml_published.png
   :align: center


Enlaces de interés
==================

* Plantilla XML JATS https://github.com/ncbi/JATSPreviewStylesheets
* Introducción a las plantillas XSL http://www.w3schools.com/xml/xsl_intro.asp
* Etiquetas XML JATS 1.0 http://jats.nlm.nih.gov/publishing/tag-library/1.0/
* SciELO Publishing Schema http://docs.scielo.org/projects/scielo-publishing-schema/pt_BR/1.5-branch/