MT01¶
Introducción¶
En el marco del módulo técnico 01 (MT01), introducción a herramientas digitales, se desarrolla el sitio web estático con la finalidad de albergar y registrar la documentación del trabajo que vaya a realizar a lo largo de la Especialización en Fabricación Digital e Innovación.
Para ese fin se utiliza un sistema de control de versiones (VCS, por sus siglas en inglés), que permite registrar los cambios en un conjunto de archivos y permite el almacenamiento de versiones, la posibilidad de rastrear y recuperar versiones y realizar copias de seguridad.
En este caso, se utiliza como software de control de versiones a Git. Este VCS se caracteriza por su eficiencia, pues solo almacena aquellos archivos que han sido modificados. En aquellos que no, solo incorpora un enlace al archivo ya existente.
La plataforma en línea de versión de controles Git utilizada aquí es Github, que se caracteriza por el almacenaje en repositorios, facilitar el seguimiento y control de versiones, la colaboración entre personas y la existencia de Pages; estas permiten a publicar una web estática directamente del repositorio.
Desarrollo¶
Ante la tarea de tener que crear un sitio web estático, luego de volver a ver la grabación de la clase y consultar los materiales disponibles en la plataforma EDU, me dispuse de preparar los distintos recursos que necesitaría previamente para eso, como descargar los programas necesarios y crear una cuenta en GitHub.
Pasos para la configuración de un repositorio en Github¶
Para configurar el repositorio y publicarlo como web, se siguieron adelante los siguientes procedimientos:
- 01 | Crear una cuenta en GitHub
- 02 | Instalar Git
- 03 | Configurar Git con Gitbash
- 04 | Generar una SSH key
- 05 | Realización del fork del template y creación del repositorio local
- 06 | Activación del sitio
- 07 | Cambios posteriores
01 | Crear una cuenta en GitHub¶
Se crea una cuenta en GitHub.
02 | Instalar Git¶
La instalación succedió sin inconvenientes. Luego de instalado, fué necesario probar uno por uno cuál de los tres necesitaba para acceder a la terminal de comandos.
03 | Configurar Git con Gitbash¶
Se comienza a realizar la configuración de Git con Gitbash. Esto es también un acercamiento al primer uso de la consola en esta plataforma.
El primer inconveniente encontrado es la necesidad de ser preciso con los comandos ingresados, como se puede ver en la imágen inferior.
04 | Generar una SSH key¶
Se realiza una SSH key para poder continuar con el procedimiento.
05 | Realización del fork del template y creación del repositorio local¶
Se realiza el fork del template EFDI, para poder incorporarlo en el repositorio propio.
En esa etapa me enfrenté a una serie de dificultades y errores que implicaron volver a probar hasta que daba con cual era el inconveniente y su solución. Como se puede ver en la imagen, en primer lugar el nombre del directorio en que se encontraba la carpeta —probablemente por su extensión— traía un error, reflejado en el mensaje «Too many arguments». Luego de googlear cual podría ser el error, se optó por cambiarle el nombre a la carpeta por uno de menor extensión. Posteriormente faltó ingresar el comando «cd», que permite navegar en el directorio.
Finalmente se pudo clonar el repositorio en mi terminal.
06 | Activación del sitio¶
Luego de clonado el respositorio en mi computadora, fue necesario agregarlo y editarlo en Visual Studio. Habiendo hecho algunos cambios en la sección «About», me dispuse a activar el sitio.
Para mi sorpresa, me era imposible seleccionar en dentro de la sección Pages de GitHub la opción gh-pages. Busqué soluciones pero me era imposible dar con ella hasta, luego de revisar intercambios en el Discord de la clase, donde varias personas se encontraban con problemas similares, me surgió la idea de probar de editar otros archivos, como Readme.me y mkdocs.yml, para posteriormente intentar nuevamente publicar el sitio.
Por suerte, estos intentos fueron exitosos y me permitieron activar y publicar el sitio. En la imagen inferior se pueden observar los workflows alcanzados al momento.
07 | Cambios posteriores¶
Posteriormente a la configuración del sitio, busqué cambiar el mensaje de bienvenida, ahí la dificultad estuvo en dar con el archivo necesario para eso.
Asimismo, quise empezar a experimentar en la realización de cambios mínimos a nivel estéticos y visuales en la web. En este sentido, busque cambiar la tipografía del sitio por una diferente; para esto se optó por seleccionar la tipografía Inter.
Material de referencia¶
Como material de referencia para la elaboración del repositorio, además del provisto en clase, se utilizaron las siguientes fuentes:
Conclusiones¶
Como resultado del desarrollo del MT01 se pudo llevar lograr establecer un repositorio publicado como una web a través de Git Hub. En este caso, el contenido y configuraciones del tema es desarrollado a través del IDE VS Code.
Personalmente, desconocía el potencial de este tipo de plataformas para su uso como repositorio. Asimismo, la lógica para la carga de archivos y edición y formateo de texto, si bien en un principio resultar un poco engorroso, luego de utilizarla y explorar su uso, se consigue entender su lógica de funcionamiento. En ese sentido, al poder formatear utilizando html me resulta más familiar y cercano.