Data Roda 31: Feminismo de Datos, día 3

Continuaremos con el proyecto descrito acá.

Para esto podemos continuar por acá:

Crear un Kanban del proyecto.
Renombrar archivos en repo para que hablen del capítulo de donde provienen.
Migrar unos archivos de Markdown a Markdeep para publicarlos directamente en la web.
Publicar el libro en dos formatos: PDF y EPUB.
Automatizar la publicación a dichos formatos.

Renombar archivos

En este momento si vemos los contenidos de los capítulos son de este estilo:

ls chapters 
6ui5n4vo.html  7ruegkt6.md    9m0tiz66.html  c5vkehnm.md    fcshwhq6.html  mravy434.md    zrlj0jqb.html       zrlj0jqb.md.html
6ui5n4vo.md    8tjbs2x5.html  9m0tiz66.md    dgv16l22.html  fcshwhq6.md    rykaknh1.html  zrlj0jqb.md         
7ruegkt6.html  8tjbs2x5.md    c5vkehnm.html  dgv16l22.md    mravy434.html  rykaknh1.md    zrlj0jqb.md.backup

Vamos a crear una convención dual para que el nombre del archivo hable de dos cosas: su procedencia, que es el código actual, pues coincide con la url, y su lugar en el libro, que no esta.

Por ejemplo zrlj0jqb.* que correspons al capítulo 1. Es decir sería mejor renombrarlo como: ch1-zrlj0jqb.*

Para ello desde la raíz del repositorio abierto hacemos:

Renombrando los archivos Markdown:

mv zrlj0jqb.md ch1-zrlj0jqb.md
fossil mv zrlj0jqb.md ch1-zrlj0jqb.md

Renombrando los archivos HTML

mv zrlj0jqb.md.html ch1-zrlj0jqb.md.html
fossil mv zrlj0jqb.md.html ch1-zrlj0jqb.md.html

Actualizamos cambios y hacemos el commit:

fossil update
fossil commit -m "Chapter renaming."

Migrar de Markdown a Markdeep

La mayoría de los archivos en formato Markdown vinieron de un proceso de limpieza manual en docutopia y están escritos en una variante de dicho formato llamada CommonMark. Acá veremos cómo transformarlos de dicha variante a otra llamada Markdeep, que permite una adecuada previsualización web, sin preocuparnos por CSS.

Tomamos un archivo cualquiera y lo copiamos de formato .md a md.html.
```
cp ch2-8tjbs2x5.md ch2-8tjbs2x5.md.html
```

Lo agregramos al repositorio:

fossil add ch2-8tjbs2x5.md.html
fossil commit -m "Changing from Markdown to Markdeep."

Lo abrimos en un edito de texto y hacemos los siguientes cambios:

Al final del archivo agregamos las líneas:

   <!-- Markdeep: -->

   <style class="fallback">body{visibility:hidden;white-space:pre;font-family:monospace}</style>
   <script>window.markdeepOptions = {tocStyle: "short"}</script>
   <script src="markdeep.min.js" charset="utf-8"></script>
   <script 
     src="https://casual-effects.com/markdeep/latest/markdeep.min.js?" 
    charset="utf-8">
   </script>
   <!--<script>window.alreadyProcessedMarkdeep||(document.body.style.visibility="visible")</script>-->

Al comienzo del documento ponemos <meta charset="utf-8">
Salvamos el documento con estos cambios y lo abrimos desde el navegador:
```
firefox ch2-8tjbs2x5.md.html
```
Deberemos ver algo similar a esto:
Colocamos los metadatos de docutopia como comentarios.
Después de los medatados colocamos el título del capítulo y de las autoras, centrado. Por ejemplo, para el capítulo 2 sería:


      **Chapter Two: On Rational, Scientific, Objective Viewpoints from Mythical, Imaginary, Impossible Standpoints**
          *by Catherine D'Ignazio and Lauren Klein*

Cambiamos las notas a pie de página de modo que sean [^n] donde n es un número por ^fn

Grafoscopedia

Data Roda 31: Feminismo de Datos, día 3

Migrar a Kanban

Renombar archivos

Migrar de Markdown a Markdeep