Cómo crear un currículum en línea con tecnología de Jekyll y GitHub Pages

El currículum de Homer como relleno - Joel Glovier

La semana pasada, he estado investigando algunos temas interesantes relacionados con sitios web estáticos alojados en opciones simples. A lo largo de este viaje para obtener más conocimiento, descubrí Jekyll, un generador de sitio estático que funciona sin problemas con la función GitHub Pages que ofrece el enorme servicio de repositorio.

Si bien no tenía un plan concreto para estas dos cosas, comencé a buscar en GitHub los temas de Jekyll, para ver qué se les ocurrió a otros y tener una idea de la cantidad de personalización que ofrece Jekyll.

Rápidamente encontré una plantilla de currículum simple para Jekyll construida por Joel Glovier. Inmediatamente, una bombilla se encendió en mi mente, ya que recientemente comencé a actualizar y refinar mi currículum. En lugar de hacer malabarismos con archivos .docx y .pdf en correos electrónicos, Google Docs o Dropbox, podría alojar fácilmente una versión en línea en mi perfil de GitHub, mejorando la accesibilidad tanto para mí como para los reclutadores, al tiempo que destaco mi experiencia con el servicio de repositorio.

El proceso no fue exactamente el más sencillo, así que decidí hacer una crónica de mi viaje para que otros puedan tener un momento más fácil. Como tal, profundicemos.

Configurar Jekyll y sus requisitos previos

En primer lugar, debe instalar Jekyll y sus diversos requisitos previos, entre los que se encuentra Ruby. La sección de documentación del sitio web oficial está bastante bien escrita, pero, dado que estoy ejecutando Windows, necesitaba ayuda específica. Aquellos que ejecutan Windows 10 con las actualizaciones Creators o Anniversary pueden usar el nuevo shell Bash. Aquellos con versiones anteriores pueden consultar esta guía.

Después de configurar todo, es hora de bifurcar y clonar el repositorio de plantillas de currículum de Joel Glovier en su máquina local. Para hacerlo, recomiendo instalar GitHub Desktop, que también incluye el shell Git.

Personalizando la plantilla

Una vez que tenga el repositorio en su máquina, es hora de comenzar a personalizar los archivos más importantes, comenzando con el archivo _config.yml. Esto incluye los detalles de configuración para cualquier sitio de Jekyll. En el caso de esta plantilla, puede usarla para mostrar u ocultar varias secciones, así como cambiar metadatos como el título de su sitio.

Después de lograr esto, puede saltar a la carpeta _data para completar las secciones con su propia información. Los archivos tienen nombres que se explican por sí mismos y están en formato .yml. Puede editarlos usando Notepad / Notepad ++ u otros editores (yo uso Atom).

Para una personalización adicional, puede ir a _layouts y editar resume.html para cambiar el orden de las secciones, por ejemplo.

Una modificación importante con la que luché fue reemplazar el conjunto limitado de iconos que aparecen frente al título de su trabajo. Joel agregó solo algunos íconos que, aunque eran lo suficientemente buenos, no eran relevantes para mí. Pasé algún tiempo tratando de agregar un nuevo ícono .svg para Medium, ya que quiero anunciar mi trabajo aquí. Al final, las cosas no funcionaron, así que opté por agregar la biblioteca bastante útil de fuentes increíbles.

Como tal, fui a _incluye y agregué en head.html el enlace del script para font-awesome. Luego, en la misma carpeta, edité icon-links.html para especificar, en lugar de los iconos svg, los que están integrados en font-awesome.

Para lograr el cambio de color en el mouse y eliminar el color de enlace predeterminado para los iconos, también hice un viaje a la carpeta _sass para editar _resume.css. Aquí, comenté .icon-link y dentro de .icon-link-item agregué:

Por último, pero no menos importante, parece que hay un pequeño problema relacionado con la sección Educación de la plantilla. Como especifiqué en un problema enviado a Joel, una etiqueta de párrafo carece de una especificación de estilo necesaria, lo que hace que el resumen se agregue al nombre del título.

Poner todo en GitHub y alojar en Pages

Una vez que haya personalizado todo, es hora de subirlo a GitHub y dejar que la función Páginas lo aloje automáticamente para que el mundo lo vea.

Como se indica en el sitio web oficial, debe crear un nuevo repositorio titulado .github.io. En mi caso, este es andreidbr.github.io. Clone este repositorio localmente. Aquí es donde se mostró mi falta de experiencia actual, ya que acabo de copiar los archivos y las carpetas de la carpeta local de la plantilla del curriculum vitae. Tenga en cuenta que no debe copiar sobre la carpeta .git o el archivo CNAME. Confirme los nuevos archivos y su nuevo sitio web estará disponible en la dirección en el nombre del repositorio. En mi caso, el currículum está en vivo en https://andreidbr.github.io/.

Si desea utilizar un nombre personalizado para una dirección externa, cree un archivo llamado CNAME y escriba la dirección donde desea que aparezca el sitio.

Comida para llevar

Después de esta experiencia, puedo decir que Jekyll es un generador de sitio estático bastante ingenioso que puede ser tan complejo o tan simple como quieras. Al comenzar con la plantilla, logré aprender algunas cosas muy útiles y obtener un currículum en línea en el proceso. También me familiaricé con GitHub y su función de Páginas, así que espero que este artículo ayude a otros que quieran hacer lo mismo.