Haciendo los primeros cambios de la Grafoscopedia
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:
¿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
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