Haciendo los primeros cambios de la Grafoscopedia

Presentación del diplomado
- Índice, para encontrar las otras sesiones

Receso de 40min nos vemos de vuelta a las ~~11:50~~ 12:00 sumamos 10min.

Asistencia

Offray Luna.
Sara del Mar Castiblanco
Caos Ludd
Víctor Hugo
ruidajo
choff
constanza
Adri
Viviana
M00

Agenda

Uso del editor (por ejemplo LiteXL).
Uso del generador del libro / web app con mdbook.
Uso del repositorio de fossil de la grafoscopedia.
- registrarse
- sincronizar cambios

Revisando el editor y la interfaz de mdbook

Al final de la sesión anterior terminamos con nuestro primer boceto de libro y pudimos servirlo localmente.

La idea es tener la propia nubecita (ver referencia en la sección notas varias) que en nuestro caso, se ve acá:

Captura de la pantalla del navegador señalando la url para el servidor local

En esta sesión crearemos una tabla de contenido tentativa de la Grafoscopedia y veremos cómo esto se refleja tanto en la carpeta de la Grafoscopedia como en servidor local.

Para eso crearemos la tabla de contenido de mdBook, que está en el archivo SUMMARY.md

Hay una descripción detallada de la tabla de contenido en mdBook

Recreemos una tabla de contenido de esta manera:












# Summary

# Eventos

- [Data Weeks](dataweeks.md)
- [Data Rodas](datarodas.md)
- [Diplomados](diplomados.md)
  - [Segundo diplomado](diplomado/2.md)
    - [Sesión 4](diplomado/2/4.md)
    - [Sesión 3](diplomado/2/3.md)

# Prototipos

Dicha tabla de contenido se refleja en la estructura de carpetas dentro de la subcarpeta wiki:










└── wiki
    ├── datarodas.md
    ├── dataweeks.md
    ├── diplomado
    │   ├── 2
    │   │   ├── 3.md
    │   │   └── 4.md
    │   └── 2.md
    ├── diplomados.md
    └── SUMMARY.md

Actualizando el repositorio

Usualmente el repositorio local tiene un repositorio remoto, esta relación se creo cuando ejecutamos fossil clone en la sesión pasada.

Cuando suceden cambios en el repositorio remoto, es decir en la página web o servidor original, necesitamos ejecutar fossil update.

La respuesta en la consola se vera similar a la siguiente

Pull from https://mutabit.com/repos.fossil/grafoscopedia/
Round-trips: 2   Artifacts sent: 0  received: 14
Pull done, wire bytes sent: 1191  received: 3093  ip: 45.55.37.99
CONFLICT wiki/SUMMARY.md
ADD wiki/es/datarodas.md
ADD wiki/es/dataweeks.md
ADD wiki/es/diplomado/2.md
ADD wiki/es/diplomado/2/2-3.md
ADD wiki/es/diplomado/2/2-4.md
ADD wiki/es/diplomados.md
ADD wiki/es/mdbook.md

Si vemos el navegador de archivo o desde la consola la subcarpeta wiki/, veremos algo como esto:















wiki/
├── es
│   ├── datarodas.md
│   ├── dataweeks.md
│   ├── diplomado
│   │   ├── 2
│   │   │   ├── 2-1.md
│   │   │   ├── 2-2.md
│   │   │   ├── 2-3.md
│   │   │   └── 2-4.md
│   │   └── 2.md
│   ├── diplomados.md
│   └── mdbook.md
└── SUMMARY.md

La tabla de contenido modificada queda de la siguiente manera. Hemos agregado :





















# Summary

# Eventos

- [Data Weeks](es/dataweeks.md) <!-- ruidajo -->
- [Data Rodas](es/datarodas.md)
- [Diplomados](es/diplomados.md)
  - [Segundo diplomado](es/diplomado/2.md)
    - [Sesión 4](es/diplomado/2/2-4.md) <!-- sara -->
    - [Sesión 3](es/diplomado/2/2-3.md) <!-- víctor h-->
    - [Sesión 2](es/diplomado/2/2-2.md) <!-- choff -->
    - [Sesión 1](es/diplomado/2/2-1.md) <!-- viviana -->

# Prototipos

# Herramientas

- [mdBook](es/mdbook.md) <!-- Offray -->
- [Gestores e instaladores de software](es/gestores-software.md) <!-- Adri -->
- [Hypothesis: Lectura hipertextual anotada](es/hypothesis.md) <!-- constanza -->
- [Scuttlebut: redes sociales distribuidas](es/scuttlebut.md) <!-- Caos -->

Para quienes no eligieron HedgeDoc, acá están los enlaces del código fuente:

Importante, registrarse en el repositorio de la Grafoscopedia

¿Cómo registrarse en el repositorio remoto?

En el enlace https://mutabit.com/repos.fossil/grafoscopedia/login

Captura de pantalla de la interfaz del repositorio para login

Seleccionar la pestaña Login
Seleccionar el botón Create A New Account

Captura de pantalla para el registro de usuaria

El User ID: sera el nombre de usuario que usamos para registrarnos y hacer los commits, no debe tener espacios ni caracteres especiales.
Display Name: este es un nombre que se va a mostrar en las interfaz y nos permite usar espacios y caracteres especiales y no tiene una función aparte de ser un display o representación de la usuaria.
Email Address: el correo que se usa para recuperar contraseña y contacto en general
Password y Confirm la constraseña y la confirmación de la contraseña.
Captcha llenar el captcha como se muestra en la captura y finalmente pulsar el botón Register

Finalmente para registrar cambios en el repositorio remoto debemos solicitar a la persona que administra el servidor que nos de permisos de desarrollador, eso permitira que empujemos (push) o sincronicemos nuestros cambios locales con el repositorio remoto.

Agregando los archivos al repositorio de fossil

En el directorio donde esta abierto el repositorio ejecutamos

fossil add wiki/SUMMARY.md
- fossil add se usa para agregar archivos que van a ser parte de historia de versionamiento del repositorio.

La respuesta en la consola pueder ser:

ADDED wiki/SUMMARY.md
- que significa que el archivo fue agregado
SKIP wiki/SUMMARY.md
- que significa que el archivo ya esta siendo seguido o revisado por el repositorio y no es necesario agregarlo de nuevo.

Podemos ver el estado actual del repositorio ejecutando

fossil status

nos dara el estado actual del checkout

repository:   /home/usuario/Documents/Diplomado-2/Repositorios/grafoscopedia.fossil
local-root:   /home/usuario/Documents/Diplomado-2/Repositorios/Grafoscopedia/
config-db:    /home/usuario/.config/fossil.db
checkout:     e74953b79a9aefae5748f8d93ac162d4968d9615 2025-02-22 17:41:23 UTC
parent:       56a07cfb7a9554b547a857c19230282cb4a57fdb 2022-03-04 16:22:08 UTC
tags:         trunk
comment:      Agregando archivo original de Tiddler en formato STON. (user: offray)
ADDED      wiki/SUMMARY.md

A diferencia que Git, fossil no requiere que agreguemos los cambios para cada commit después que un archivo esta siendo seguido, fossil mostrara que hay cambios en el archivo que no están en el commit más reciente.

¿Qué es un commit?

En el diccionario en inglés tenemos la definición de commit como consignar un registro para la memoria.

En el repositorio de fossil un commit, crea una nueva versión (registro en la memoria) conteniendo todos los cambios in el checkout actual.

En el checkout se encuentran los archivos que hemos agregado al repositorio ejecutando fossil add <dirección/a/archivo>.

Para el commit usamos un mensaje para que cada versión tenga un breve descripción de ese nuevo registro, un ejemplo de un commit en el repositorio de la grafoscopedia:

17:41:23 [e74953b79a] *CURRENT* Agregando archivo original de Tiddler en formato STON. (user: offray tags: trunk)

17:41:23 la hora en que ser realizo el commit
[e74953b79a] el hash o numero unico que representa el commit en la historia del repositorio.
*CURRENT* es un indicador que nos dice que es commit en el que estamos actualmente ubicados
Agregando archivo original de Tiddler en formato STON. el mensaje del commit.
(user: offray tags: trunk), user usuario que hizo el commit, tags etiqueta que representa la rama del repositorio donde estamos haciendo el commit (registro en la memoria del repositorio)

Subir los archivos al repositorio remoto

Para sincronizar los cambios locales en el repositorio remmoto podemos autenticarnos localmente con nuestra usuaria.

Ejecutamos fossil remote https://usuaria@mutabit.com/repos.fossil/grafoscopedia/

nos preguntara la contraseña que usamos en el repositorio remoto.

Luego nos preguntara si recordar la contraseña, para no volver a ingresarla.

Finalmente podemos hacer fossil sync.

Resolución de problemas o troubleshooting

No se reflejan los cambios de configuración de mdbook en el navegador

Después de modificar contenidos o estructuras del libro como el archivo SUMMARY.md en el src = descrito en el book.toml

Ejecutar mdbook serve ejecuta el servidor, pero no actualiza los contenidos de configuración, ejemplo: modificaciones en book.toml. Es necesario ejecutar mdbook serve --open.

Notas varias

Hay dos tipos de memoria una que almacena la información y otra que la procesa

Memoria de almacenamiento
- Cuando abrimos el archivo desde lite-xl estamos trabajando en el almacenamiento del archivo (apuntamos a)
Memoria de procesamiento
- Cuando lanzamos el navegador para consultar el archivo estamos trabajando en el procesamiento del archivo

Técnica copo de nieve para escritura.

https://hipertextual.com/2015/08/tecnica-copo-de-nieve

Códigos ISO 639-3 Son códigos de tres letras para todos los idiomas del mundo. Por ejemplo, aym es el código para aimara y grn para guaraní. Hay otros códigos también como ISO 639, MARC, etc.

Los primeros 20 años de GNU/Linux en Colombia

https://www.skinait.com/los-primeros-20-años-de-gnu-linux-en-colombia-Escritos-23/

El Directorio Como unas Páginas Amarillas del software libre … ¡Pero mejores!

https://web.archive.org/web/20080224100838/http://www.el-directorio.org/

en la consola para saber cuál es mi nombre de usuarie whoami

La propia nubecita

Hace referencia a la canción La Voladora de El Sayayin una champeta de un autor cartagenero, que en el coro dice:“la propia nubecita / la propia nubecita / ah aaah” y luego “Se montaba en su nubeee”

Explicación del portal letras del significado de la letra de ‘La Voladora’

Transcripción de ‘letras’ explicando la letra de La Voladora

La canción ‘La Voladora’ de El Sayayin es una representación vibrante y festiva de la cultura de la fiesta y el desenfreno. La letra describe a una mujer que se monta en su ‘nube voladora’, una metáfora que sugiere un estado de euforia o embriaguez. Este estado la lleva a comportarse de manera despreocupada y a disfrutar de la vida nocturna sin recordar sus acciones al día siguiente. La repetición de ‘soba que soba’ refuerza la idea de un ritmo constante y repetitivo, típico de una noche de baile y diversión sin fin. https://www.letras.com/el-sayayin/la-voladora/significado.html

Banda sonora

La Voladora - El Sayayin

https://youtu.be/d440dCl1Mbo