alexwlchan.net

Alexwlchan.net

Este repositorio tiene el código para mi sitio personal, Alexwlchan.net, que es un sitio estático construido con Jekyll. Incluye una serie de complementos que he escrito para personalizar el sitio.

Herramientas clave

El sitio usa:

• Jekyll, que genera las páginas HTML
• Sass, para construir las hojas de estilo CSS y Styles
• Acciones de GitHub, que construye e implementa el sitio
• Caddy, que es el servidor web

Cuando quiero hacer un cambio, abro una solicitud de extracción. Esto desencadena una construcción con acciones de GitHub, y como parte de la construcción verifica el HTML con HTML -Probher. Esto verifica el texto alternativo faltante, los enlaces rotos, el HTML inválido, etc.

Si el sitio pasa cheques, se fusiona automáticamente y la compilación en la rama main publica el cambio a mi servidor web.

Construyendo el sitio

Necesitas instalados Git, Ruby y Python.

Para ejecutar una copia local del sitio:

$ git clone [email protected]:alexwlchan/alexwlchan.net.git

$ python3 -m venv .venv
$ pip install -r requirements.txt

$ bundle install

$ bundle exec jekyll serve

El sitio debe estar ejecutándose en http: // localhost: 5757. Si realiza cambios en los archivos de origen, se actualizará automáticamente.

Para crear un conjunto único de archivos HTML estáticos:

$ bundle exec jekyll build

Esto crea un conjunto de archivos HTML en _site .

Cómo funciona el sitio

Publico el código fuente para que otras personas puedan ver cómo funciona el sitio y tal vez utilice algunas de las ideas para sus propios sitios. Esta es una lista de cosas que creo que son interesantes o inusuales:

• Generación de alimentación de átomos
• No-JavaScript Twitter incrusta
• Vinculación con mi trabajo en otros sitios
• Validando la materia frontal en los archivos de Markdown

Que contribuye

Las correcciones para errores tipográficos son bienvenidos, pero de lo contrario se ignorarán las contribuciones.

Si desea utilizar alguno de los componentes en sus propios proyectos (complementos, diseños, hojas de estilo) no dude en hacerlo.

Licencia

• Excepto cuando se indique lo contrario, el Sitio y el Código Associado son de doble licencia como:

  • Creative Commons Attribution 4.0 International (también conocido como CC por 4.0)
  • La licencia del MIT

  Si está reutilizando mi contenido, puede usar la licencia más apropiada.

  Principalmente el CC por está bien, pero las licencias de Creative Commons no son adecuadas para el código, por lo que tengo el MIT como alternativa.

• Algunas imágenes que se utilizan con licencias Creative Commons de otras personas; Vea la publicación donde se usa una imagen para la atribución.

• Todos los íconos en el sitio se utilizan bajo una licencia libre de regalías del proyecto sustantivo; Debe haber comentarios en los archivos SVG que indiquen su fuente. Los autores del icono original conservan los derechos de autor.