Markdown
- Propósito: Aprender sobre Markdown y ubicarlo entre otros formatos ligeros
para documentar y compartir datos.
- Ejercicio práctico: Crear un Etherpad en Markdown y compartirlo con los demás talleristas.
- Prerequisitos:
Introducción
Markdown es un lenguaje de etiquetamiento ligero y es, en varias métricas, el más popular.
Vamos a deconstruir las dos partes de esta explicación.
Un lenguaje de etiquetamiento ligero, es una forma de representar la estructura y presentación
de un texto acompánandolo por un conjunto de marcas sencillas en su contenido, por ejemplo,
colocar un guión bajo alrededor de una palabra quiere decir que esta en cursivas (así) y
rodearla por dos asteriscos, quiere decir que está en negrillas (de este modo).
Lo anterior permite escribir documentos de manera fluida.
Es popular porque es usado en sitios de alto tráfico donde se crean permanentemente contenidos y
se ha migrado desde ahí a poblaciones más específicas.
Por ejemplo:
Hay esfuerzos de hacer publicación e investigación transparente y reproducible usando Markdown.
Gracias a ellos, se pueden producir textos extremadamente complejos, sólo usando una
variante de Markdown.
Por ejemplo en la comunidad de Grafoscopio hemos producido el
Manual de Periodismo de Datos y los
Pasos para una Bibilioteca Digital de Bogotá.
Y además hay canales y comunidades referidas al uso de alguna variante de Markdown
para hacer dichos investigación reproducible como
el canal de Nicholas Cifuentes-Goodbody.
En contraste, existen varios lenguajes de etiquetamiento “pesado” usados ampliamente,
pero engorrosos para ejercicios de memoria y escritura fluida, como:
Y hay lenguajes llamados de serialización de datos, que sirven para describir la
estructura de datos de un modelo y comunitarla entre diferentes sistemas de información,
que tambien empiezan a tener tendencia hacia lo ligero, entre ellos:
- YAML.
- JSON (Este lenguaje es el que se usará al exportar
los datos de Twitter para el data selfie).
- TOML.
- RAML.
- STON (Inspirado en JSON,
pero para Smalltalk).
Tanto los lenguajes ligeros de etiquetamiento y de serialización de datos como los “pesados” pueden ser combinados.
“La notación inadecuada lo hace pensar a uno inadecuadamente”
Enlaces:
Ejercicio:
- Visitar los enlaces de la sección anterior, leerlos y crea un etherpad, usando Markdown,
- Leer el documento introductorio a docutopia y seguir los ejercicios
hasta la descarga del documento creado desde el navegador.
- Crear un pad en Docutopia (que es una instancia de docutopia), dentro del arenero.
Para organizar la información, los pads de práctica que creemos van a estar dentro de la arenera, que tendrá esta estructura:
subdominio.dominio.algo/categoria:pagina
docutopia.tupale.co/arenera:<pagina>
Reemplazando <pagina>
por la url que queramos, por ejemplo prueba1
.
- Si estás en una Data Week o Data Roda, comparte el enlace de tu pad con los demas
participantes, usando el etherpad de la sesión del día.
[ ^ Indice | Fossil > ]