Data Roda 29: Feminismo de Datos

:::info Fecha: Viernes 4 de enero, 2019.

9:30 AM: Inicio.
Medio dia: Almuerzo.
Tarde: Continuación. :::

En este encuentro empezaremos un meta-comentario al libro de Feminismo de Datos, migrándolo a nuestras infraestructuras de bolsillo, como ya lo hicimos con el Manual de Periodismo de Datos, con un procedimiento similar, que también tendremos oportunidad de mejorar y corregir.

El proceso es en líneas generales:

Introducción
Haremos una "libreta maestra" de Grafoscopio con la tabla de contenido de libro.
Colocaremos la libreta maestra en un repositorio de Fossil, que contendrá todo el libro.
Crearemos una tabla de contenido compartida del libro, que servirá para coordinar el trabajo y para la importación de textos.
Importaremos los contenidos de la web a la libreta maestra.
Transformaremos cada capítulo de HTML a Markdown (PubPub, la plataforma del MIT, ya ofrece la funcionalidad de exportación, pero aún esta en desarrollo y falla en este momento -- ver captura).
Limpiaremos el Markdown de cada capítulo.
Aplicamos plantillas y exportamos a múltiples formatos.
Por el camino, modificaremos Grafoscopio para que se adecue mejor a estas tareas.

Introducción

Tanto el MIT como la comunidad de Grafoscopio, están pensando en dinámicas de publicación radicalmente abiertas, desde infrastructuras distintas que dan cuenta de contextos distintos y complementarios.

El PupPup del MIT está llegando a su segunda publicación con Data Feminism y nosotros a la tercera que es soportada por las infraestructura de bolsillo.

Lo que haremos hoy (y lo que hacemos permanentemente) es una muestra de como se conjungan tres fuerzas que configuran cualquier espacio (según Isin y Ruppert -- Being Digital Citizens):

Legal: Tanto los sitios y publicaciones del MIT como las nuestras están cubiertas por licencias libres y abiertas. Esto pasa en concreto en dos lugares: Los Términos de Servicio de PubPub y en la obra misma que es alojada allá y que hereda dichos términos. Por tanto, contamos con los permisos para moverlos la obra de lugar, siempre y cuando mantengamos los mismos derechos y de hecho la licencia permite el relicenciamiento.
Performativas: Nuestro encuentro cara a cara y en ciberespacio mediado por la acción, en particular con esa obra es una manera de hacer un performance: nos reunimos para cambiar la infraestructura que soporta la obra y a través de ello hacer un meta-comentario sobre la misma.
Imaginativas: Pensamos en otras maneras de ser, estar y publicar y colocamos prácticas e infrastructuras que soportan esa imaginación y la posibilitan. También nos permiten imaginar cosas nuevas.

:::info Alcances Lo importante, antes del 7/ene/19, que cierra la fecha de comentarios, es dejar publicado un borrador de la obra en línea y comentarlo con las autoras en la plataforma de ellas, o por Twitter, Facebook, etc.

Sería bonito crear nuestro propio prólogo/epílogo (en Spanglish) a la obra de ellas. :::

El proceso

El proceso va a tener tres facetas, clásicas del trabajo con datos:

Adquisición (Scrapping).
Formateado.
Republicación.
Programación: automatizar y mejorar el proceso y es transversal a los pasos anteriores.

Grafoscopio hará posible esto. El diagrama de este proceso sería:

Nuestro proceso

Libreta Maestra de Grafoscopio

El proceso en líneas generales es este:

Creamos una libreta en Grafoscopio: Cada (Sub)sección es un nodo en Grafoscopio y su enlace apunta a el lugar original desde donde se tomó la información.
Publicamos esa libreta sencilla (sin ningún HTML) en un repositorio y nos sincronizamos con el repositorio en línea.
Importamos el contenido para los nodos a partir de los enlaces en ellos.
Hacer un commit al repositorio para indicar cómo estaba el texto original (nuestra aproximación alternativa al scrapping + metaestructura).
Transformamos cada nodo en Markdown, quedará sucio, pues contiene información que no nos interesa, que viene del HTML (estilos, comentarios), que no hacen parte del libro "original".
Hacemos nuevamente un commit.
Publicamos cada nodo como un pad en Docutopia y hacemos la limpieza allí, pues esto nos da la ventaja de la previsualización en tiempo real y la colaboración. Podríamos hacer también sólo en Grafoscopio pero perdemos esas dos ventajas.
Una vez tengamos el texto limpio, copiamos su contenido de docutopia al respectivo nodo en Grafoscopio.
Hacemos un commit del nodo que hayamos limpiado, dejando huellas de las coautorías.
Finalmente agregamos los metadatos, las plantillas y publicamos en distintos formatos, o por lo menos en los siguienes: PDF y EPUB.

Empezar la libreta

Si vemos la estructura en Data Feminism notamos que en líneas generales es así:

Prefacio
Capítulos: Introducción, capítulos 1 al 8 y conclusión.
Lecturas adicionales: 4.

Nota curiosa :smile: Diferencia entre Introducción, Prefacio y Prólogo.

En Grafoscopio sería algo como:

Salvamos la libreta. Para este proyecto la colocaremos en: ~/Documentos/DataFem/datafem.ston

Trabajar con el repositorio para el proyecto

Crearlo, alistarlo y publicarlo

Creamos un repositorio en Fossil y agregamos la libreta:

  mkdir ~/Documentos/DataFem
  cd ~/Documentos/DataFem/
  fossil init datafem.fossil
  fossil open datafem.fossil
  fossil add datafem.ston
  fossil commit -m "Starting with the original book structure."

Lanzamos la interface administrativa y alistamos el repositorio para su publicación en línea con fossil ui. Veremos algo como:
Habilitamos desde la interface administrativa que los usuarios se pueda registrar a sí mismos:
Una vez hemos llenado el título y la descripción del repositorio, haciendo click en la solapa Admin > Configuration, y luego revisitando el Home veremos algo como:
Si nos ubicamos en la solapa Wiki veremos que hay una página llamada Data Feminism que fossil crea automáticamente y convierte en la página portada para el repositorio. Colocaremos allí cierta información básica, para publicar el repositorio cuanto antes y luego cambiaremos estas opciones con una página más detallada (probablemente hecha con Markdeep).
Nos ubicamos en la página "Data Feminism" del wiki y la editamos con alguna información mínima. Veremos algo como:

que ya es un repositorio mínimo que podemos colocar en línea, usando nuestros propios servidores o ChisselApp. Usaremos la primera opción

:::success El nuevo repositorio estará disponible en:

https://mutabit.com/repos.fossil/datafem/ :::

Clonar y abrir el repositorio

Creamos una carpeta en nuestro disco duro y clonamos el repositorio:

  mkdir -p ~/Documentos/DataFem
  cd ~/Documentos/DataFem
  fossil clone https://[usuario]@mutabit.com/repos.fossil/datafem/ datafem.fossil

donde [usuario] debe ser reemplazado por el nombre del usuario que creamos previamente (sin los paréntesis).

Veremos algo como:

    Round-trips: 2   Artifacts sent: 0  received: 10
    Clone done, sent: 550  received: 3510  ip: 2.0.1.187
    Rebuilding repository meta-data...
      100.0% complete...
    Extra delta compression... 
    Vacuuming the database... 
    project-id: 08e8979c1db787ea096886057dfea5fb3fc75f82
    server-id:  935f0f7d71d99f52771be6fedacd615c06aae44c
    admin-user: root (password is "e998bb")

Abrimos el repositorio desde esta carpeta:

  fossil open datafem.fossil

Veremos algo como:

[paco@Annapurna DataFem]$ fossil open datafem.fossil 
datafem.ston
project-name: Data Feminism
repository:   /home/paco/DATA/Projects/DataFem/datafem.fossil
local-root:   /home/paco/DATA/Projects/DataFem/
config-db:    /home/paco/.fossil
project-code: 08e8979c1db787ea096886057dfea5fb3fc75f82
checkout:     7fe9c5b4cee5cbc1228e894eaf137ac23f9629a5 2019-01-04 17:29:33 UTC
parent:       ce2e28af282df27d6399e2beae8fe08c45e22ce2 2019-01-04 17:25:47 UTC
tags:         trunk
comment:      Starting with the original book structure. (user: offray)
check-ins:    2

Si listamos el contenido de carpeta veremos:

[paco@Annapurna DataFem]$ ls
datafem.fossil  datafem.ston
[paco@Annapurna DataFem]$ ls -la
total 300
drwxr-xr-x  2 paco users   4096 ene  4 20:11 .
drwxr-xr-x 21 paco users   4096 ene  4 20:04 ..
-rw-r--r--  1 paco users 258048 ene  4 20:11 datafem.fossil
-rw-r--r--  1 paco users   6737 ene  4 20:11 datafem.ston
-rw-r--r--  1 paco users  32768 ene  4 20:11 .fslckout
[paco@Annapurna DataFem]$

:::info

IMPORTANTE Para trabajar colaborativamente debemos registrarmos en el repositorio remoto desde este enlace:

https://mutabit.com/repos.fossil/datafem/register

e indicar que queremos permisos de desarrollador por cualquiera de nuestros canales comunitarios :::

Luego de registrados y ubicados en el repositorio abierto escribimos:

  fossil sync http://[usuario]@mutabit.com/repos.fossil/datafem

donde [usuario] debe ser reemplazado por el usuario que con el que nos hemos registrado. En ese momento nos pedirá la contraseña en el lugar de registro.

Vale la pena terminar esta parte con una actualización, por si ha cambiado algo desde nuestro registro.

fossil update

y veremos los últimos cambios.

Importando contenido en las libreta maestra

Por lo pronto haremos la importación con los botones de Grafoscopio, en crudo, sin optimizar el scraper, para no lidiar, tempranamente con la paradoja de la automatización:

Para ello presionamos el botón en cada nodo.

Comentarios y preguntas adicionales

¿Cómo ver las publicaciones de los usuarios de Hypothes.is?
- Con la URL https://hypothes.is/users/<nombre_usuario> ; por ejemplo https://hypothes.is/users/offray para el usuario offray o https://hypothes.is/users/hiperterminal para el usuario hiperterminal
- Para ver una web con anotaciones públicas, puede hacerse pegando el link de la web en https://via.hypothes.is/
¿En qué consiste eso de abrir y cerrar un repo?
¿Se pueden modificar muchos repositorios específicos o siempre se debe trabajar con todos los repos? Por ejemplo si quiero trabajar sólo con el repo de Datafem y no
Creando una alias al pharo launcher: Desde la consola de comandos teclamos algo como
```
alias pharo-launcher=~/Programas/PharoLauncher/pharo
```

Limpiando en Markdown

Tuvimos que emplear un proceso manual y uno automático como se ve acá.

Ver la tabla de contenido

Notas extra

Brujula de continuidades

Brújula de continuidades

Grafoscopedia