Inicio rápido

Para realizar una prueba rápida de ~!gurí_ puede utilizar el ejemplo que se brinda con el paquete, el cual contiene los archivos necesarios para crear el ’Volumen 10 - Número 1” de una revista ficticia.

Dado que ~!guri_ es, además de un paquete de R, un flujo de trabajo que interaccina con su estructura de directorios, es muy recomendable que ejecute este ejemplo desde un proyecto nuevo (información sobre Proyectos de R). La carpeta que utilice para su proyecto será la que alojará las diferentes revistas que úede gestionar. Una vez generado su proyecto, debe instalar el paquete {gurí} y cargarlo para que esté disponible en su ambiente de trabajo.

El paquete {gurí} no está aún disponible en CRAN, por lo cual debe realizar la instalación de forma directa desde Github. Para ello puede utilizar el paquete {pak} que permite instalar paquetes desde Github de forma simple (alternativamente puede utilizar el paqete {remotes}).

if(!require("pak")) install.packages("pak")

pak::pkg_install("estedeahora/guri")

Si es la primera vez que usa ~!gurí_, luego de que haya instalado el paquete {gurí} y que haya cargado el mismo en su ambiente de trabajo, deberá instalar las dependencias necesarias, a saber: Pandoc, la distribución tinytex de LaTeX y las librerías de LaTeX necesarias para que ~!gurí pueda funcionar correctamente. Dependiendo de si ya tiene instalada estos programas esto puede tardar más o menos tiempo y, asegúrese antes de comenzar contar con una conexión estable a internet. Para instalar estas dependencias ejecute en la consola de R lo siguiente:

library(guri)

guri_install(pandoc = T, tinytex = T)

Luego de esto ya tiene configurado su espacio de trabajo y está todo listo para generar nuestra revista de ejemplo. Para ello ejecute el siguiente comando;

guri_make_journal(example = TRUE, repository = TRUE)

Esto mostrará en la consola el progreso de la creación de los archivos de su revista de ejemplo (no es necesario que se preocupe por ahora por los detalles en esta ejecución de prueba). Como resultado, se generará una carpeta con el nombre ‘example’ en su directorio de trabajo, el cual contendrá una carpeta con archivos de configuración (’_config’), otra con los archivos que le servirán como modelo en el flujo de trabajo editorial de una revista (‘_default-files’) y una carpeta con un número ficticio de esta revista de ejemplo (‘vol10num1’). Dentro de esta última carpeta encontrará un conjunto de carpetas correspondientes a los diferentes artículos de este número (cada una comienza con el prefijo ‘art’ seguida por tres números y un nombre de referencia). Le recomendamos que explore sin modificar estos archivos para familiarizarse con los archivos utilizados durante el flujo de trabajo de ~!guri_.

Por último, para obtener los archivos finales (‘galeradas’) de este número de ejemplo debe ejecutar el siguiente código:

guri_outputs(art_id = 'all', issue = 'vol10num1',
             journal = 'example', doi_batch = T)

Como resultado de este proceso, dentro de la carpeta de cada artículo (./example/vol10num1/art*_nombre) encontrará un directorio /_output/ con los archivos finales resultantes. También encontrará una carpeta /_temp/ con archivos auxiliares, utilizados en el proceso de construcción de los archivos finales, y otra carpeta /_log/ con archivos que contienen información del proceso de conversión. Por último, encontrará que en dentro de la carpeta del número (./example/vol10num1/) se creo una carpeta doi_register que contiene archivos que puede utilizar para el deposito de DOI en Crossref.

Para una descripción más detallada de los pasos realizados en este ejemplo, le recomendamos que lea la documentación sobre configuración y uso de ~!gurí_.