Estructurando el flujo documental y livecodeando.
Asistentes
- Offray
- viviana
- constanza
- choff
- Víctor
- Sara del Mar
- Caos
- ruidajo
Agenda:
- Empalme.
- Live Coding.
- El código como material "recalcitrante" (Sam Aaron).
- Automatizando los primeros flujos documentales.
Empalme
En la sesión anterior
Preguntas
¿Cuál es la diferencia escencial entre la documentación en distintos sistemas que hemos visto (Glamorous, HedgeDoc, TidlyWiki)?
| No. | Características | HedgeDoc | TiddlyWiki | Grafoscopio/GToolkit | mdBook |
|---|---|---|---|---|---|
| 01 | Formato | Markdown | WikiText / Markdown parcial | Markdown / Markdeep | Markdown |
| 02 | Colaboración | Síncrona | Asíncrona | Asíncrona | Asíncrona |
| 03 | Documentos computacionales | No | Parcial | Sí | No |
| 04 | Lenguaje de Programación | JavaScript | JavaScript | Pharo | Rust |
| 05 | Macros | Parcial | Sí | Sí | Parcial |
| 06 | Lenguajes de dominio específico (DSL) | Pobre | Rico | Rico | Parcial (plugins) |
| 07 | Transportabilidad del DSL | nula | Baja | Alta | baja |
| 08 | Búsqueda | Genérica | Detallada | Detallada | Detallada |
| 09 | Transclusión | No | Si | Sí | Sí |
| 10 | Plataforma | Web | Web | Escritorio | Web |
| 11 | Tipo de plataforma | MPA | SPA | MPA | MPA |
Convenciones:
- MPA: Multi Page Application.
- SPA: Single Page Applicacion
Responde a preguntas de contexto como:
- ¿Quiero hacer un taller y editar simultaneamente? (HedgeDoc)
- ¿Quiero tener una plataforma web de visualización de información y documentacion modular (rompecabezas) y estructurada emergente? (TiddlyWiki)
- ¿Quiero tener una herramienta extensible con la documentación en mi escritorio y con posibilidades multiples de exportación y capacidades computacionales? (SmallTalk - Pharo - Gtoolkit - Grafoscopio/MiniDocs)
¿Cuál es la línea de tiempo, en qué momento fue evidente la necesidad de pasar de TWiki a Glamorous?
¿Es Markdown un estándar?
Es un estándar de facto. pero esta pobremente establecido.
Markdown fue creado en ~2004 por Jhon Gruber y Aaron Swartz,
estudiando las convenciones ad-hoc de escritura de correos.
El formato fue específicado en una implementación markdown.pl.
El creador de Stack Overflow, Joel Spolsky, tuvo una pelea :rage: Gruber alrededor de lo que
el primero "paternidad responsable" de los proyectos de software libre.
De esta pelea y la intensión de no participar en nada con Joel surgió Common Mark,
del cual particpa Jhon McFarlene, creador Pandoc.
Propuso finalmente un nuevo formato, llamado Djot,
nacido del ensayo Beyond Markdown.
Un formato interesante y fácil de aprender, extensible es AsciiDoc. Para más diatribas, pueden ver Mi lenguaje de etiquetamiento ideal
Comic de xkcd sobre standards id:927 https://xkcd.com/927/
Un lugar donde las reflexiones entre plataformas de publicación, su interconexión y valor diferencial pueden ser apreciadas es la Documentatón.
Live Coding
:::success Ver
Luego del video vamos a ir a este enlace
- https://flok.cc/s/grafoscopicos
- https://foxdot.org/
- https://hydra.ojack.xyz/docs/
Usualmente las comunidades de livecoding se reunen u organizan en Toplap.
En la comunidad hemos hecho datarodas enfocadas en livecoding sonoro o visual:
- Data Roda 61: Inquieta y Ruidosa | Día mundial de la escucha 2021
- Data Roda 62
- Orejas Sin Límites (Data Roda 70) | Día mundial de la escucha 2022
- El parche del código caliente :fire: (Data Roda 71)
El código como material "recalcitrante" (Sam Aaron).
El creador de Sonic Pi, Sam Aaron en un artículo académico, habla del código como material recalcitrante, con su propia lógica, que se opone a determinadas manipulaciones y facilita otras.
Lo explicaremos con un video:
{%youtube EFmxPMdBqmU %}
Pausa Chilaquilera
Foto de seis platos de chilaquiles, mogollas con guacamole, vasos para mimosas y café
Automatizando los primeros flujos documentales
En nuestra sesión previa consideramos este flujo de trabajo
Gráfica con el flujo entre el sistema operativo, grafoscopio y la web
Vamos a adentrarnos en el ecosistema de Smalltalk.
Gráfica mostrando la relación entre el sistema smalltalk y el sistema operativo
Iremos enriqueciendo y modificando la imagen, en la medida en que la usamos.
El documento exportado la última vez, entonces, hace parte de la imagen. Si queremos exportarlo al sistema de archivos, debemos cliquear el botón a continuación para hacerlo:
La exportación desde la imagen hacia el sistemas de archivos, ocurre a través de este proceso:
El HTML se verá así en el navegador web por omisión desplegado desde nuestro sistema de archivos:
Notas varias
Qué tan triste esta Markdown
:frowning: :weary: :confounded: :tired_face: :cry:
Aquí una guía de emojis en markdown https://gist.github.com/rxaviers/7360908
https://es.wikipedia.org/wiki/Stack_Overflow
https://gabriellacoleman.org/
el escritorio debe morir https://uxdesign.cc/the-desktop-metaphor-must-die-676fbb34afdb
y cómo es que a indígenas del cauca no les hacen sentido las metáforas de ventanas y escritorios, porque la computadora está sobre el escritorio :o)
Alan Kay, Adele Goldberg y Dan Ingals