# "Introduction to Systems Development" and Static Generators
# Lectura: Introduction to Systems Development
Lea el capítulo 1 del libro
Referencia
Ahmed, Tahir, Cadle, James, Cox, Julian, Girvan, Lynda, Paul, Alan, Paul, Debra, Thompson, Pete, and BCS, The Chartered Institute for IT. Developing Information Systems: Practical Guidance for IT Professionals. Swindon U.K: BCS Learning & Development Limited, 2014. Web.
Puede encontrar el pdf y el HTML del libro en este enlace:
para acceder al capítulo es conveniente que está conectado a la red de la ULL y al PuntoQ (opens new window) de la BULL.
# Tarea
Haga un resumen de los conceptos más importantes del capítulo y publíquelo como un post usando Jekyll y GitHub Pages (opens new window) para desplegar el sitio web con el informe.
# Tema
El template del que parte el repo de la asignación usa el tema Minimal Mistakes (opens new window).
# Primeros Pasos
- Haga
bundle install
para instalar las gemas necesarias.- Si usa Codespaces y no se ejecutó correctamente el .devcontainer/devcontainer.json (opens new window) deberá hacer lo mismo.
- Si tiene problemas con la instalación de las gemas, puede intentar borrar el
Gemfile.lock
o bien hacerbundle update
y volver a hacerbundle install
.
- Haga rake serve (opens new window) para servir el sitio web
- Abra una pestaña en el navegador con la URL que se le indica en el panel TERMINAL http://127.0.0.1:4001/intro2sd-template/ o en PUERTOS
- Vaya a _posts/2022-10-01-informe.md (opens new window) y practique Liquid y Markdown
- En el
_config.yml
:- Cambie el baseurl
en
_config.yml` para que contenga el apropiado para su repositorio en GitHub. - Cambie
author:
para que contenga su nombre,avatar, links, etc. - Cambie
social:
para que contenga sus redes sociales - Cambie
footer:
para que contenga sus links Font Awesome (opens new window) - Cambie
minimal_mistakes_skin
aplum
- Vea la sección collections (opens new window)
- Vea la sección defaults: (opens new window)
- Cambie el baseurl
- Pare y re-arranque el server con
rake serve
cuando cambie el_config.yml
# Despliegues
# gh-pages
Despliegue en GitHub pages usando la rama gh-pages
.
Recuerde cambiar baseurl
en _config.yml
para que contenga el nombre de su repositorio en GitHub:
baseurl : "/intro2sd-template/" # the subpath of your site, e.g. "/blog"
Véase la sección Developing en el capítulo Jekyll para más detalles.
# Netlify && Vercel
Haga un segundo despliegue en Netlify. Netlify no forma parte del Pack de GH así que tendrá que cambiar la visibilidad de su repo a público.
Puede usar las referencias:
A Step-by-Step Guide: Jekyll 3.0 on Netlify (opens new window)
A Step-by-Step Guide: Jekyll 4.0 on Netlify (opens new window)
You have instructions on how to Deploying to Vercel a Next app but most of this apply also to Jekyll.
See the Vercel AI SDK Quickstart Guide (opens new window)
# An introduction to Async JS to build a customized 404 page
Para hacer una página 404 personalizada puede inspirarse en la que se describe en estos apuntes 404.md
Puede servir fácilmente páginas de error 404 personalizadas con Jekyll reemplazando la página predeterminada Error 404 – File Not Found
que se muestra cuando uno intenta acceder a un enlace roto en su sitio.
Cualquier fichero 404.html
en la raíz de su directorio _site
será atendido automáticamente por GitHub Pages y el servidor de desarrollo WEBrick local.
Véase la documentación de Jekyllrb en Custom 404 Page (opens new window)
Para hacer una página 404 personalizada puede inspirarse en la que se describe en estos apuntes que puede ver en funcionamiento en esta web (opens new window)
You can install the VSCode extension Thunder Client (opens new window) for testing the cat API.
# Tips
- Do not forget
site.baseurl
in the links - Using multiple configuration files
jekyll build -b, --baseurl <URL>
Serve the website from the given base URL- Vercel and Netlify require the repo to be public
# Página Personal en GitHub
Con lo aprendido desarrolle su página personal en GitHub (si no es que ya tiene una).
# Entrega
Elimine los posts que no son suyos y las colecciones de ejemplo simplificando el web site a lo que son sus aportaciones:
- Sus colecciones
- Sus posts
- La barra de navegación sólo debe tener lo que es interesante para esta práctica (por ejemplo, la "quick start guide debe ser eliminada")
- Simplifique la home page