Manual de Periodismo de Datos

<p>
  <a href="http://interactivos.lanacion.com.ar/manual-data/img/cover_print.png">
    <img 
      src="http://interactivos.lanacion.com.ar/manual-data/img/cover_print.png" 
      alt="Portada original del Manual" 
      width="18%"
    />
  </a>
  <a href="./doc/tip/img/notebook.png">
    <img 
    margin-right: 1%; 
    margin-bottom: 0.5em;" 
    src="./doc/tip/img/notebook.png" 
    alt="Captura de pantalla del manual en Grafoscopio."
    width="45%"
    >
  </a>
  <a href="./doc/tip/img/cap4.jpg">
    <img 
    margin-right: 1%; 
    margin-bottom: 0.5em;" 
    src="./doc/tip/img/cap4.jpg" 
    alt="Un capítulo del Manual de Periodismo de Datos."
    width="30%"
    >
  </a>
<p>

# Manual de Periodismo de Datos, la versión de código abierto

(*English translation below*)

Este es el repositorio de código fuente del Manual de Periodismo de Datos,
que te permite descargarlo, en distintos formatos, y participar abiertamente 
de su (de)construcción, adaptación y modificación. 

Acá unos enlaces rápidos: 

- [Manual de Periodismo de Datos en PDF](./uv/mapeda.pdf) (~13Mb).
- [Código fuente del Manual en Markdown](./doc/tip/mapeda.markdown) (~500kb).
- [Código fuente del Manual en Grafoscopio](./doc/tip/mapeda.ston) (~600kb).
- [Grafoscopio](http://mutabit.com/grafoscopio/): La herramienta adaptable de visualización y narrativas de datos con la que creamos esta versión del Manual.
- Los [Data Weeks](http://mutabit.com/dataweek/) y las Data Rodas: Son talleres+hackatones y un conjunto de encuentros ágiles y amigables, en los 
que creamos este Manual y varios otros proyectos.

El Manual de Periodismo de Datos puede ser copiado libremente, redistribuido y reusado bajo los términos de la licencia 
[Creative Commons Atribución-CompartirIgual](http://creativecommons.org/licenses/by-sa/3.0/). 
Los 
[contribuyentes](http://interactivos.lanacion.com.ar/manual-data/p%C3%A1ginas_preliminares_1.html) 
al Manual del Periodimo de Datos retienen el copyright sobre sus contribuciones respectivas y están de acuerdo en publicarlas bajo los términos de esta licencia.
Nuestras versiones del Manual de Periodismo de Datos, consecuentemente, 
se encuentran cubiertas por la misma licencia.

# Acerca de este proyecto

Existen interesantes [Obras Culturales Libres][obras-libres], que, 
sin embargo, no son de código abierto. 
Esto quiere decir que están cubiertas por licencias bastante liberales,
que permiten su remezcla, distribución, modificación y venta, pero 
las infraestructuras que soportan la creación, modificación y publicación 
de dichas obras, no permiten amplia participación, ni tampoco la trazabilidad 
de la historia respecto a dichos procesos colectivos.

Esta es nuestra propuesta sobre una manera alternativa de crear dichas obras,
abordando ese problema y usando como ejemplo el 
Manual de Periodismo de Datos 
([Inglés](http://datajournalismhandbook.org/),
[Español](http://interactivos.lanacion.com.ar/manual-data/)),
e *infraestructuras de bolsillo*, que se caracterizan por ser sencillas, 
auto-contenidas y que funionan bien en y fuera de línea, como 
[Fossil][fossil] y [Grafoscopio][grafoscopio-es], el cual extendimos y 
adaptamos para este proyecto.

Este lugar y sus herramientas te permiten descargar las últimas versiones 
del Manual en distintos formatos, copiar (clonar) este repositorio para acceder 
a todos los archivos toda su historia, e incluso crear tu propio usuario y 
aportar en la construcción de nuevas variaciones y versiones.
Tenemos talleres y encuentros recurrentes, llamados [Data Weeks][dataweek] y 
Data Rodas, donde explicamos más detalles de cómo hacer parte de 
procesos/proyectos como estos.
Puedes encontrar más información al respecto de cómo vincularte a este proyecto,
de los momentos y espacios de encuentro, las herramientas y la comunidad,
en el prólogo del Manual.

# Data Journalism Handbook, the open source version

This is the (Spanish) Data Journalism Handbook source code repository, 
that allows you to download it, in several formats and participate, in an 
open way, from its (de)construction, adaptation and modification.

Here some quick links:

- [Manual de Periodismo de Datos en PDF](./uv/mapeda.pdf) (~13Mb).
- [Handbook's Markdown source code](./doc/tip/mapeda.markdown) (~500Kb).
- [Handbook's Grafoscopio source code](./doc/tip/mapeda.ston) (~600Kb).
- [Grafoscopio](mutabit.com/grafoscopio/index.en-html): The moldable tool for
  data visualization and storytelling that we used to create this version of
  Handbook.
- The  [Data Weeks](http://mutabit.com/dataweek/) and the Data Rodas: 
  are a workshops+hackathons and a set of agile and friendly meetings, where
  we created this Handbook and several other proyects.

# About this project

There are some interesting [Free Cultural Works][free-works] which are not
open sourced.
This means that, they are covered under pretty liberal licenses,
allowing their remix, sale and modification, but the infrastructures 
which support the creation, modification and publishing of such works, 
don't allow wide participation and deep traceability of the history of
such collective endeavors.

This is our approach about alternative ways for creating such works, 
addressing the above problem, using the Data Journalism Handbook as an
example ([English](http://datajournalismhandbook.org/),
[Spanish](http://interactivos.lanacion.com.ar/manual-data/)) and
*pocket infrastructures*, which are simple, self contained, and
work well on-line and off-line, like [Fossil][fossil] and 
[Grafoscopio][grafoscopio-en]. 
Also we extended and adapted Grafoscopio, during this project, 
to make the tool suit the problem (and not the usual other way around).

This place and its tools, allow you to download the last versions of the
Manual, in several formats, copy (clone) this repository to access all
files and their history and even to create your own user to participate
in the (de)construction of new versions and variants.
We have workshops and frequent meetings, called [Data Weeks][dataweek] y 
Data Rodas, where we explain how to become part of projects/process like 
this one.
You can find more information about this in the Handbook's prologue.

[fossil]: http://fossil-scm.org/
[grafoscopio-es]: http://mutabit.com/grafoscopio/
[grafoscopio-en]: http://mutabit.com/grafoscopio/index.en.html
[dataweek]: http://mutabit.com/dataweek/
[obras-libres]: http://freedomdefined.org/Definition/Es
[free-works]: http://freedomdefined.org/Definition

--- exportedFrom: a1f099fb989b6d31967c7bd3553e3041cec469d0 title: Manual de Periodismo de Datos
lang: es
pandocOptions: |
    [
    	' --latex-engine=lualatex  -H preamble.tex  --variable fontsize=12pt --variable documentclass:book  --variable papersize:letter  --variable classoption:openright  --top-level-division=chapter '
    ]


  ---  \begin{titlepage}
    \begin{center}
    
        \vspace*{1cm}
        
%       Dissertation No.
       
        \vspace*{1cm}
................................................................................
                         {Manual de Periodismo de Datos}}}
        
        \vspace{0.5cm}
        
        \vspace{1.5cm}
 
           \large{Versión: 1.0}\\
           Revisión: {{revision}}  
        
        \vspace{0.8cm}        
         
        Editado por\\        
        \textbf{Jonathan Gray, \\ Liliana Bonegru \\ y Lucy Chambers}
       
       \vspace{0.8cm}    
................................................................................
Manual de Periodismo de Datos acá presente.
Considerar a los de bicicleta y los de a pie, con hardware modesto y conectividad intermitente,
como ocurre en el llamado Sur Global y la amplia latinoamérica, ha implicado optar por lo 
que yo llamo *infraestructuras de bolsillo*, que se caracterizan por ser sencillas, auto-contenidas, 
y funcionar bien en o fuera de línea, tales como [Grafoscopio][grafoscopio-es] y [Fossil][fossil].

También hemos usado nuestro modesto y acogedor *hackerspace*, [HackBo][hackbo], como 
lugar de creación grupal, pues a pesar de que escribo este prólogo como indivio, esta versión 
del Manual es el resultado  de un trabajo colectivo, no sólo de los autores originales, sino de la 
pequeña comunidad de práctica, sin la cual la obra que usted tiene ante sí, no sería posible.
Con Silvia Buitrago, David Salvador, Eduardo Riesco, David y Leonardo Ramírez-Ordoñez, 
y Gloria Meneses, aprovechamos la naturaleza amoldable de Grafoscopio y lo usamos 
y extendimos para adecuarlo particularmente a crear esta versión del manual:
conversando de algoritmos, escribiendo código para los scrappers y conversores 
de formatos (de HTML a Markdown),  editando y adecuando los textos, tomando café y 

---
exportedFrom: 0891e98853b6745691d70c3ef5bb2fc2eccbf8e0
title: Manual de Periodismo de Datos
lang: es
pandocOptions: |
    [
    	' --pdf-engine=lualatex  -H preamble.tex  --variable fontsize=12pt --variable documentclass:book  --variable papersize:letter  --variable classoption:openright  --top-level-division=chapter '
    ]
  ---

\begin{titlepage}
    \begin{center}
    
        \vspace*{1cm}
        
%       Dissertation No.
       
        \vspace*{1cm}
................................................................................
                         {Manual de Periodismo de Datos}}}
        
        \vspace{0.5cm}
        
        \vspace{1.5cm}
 
           \large{Versión: 1.0}\\
           Revisión: 0891e98853  
        
        \vspace{0.8cm}        
         
        Editado por\\        
        \textbf{Jonathan Gray, \\ Liliana Bonegru \\ y Lucy Chambers}
       
       \vspace{0.8cm}    
................................................................................
Manual de Periodismo de Datos acá presente.
Considerar a los de bicicleta y los de a pie, con hardware modesto y conectividad intermitente,
como ocurre en el llamado Sur Global y la amplia latinoamérica, ha implicado optar por lo 
que yo llamo *infraestructuras de bolsillo*, que se caracterizan por ser sencillas, auto-contenidas, 
y funcionar bien en o fuera de línea, tales como [Grafoscopio][grafoscopio-es] y [Fossil][fossil].

También hemos usado nuestro modesto y acogedor *hackerspace*, [HackBo][hackbo], como 
lugar de creación grupal, pues a pesar de que escribo este prólogo como individuo, esta versión 
del Manual es el resultado  de un trabajo colectivo, no sólo de los autores originales, sino de la 
pequeña comunidad de práctica, sin la cual la obra que usted tiene ante sí, no sería posible.
Con Silvia Buitrago, David Salvador, Eduardo Riesco, David y Leonardo Ramírez-Ordoñez, 
y Gloria Meneses, aprovechamos la naturaleza amoldable de Grafoscopio y lo usamos 
y extendimos para adecuarlo particularmente a crear esta versión del manual:
conversando de algoritmos, escribiendo código para los scrappers y conversores 
de formatos (de HTML a Markdown),  editando y adecuando los textos, tomando café y 

OrderedCollection [
	GrafoscopioNode {
		#header : '%metadata',
		#body : '| metadata pandocOptions revision |

revision := {\'thisNotebook\' -> \'markdownFileChecksumUpto: 10\'} asDictionary.
pandocOptions := {
\' --latex-engine=lualatex \', 
\' -H preamble.tex \',
\' --variable fontsize=12pt\', 
\' --variable documentclass:book \', 
\' --variable papersize:letter \',
\' --variable classoption:openright \',
\' --top-level-division=chapter \'
}.

OrderedCollection [
	GrafoscopioNode {
		#header : '%metadata',
		#body : '| metadata pandocOptions revision |

revision := {\'thisNotebook\' -> \'markdownFileChecksumUpto: 10\'} asDictionary.
pandocOptions := {
\' --pdf-engine=lualatex \', 
\' -H preamble.tex \',
\' --variable fontsize=12pt\', 
\' --variable documentclass:book \', 
\' --variable papersize:letter \',
\' --variable classoption:openright \',
\' --top-level-division=chapter \'
}.