-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathrecogito.html
More file actions
264 lines (242 loc) · 17.9 KB
/
recogito.html
File metadata and controls
264 lines (242 loc) · 17.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Recogito</title>
<style type="text/css">
/* Global styles */
body {
font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
line-height: 1.42857143;
color: #333;
background-color: #fff;
margin: 2cm 1cm; /* Simplified margin shorthand */
}
/* Code styles */
code {
font-family: monospace, monospace;
font-size: 1em;
padding: 2px 4px;
font-size: 90%;
color: #c7254e;
background-color: #f9f2f4;
border-radius: 4px;
}
/* Preformatted text styles */
pre {
display: block;
padding: 9.5px;
margin: 0 0 10px;
font-size: 13px;
line-height: 1.42857143;
color: #333;
word-break: break-all;
word-wrap: break-word;
background-color: #f5f5f5;
border: 1px solid #ccc;
border-radius: 4px;
}
pre code {
padding: 0;
font-size: inherit;
color: inherit;
white-space: pre-wrap;
background-color: transparent;
border-radius: 0;
}
/* Scrollable preformatted text styles */
.pre-scrollable {
max-height: 340px;
overflow-y: scroll;
}
/* Container styles */
.main-container {
max-width: 940px;
margin: 0 auto; /* Simplified margin shorthand */
}
.container-fluid {
padding: 0 15px;
}
/* Image styles */
img {
max-width: 100%;
height: auto;
}
</style>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Romina De León</title>
<!-- CSS: Inside head tag -->
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.3/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-rbsA2VBKQhggwzxH7pPCaAqO46MgnOM80zW1RWuH61DGLwZJEdK2Kadq2F9CUG65" crossorigin="anonymous">
<!-- Devicon: Programming languages icons -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/devicons/devicon@v2.15.1/devicon.min.css">
<style>
I {
font-size: 3em;
}
</style>
<!-- fonticon icons -->
<link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css" rel="stylesheet">
<style>
.social-icon {
font-size: 24px; /* Tamaño de los iconos */
}
.social-name {
font-size: 16px; /* Tamaño de los nombres */
}
.footnote {
margin: 0; /* elimina el margen superior e inferior */
padding: 0; /* elimina el relleno superior e inferior */
}
.footnote {
font-size: 1em;
font-family: inherit;
text-decoration: none;
margin: 0;
padding: 0;
}
</style>
</head>
<body>
<nav class="navbar navbar-dark navbar-expand-lg bg-dark ">
<div class="container-fluid">
<div class="mx-4">
<a class="navbar-brand" href="materiales.html">Materiales</a>
</div>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse"
data-bs-target="#navbarTogglerDemo02" aria-controls="navbarTogglerDemo02" aria-expanded="false"
aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse navbar-collapse" id="navbarTogglerDemo02">
<ul class="navbar-nav me-auto mb-2 mb-lg-0">
<li class="nav-item">
<a class="nav-link" href="index.html">Inicio</a>
</li>
<li class="nav-item">
<a class="nav-link" href="descargas.html">Descargas</a>
</li>
</ul>
</div>
</div>
</nav>
<div class="container-fluid main-container">
<h1 class="title toc-ignore">Recogito una plataforma de anotación colaborativa</h1>
<h4 class="author">Romina De León</h4>
<h5><a href="mailto:romideleon@gmail.com" class="email">romideleon@gmail.com</a></h5>
</div>
<div class="container-fluid main-container">
<nav id="index">
<h2>Índice</h2>
<ul>
<li><a href="#item1">¿Qué es Recogito?</a></li>
<li><a href="#item2">Primeros pasos en Recogito</a></li>
<li><a href="#item3">Ejercitación</a></li>
<!-- más títulos h1 -->
</ul>
</nav></div>
<div class="container-fluid main-container">
<div id="item1" class="section level3">
<h3>¿Qué es Recogito?</h3>
<img src="https://recogito.pelagios.org/assets/images/381082022176d7b597c95a435aef322e-logo-recogito.png">
<p><a href="https://recogito.pelagios.org/" target="_blank">Recogito</a> es una plataforma digital de anotación colaborativa de diversos tipos de documentos. Es alojada y mantenida por <a href="https://pelagios.org/" target="_blank">Pelagios Network</a>, una iniciativa de Humanidades Digitales que busca fomentar recursos en línea que puedan documentar el pasado. Esta comunidad ofrece herramientas y recursos online que, por un lado, no necesitan conocimientos de programación, y por otro, brinda un trabajo en la nube, colaborativo y con múltiples formatos. Es por ello que la curva de aprendizaje de Recogito es mínima, pues resulta sencillo utilizarlo de forma autónoma.
<p>Esta tecnología ha sido desarrollada en código abierto<a href="#foot1">[1]</a>, por ello permite descargar una versión local desde <a href="https://github.com/pelagios/recogito2" target="_blank">GitHub</a>, e incluso se puede añadir un diccionario geográfico según las necesidades del proyecto.</p>
<p>Recogito tiene como objetivo principal facilitar la creación de anotaciones geográficas, la vinculación de textos con ubicaciones específicas y la creación de redes de conocimiento a partir de documentos históricos. También, ofrece un espacio personal de trabajo donde se puede cargar, recopilar y organizar materiales fuentes, textos, imágenes y datos tabulares, y colaborar en anotaciones e interpretaciones.</p>
<img src="assets/Recogito.png" title="Interfaz de Recogito">
Pantalla de acceso</p>
<p>Los primeros pasos para comenzar a trabajar son ingresar a la página web, registrar una cuenta, desde <code>Register/Registrarse for/en Recogito</code>, sólo será necesario correo electrónico y nombre de usuario. Este sitio está configurado en inglés, pero se encuentra traducido al español, alemán e italiano, entre otros. Además, es compatible con la mayoría de los navegadores. Luego del registro ya es posible <strong>comenzar a anotar</strong>.</p>
</div>
<div id="item2" class="section level3">
<h3>Primeros pasos en Recogito</h3>
<p>Una vez que tenemos una cuenta en la plataforma, podremos subir documentos o anotar en documentos que nos hayan compartido.</p>
<br/>
<img src="assets\recogito-desktop.png" title="Escritorio de usuario en Recogito">Escritorio de usuarios en Recogito
</p>
<ul>
<li><h4>Cómo subir documentos</h4>
Se pueden subir diversos tipos de documentos digitales (incluidos formatos de imagen):
<ul>
<li>Permite la creación de carpetas para una mejor organización de los archivos.</li>
<li>Documentos de texto, en formato <code>*.txt</code>.<pre>Si el documento a anotar se encuentra en otro formato de texto (por ejemplo, un .doc de Word o de otro procesador de texto), primero será necesario transformarlo al formato UTF-8 Unicode (con cualquier editor de texto, por medio de la opción “guardar como”). Luego exportar el archivo a <strong>*.txt</strong>, comprobando previamente que el formato de codificación sea UTF-8.</pre> Pueden subirse múltiples textos al mismo tiempo, sin embargo, estos se agruparán en un nuevo documento de varios archivos.</li>
<blockquote>Aclaración: Recogito no es un editor de texto, por lo cual no podrá realizar cambios en el texto una vez que se haya cargado.</blockquote>
<li>Documentos en formato <strong>TEI-XML</strong>, actualmente Recogito permite la importación de documentos con este formato. Estos archivos poseen un marcado con etiquetas para codificar estructuras textuales.</li>
<li>Relacionado a los documentos anteriores, se encuentra la importación de TEI desde la base de datos de <a href="http://cts.informatik.uni-leipzig.de/datasets.html" target="_blank">CTS (Canonical Text Service)</a> se ingresa a diversos repositorios que ofrecen dicho tipo de archivos.</li>
<li>Datos tabulares, en formato de <em>valores separados por comas</em> (CSV).</li>
<li>Imágenes en formatos <strong>.jpg</strong>, <strong>.tif</strong>, <strong>.png</strong>. Estas se pueden ampliar o reducir, pero, al igual que con los textos, no pueden editarse ni mejorar la calidad del archivo de origen. Incluso pueden cargarse varias imágenes juntas,pero no deben exceder el espacio de almacenamiento personal.</li>
<li>Importar imágenes desde <a href="https://iiif.io/" target="_blank">IIIF</a> (International Image Interoperability Framework), pegando o arrastrando la URL del manifiesto IIIF. Este tipo de importaciones no afecta el espacio de almacenamiento.</li>
<li>Importar textos codificados en XML-TEI desde el catálogo <a href="https://rise.mpiwg-berlin.mpg.de/" target="_blank">RISE</a> (Research Infrastructure for the Study of Eurasia), que ofrece textos antiguos del Mediterráneo oriental.</li>
</ul>
<p><img src="assets\recogito-documents.png">Sección de carga de documentos y creación de carpeta</p>
<li><h4>Agregar metadatos</h4>
Luego de cargar un documento por primera vez, es recomendable completar la mayor cantidad de metadatos posibles. Información que corresponde a autor/es, título, fecha del texto, procedencia del formato digital, idioma, etc. Además, se deberá indicar la licencia, puesto que los documentos que se cargan, en forma predeterminada, serán visibles únicamente para quien los sube, si se desea compartirlos con otras personas, deberán completarse los permisos adecuados. Sólo se podrá compartir un documento si posee los derechos de autor o si está bajo una <a href="https://creativecommons.org/share-your-work/cclicenses/" target="_blank">Licencia Creative Commons</a>.</li>
<p><img src="assets/recogito-metadatos.png">Metadatos en un documento</p>
<li><h4>Comenzar a anotar</h4>
<p>Crear anotaciones en Recogito es simple y divertido, sólo se debe resaltar la palabra o las palabras en el texto que se desea anotar. Se abrirá una pequeña ventana emergente de anotación, se deberá asignar una categoría a su anotación: lugar, persona y evento. Se puede añadir comentario con información sobre la nota, así como etiquetas para identificar el tipo de palabra.</p>
<p><img src="assets/recogito-anotar.png">Ventana de anotación</p>
<p>Si seleccionamos <strong>Place (Lugar)</strong>, Recogito tratará de desambiguar la anotación según los registros de autoridad o identificadores únicos de los diccionarios geográficos (<strong>gazetteers</strong>) disponibles de la plataforma. <code>Nota: si aparece de color naranja la ventana emergente, significa que el nombre debe ser desambiguado. Cuando se torna verde es que la coincidencia se validó</code>.
Recogito actualmente utiliza ocho diccionarios geográficos históricos, así como uno contemporáneo (<a href="https://www.geonames.org/v3/">Geonames</a>). Por ello, se podrá elegir el registro de lugar que mejor se ajuste al sitio mencionado en el texto que se está anotando. Otra ventaja de alinear la anotación a un lugar con un registro, es que los <em>gazetteers</em> proporcionan otra información (como coordenadas), por lo cual Recogito generará automáticamente visualizaciones de las anotaciones de lugar en un mapa, como se puede observar en la siguiente figura.</p>
<p><img src="assets/recogito-anotacion-mapa.png"></p>
<p>Además, se observa que al pasar el mouse sobre un sitio particular se indicará referencia al texto anotado.</p>
<p>Asimismo, debe considerarse que al registrar <em>personas</em> o <em>eventos</em>, Recogito no podrá desambiguarlos por la ausencia de registros de autoridad de dichas entidades. Se recomienda, el uso de etiquetas (tags) y comentarios (comments) dentro de cada anotación, pues permite refinar más las notas realizadas, incluso pueden agregarse enlaces externos, como Wikidata o catálogos de museos.</p>
<h5><code>Anotación automática (NER, Named Entity Recognition)</code></h5>
<p><code>Luego de cargar documentos, la plataforma ofrece la opción de generar <em>anotaciones semiautomáticas</em>, mediante un algoritmo de reconocimiento de entidades nombradas (NER) basado en los idiomas admitidos por Recogito así como el del texto a anotar. Este proceso analiza el texto e intenta identificar todas las palabras que puedan ser lugares o personas. Cuando reconoce un posible lugar, tratará de buscar una coincidencia automática con un registro de autoridad de los diccionarios geográficos disponibles. Este tipo de anotación será resaltada en color gris, por su coincidencia automática, pero deberá ser confirmada por el ojo humano, y se tornará verde.</code></p></li>
<li><h4>Anotar <em>Relaciones</em> en Recogito</h4>
<p>Otro tipo interesante de anotaciones son las que se conocen como <strong>etiquetas relacionales</strong>. Estas crean conexiones entre dos o más anotaciones (de entidades) existentes. Para marcarlas se debe cambiar el modo de anotación a <code>relations</code>. Luego hacer clic en la primera entidad anotada, y arrastrar el puntero a la segunda. Aparecerá una línea punteada que conecta las dos anotaciones, junto con un cuadro de texto, donde puede completarse una descripción o etiqueta de la relación. Esta línea cuenta con una flecha, que indica la <em>dirección</em> de dicha relación. Esto es fundamental porque las relaciones poseen jerárquicas, por ejemplo, "rey de" o "year of" (deben anotarse y etiquetarse en un mismo idioma). Estas relaciones podrán exportarse en formato de <strong>nodos y aristas</strong> y podrán visualizarse en aplicaciones de análisis de red (como <a href="https://gephi.org/" target="_blank">Gephi</a>).</p></li>
<p><img src="assets/recogito-relaciones.png">Vista de Recogito con anotaciones de lugares, eventos, personas y relaciones</p>
<li><h4>Anotación de imágenes</h4>
Este proceso es similar al anterior, solo diferencia en la naturaleza del documento, es decir una imagen. Provee una vista panorámica que permite navegación, rotación y acercar/alejar la imagen. Para ello se podrán marcar puntos, rectángulos y anotación inclinada, incluso cambiar los colores de anotación, para mejorar contraste y visibilidad. Además estas anotaciones serán georreferenciadas en los mapas de Recogito.</li>
<li><h4>Descarga de Datos</h4>
<p>Recogito ofrece una gran ventaja al permitir descargar textos anotados, datos de anotaciones e imágenes en diferentes formatos que permitirán su almacenamiento, análisis, edición y visualización en otras aplicaciones. Algunos de ellos son CSV, JSON-LD, RDF-Tortle, RDF/XML, GeoJSon, KML, relaciones, etc.</p>
</li>
<p><img src="assets/recogito-descargas.png"></p>
<li><h4>Compartir datos y trabajo colaborativo</h4>
Como todas las herramientas pensadas para trabajar en <strong>Humanidades Digitales</strong>, Recogito permite la colaboración simultánea y asincrónica, habilitando la anotación de múltiples usuarios en un mismo documento. Se puede acceder a permisos y gestionarlos desde la sección <em>Configuración</em> en la barra de herramientas, habilitando una licencia del tipo Creative Commons. Allí se podrá elegir el acceso a cualquiera en la Web, a personas con enlace compartido o cerrado. Además, se podrá indicar si el acceso sólo es para visualizar el documento, habilitar descargas o permitir anotaciones. En la misma sección podrá compartir sus trabajos con usuarios específicos con privilegios de lectura, escritura o administración. </li>
<p><img src="assets/Recogito-compartir.png"></p>
</ul>
</div>
<div id="item3" class="section level3">
<h3>Ejercicio</h3>
<p>Hemos visto que Recogito es una herramienta muy versátil, amigable y con un continuo crecimiento y mantenimiento. Para poder interiorizarse con ella, les comparto un texto y una imagen donde podrán comenzar a anotar.</p>
<blockquote>Cualquier inquietud no duden en escribirme!
</blockquote>
</div>
<div>
<a href="recogito.html#foot1">[1]</a> Simon, R., Pilgerstorfer, P., Isaksen, L. and Barker, E. (2014). Towards semi-automatic annotation of toponyms on old maps. e-Perimetron, 9.3, 105-112. <a href="http://www.e-perimetron.org/Vol_9_3/Simon_et_al.pdf" target="_blank">http://www.e-perimetron.org/Vol_9_3/Simon_et_al.pdf</a>. Simon, R., Barker, E., Isaksen, L. and de Soto Cañamares, P. (2015). Linking early geospatial documents, one place at a time: annotation of geographic documents with Recogito. e-Perimetron. 10.2, 49-59. <a href="http://oro.open.ac.uk/43613/1/Simon_et_al.pdf" target="_blank">http://oro.open.ac.uk/43613/1/Simon_et_al.pdf</a>
</div>
</div>
</div>
</div>
<script>
// add bootstrap table styles to pandoc tables
function bootstrapStylePandocTables() {
$('tr.odd').parent('tbody').parent('table').addClass('table table-condensed');
}
$(document).ready(function () {
bootstrapStylePandocTables();
});
</script>
<!-- tabsets -->
<script>
$(document).ready(function () {
window.buildTabsets("TOC");
});
$(document).ready(function () {
$('.tabset-dropdown > .nav-tabs > li').click(function () {
$(this).parent().toggleClass('nav-tabs-open');
});
});
</script>
<!-- code folding -->
<!-- dynamically load mathjax for compatibility with self-contained -->
<script>
(function () {
var script = document.createElement("script");
script.type = "text/javascript";
script.src = "https://mathjax.rstudio.com/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML";
document.getElementsByTagName("head")[0].appendChild(script);
})();
</script>
</body>
</html>