Γα=Ω5 site

Guía de instalación de entorno de desarrollo con ruby y Jekyll:

• Teniendo los permisos y llaves necesarias, clonar la repo con git clone git@github.com:CPC-GALLOS/CPC-GALLOS.github.io.git
• Para Windows instalar con scoop ejecutando scoop install main/ruby en la terminal (powershell)
• para MacOS instalar con brew ejecutando brew install --cask ruby
• Para linux depende de la distro, solo busca en google como instalar ruby y ruby-dev/ruby-devel

Warning

• En Arch Linux ruby esta desactualizado, por lo que usar Github Codespaces, cs50.dev,jruby o containers de VScode son las unicas opciones, yo recomiendo los containers.
• En fedora (redhat) ocupas descargar primero gcc, g++ y make, lo puedes hacer con el comando sudo dnf group install "development-tools"

Alternativa: VScode dev containers con docker

• Seguiendo esta guia oficial
• Para Windows instalar con scoop install main/ruby o con winget install -e --id Docker.DockerDesktop
• para MacOS instalar con brew install --cask docker
• Para Arch Linux ejecutamos sudo pacman -Sy docker y sudo systemctl enable docker
• Instalamos la extensión de dev containers en VScode
• Por último en VScode abrimos la carpeta del proyecto y precionamos f1 para ejecutar el comando New Dev Container y elegimos a ruby

Alternativa Avanzada: nix-shell

• Descarga e instala Nix (the package manager) a travez de este link
• Ya instalado solo ejecuta nix-shell dentro de esta carpeta del proyecto y listo, continua los pasos

Despues de instalar:

• Abrir la carpeta del proyecto en vscode
• Ejecutar bundle dentro de la carpeta del proyecto para descargar las dependencias de ruby (solo la primera vez)
• Ejecutar bundle update dentro de la carpeta del proyecto para actualizar las dependencias de ruby
• Para ver la pagina web de manera local ejecutar bundle exec jekyll s en la terminal (cada ves que abras el proyecto)
• Ir a http://127.0.0.1:4000 ó http://localhost:4000/ en tu navegador de preferencia

Guía de edición:

• En la terminal dentro del proyecto en VScode
• Agrega nuevos blogs ejecutando bundle exec jekyll post "Titulo del blog"
• La Pagina principal se edita en _tabs/about.md
• Las demás etiquetas también están en _tabs/
• Se deben poner las imágenes en assets/img/ creando una nueva carpeta por cada titulo. (PRECAUCIÓN: No poner en assets/img/favicons/)
• Para un ejemplo de como empezar un blog revisa este post de chirpy
• Para el formato del blog revisa este ejemplo en markdown y el resultado del ejemplo