https://is.gd/dataweek17C

Agenda:

Saludar.
Algunos comentarios de la pausa.
De documentación síncrona a asíncrona.
- Descargar los HedgeDocs (manualmente)
- Control de versiones.
  - Definiendo una jerarquía de carpetas para los archivos.
  - Gestores e instaladores de paquetes de software.
  - Fossil:
    - Crear un repositorio
    - Iniciarlizarlo.
Automatismos.

Algunos comentarios de la pausa

Los lenguajes de etiquetamiento se usan también en matemáticas, por ejemplo con LaTeX.

Un lenguaje que integra las lecciones de los lenguajes ligeros y las lecciones de LaTeX, particularmente útil en publicaciones científicas es Typst

La estructura de los enlaces en este pad: los enlaces que empiezan por por punto apuntan al servidor (rutas locales). ej: DataWeek17 apunta a https://docutopia.sustrato.red/dataweek17

[DataWeek17](./dataweek17)

Saludo

Offray: Inyeccion en nalga derecha cura el dolor de garganta
Sebastián:
Adriana:
Esteban: historia de futbolito, anarco creo el juego
ruidajo: tenemos un taller de livecoding y caida del patriarcado el lunes → ruYdo: livecoding y música
Carlos:
Juan Diego:
cristian:
Diana
Maurice: Ayer vi la pelicula Working Girls, de Lizzie Borden, se las recomiendo!
Leo
Edu

Documentación síncrona y asíncrona

Es posible que queramos documentar fuera de línea y, en ese caso, sería conveniente poder descargar nuestros documentos organizarlos y publicarlos de manera resiliente y colaborativa. Esto es lo que exploraremos en esta sesión.

Empecemos por definir una ruta de carpetas y subcarpetas para colocar nuestros documentos. Son el equivalente a los namespaces, pues agrupan, de modo excluyente contenidos.

Pensemos en una jerarquía para nuestros contenidos:

~/Documents
  |_ Grafoscopio/
     |_ Wiki/
       |_Es/
       |_En/

~: home o la carpeta de usuario.
./: aquí (ruta local).

CLI vs GUI

Si queremos crear, por ejemplo, una jerarquía de subcarpetas, desde la consola,tos lo hacemos así:

mkdir -p Documents/Grafoscopio/Wiki/Es/

mkdir es make directory
-p es --parents que quiere decir que puede crear directorios internos o encadenados o hijos.

:::success Crear una jerarquía de carpetas y subcarpetas para guardar el contenido de este taller, usando o bien la interfaz GUI (Graphical User Interface) o la CLI (Command Line Interface). :::

Gestores de paquetes

Colección de herramientas que sirven para automatizar el proceso de instalación, actualización, configuración y eliminación de paquetes de software. fuente

Scoop

Para quienes están trabajando en Windows, es mejor que instalen un gestor de paquetes:

Una vez instalado Scoop, recomiendo instalar WindTerm. Esta es la página oficial de WindTerm.

CLITERATURA

Proyecto de Programando Libreros para explorar la navegación en la consola de comandos.

Explorar cliteratura.

Juegos para practicar el uso de la consola:

Brew

Brew, es similar a Scoop, para MacOS.

Descargar un documento

Podemos descargas los documentos que estamos escribiendo en HedgeDoc en distintos formatos. Para hacerlo, nos dirigimos al menú que se encuentra en la parte superior derecha de la pantalla y seguimos la siguiente indicación.

Se debe tener en cuenta el lugar de descarga del archivo, según la configuración de desacargas de cada computador.

:::success Descargar la documentación del día en distintos formatos:

Markdown
HTML
Raw HTML

Apreciar las diferencias entre los distintos formatos, abriéndolos desde el bloc de notas o un programa similar. :::

Repositorios de código para los documentos

Vamos a crear un repositorio de código para nuestros documentos y lo haremos dentro de la carpeta que descargamos.

:::info Prerrequisito: Instalar Fossil. :::

Fossil vs Git

Nos ubicamos en la subcarpeta de Grafoscopio/
```
cd ~/Documents/Grafoscopio
```

Iniciamos el repositorio:

fossil init grafoscopio.fossil

Con este comando creamos el repositorio, así no tengamos ningún tipo de contenido en él.

Aparecerá algo como esto:

project-id: f228a2520453c249d16d69533a54128154207e0b
server-id:  0cc074cfd15816708861dfbf1e35a86b88cf2004
admin-user: offray (initial password is "VrHyQRx3JM")

Abrimos el repositorio:
```
fossil open grafoscopio.fossil -k
```
Adicionamos el archivo Markdown que descargamos en secciones anteriores:
```
fossil add ruta/al/archivo
```
```
fossil add Wiki/Es/dataweek17C.md
ADDED  Wiki/Es/dataweek17C.md
```
Con esto indicamos que nos preocupa la historia de este archivo.
Lo siguiente es publicar o versionar esas historias que nos preocupan, bien sea para tener su registro privado o para colaborar con otr@s al respecto de tales archivo.
```
fossil commit -m "Iniciar información del Data Week 17 y 20 años del Bogotrax."
```
el resultado es este:
```
New_Version: f7c084efb0eaa249ddab7219166366b7a5dfcf3
```
Podemos ver la interface web del repositorio:
```
fossil ui
```
que nos dará algo como esto:

Listening for HTTP requests on TCP port 8080

y abrirá el navegador con la interfaz por omisión:
Si cliqueamos el checksum (marcado en rojo tenue en la pantalla anterior), veremos el Diff:
Guardamos una versión actualizada de este HedgeDoc y volvemos a hacer commit.

fossil commit -m "Actualizando a final del día 3." 
New_Version: 7fb11e20235833f210d0900c5d8a8123d58f95b188ee7ef546e42c06a6c3c5e1

Sobre plantillas y nombres de archivos

Si tomamos esta plantilla de Brea

La convención de nombrado es pagina.mus.html.

pagina: nombre del archivo.
.mus: es el lenguaje de plantilla. En este caso es Mustache.
html: el formato final de esa página.

Eso quiere decir que la página "Abrebocas", es el resultado de tomar el archivo Markdown e inyectarlo en dicha página.

Otros recursos o comentarios

ISO 3166-1, proporciona códigos para los nombres de países y otras..

Los enlaces a youtube usamos Invidious an open source alternative front-end to YouTube.

También existen las TUI (Text User Interface)

SPA, Single-page application

IndieWeb con Brea

"Stop Writing Dead Programs" by Jack Rusher (Strange Loop 2022)

Enlace del video

{%youtube 8Ab3ArE8W3s %}

hjkl: atajos de vim para moviento. es igual que ←↑↓→

descarga un documento.

La herramienta para capturas de pantalla es Flameshot.

Grafoscopedia

Data Week 17, día 3