MT01¶
El proceso de preparación del aparato de programas es complejo y requiere práctica para poder dominar con fluidez el método. Se necesitan instalar cinco aplicaciones para gestionar la bitácora en formato web: Git, GitHub, Visual Studio Code, Python y Markdoc.
El primer paso es instalar una herramienta de control de versiones, útil en caso de necesitar recuperar archivos modificados. Una vez instalada, lo que me llamó la atención fue su interfaz visual: se parece al cuadro de DOS previo a Windows. A ese cuadro se le llama Consola, y se trabaja con comandos de programación. Para iniciarla se presiona la tecla Windows + R y, en el cuadro que aparece, se escribe cmd. Una vez abierta la consola, como se ve en la imagen, se usa el comando code para ir al programa Visual Studio Code previamente instalado.
El sistema Git trabaja con una plataforma llamada GitHub, donde se alojan todos los archivos ordenados en distintas carpetas correspondientes a un proyecto determinado. A ese conjunto se le llama Repositorio. La instalación de GitHub se realiza desde la página web oficial de forma gratuita: solo hay que crear una cuenta. Una vez creada, hay que cargar el repositorio —en este caso, el creado por el equipo de la EFDI— y clonarlo en nuestro equipo.
Pero antes es necesario proteger la información de acceso con una llave digital llamada SSH. En la consola se escribe el comando:ssh-keygen - “tu mail” para crear la clave. Se presiona Enter tres veces y queda a la espera para conectar con GitHub.
La clave generada queda guardada automáticamente en la carpeta: c:/user/usuario/.ssh y se guarda en el archivo id_rsa.pub, que debe abrirse con Bloc de notas para copiar su contenido.
En GitHub, desde el menú de perfil, se va a Settings > SSH and GPG Keys y se presiona el botón New SSH Key. Ahí se pega el contenido copiado del archivo id_rsa.pub en el campo Key y se confirma con el botón Add SSH key. Luego, GitHub pide validación: se ingresa el número de verificación enviado automáticamente al correo y ¡voilá!
Ahora se vuelve a la consola y se escribe el comando: ssh-T git @github.com para acceder al repositorio y conectar Git con GitHub a través de la llave. Nadie más que el propietario del computador puede acceder al repositorio clonado. Una vez ingresado el comando, aparece en la consola el saludo de autorización y el acceso con el nombre de usuario de la cuenta GitHub.
Bien, ahora sí hay que cargar el repositorio facilitado por el equipo EFDI, donde está la plantilla de la web. En GitHub se presiona el botón Fork (ubicado a la derecha, debajo de la barra de menús). Esto abre la página Create a new fork y, en el campo Repository name, se escribe el formato nombre_apellido. Luego se presiona Create fork.
Paréntesis: varios habían dado clic en el botón Create fork sin los pasos previos de crear la clave y demás. Para borrar un repositorio, se va al menú Settings y en el último campo está la opción de eliminarlo.
Continuando con Create fork, se abre el cuadro para configurar nombre y apellido, se completa la descripción y se vuelve a presionar el botón de crear fork. Luego se va al menú Action para activarlo. Después, en Code, se edita el archivo README (ícono del lápiz), se personalizan los datos con el mismo nombre de la cuenta GitHub y se confirma con el botón Commit changes (dos veces).
En el archivo mkdocs.yml también se actualizan los datos y se confirman nuevamente los cambios. Volviendo al menú Action, se visualiza el proceso que ejecuta el servidor. En la interfaz aparecen tres rectángulos conectados; en el que se llama Deploy se encuentra la ruta de la página web de cada usuario.
El mantenimiento y la gestión de nuevos contenidos se realizan en Visual Studio Code. Una vez instalado desde la página oficial, se abre desde la consola con el comando: code + Enter
En la barra lateral izquierda aparecen los iconos de navegación. El primero es el Explorador, donde se encuentran todos los archivos de la plantilla y los alojados en las carpetas del proyecto. El tercer ícono es el de confirmar cambios: cada vez que se modifica algo, queda registrado en la base de datos. En la parte inferior se visualiza la lista de cambios realizados y en la parte superior aparece el botón Commit.
Es importante poner un nombre al cambio antes de confirmar, ya que, sin eso, el botón de commit no funcionará.
Esto es todo amigo!!!¶
Referencias: Clase 08092025