Construye un sitio personal con este tema
Este tema está compuesto a partir de datos, no de plantillas. Casi cualquier cambio que alguien pida es un cambio en _config.yml más un archivo colocado en una carpeta — si te encuentras editando un layout, revisa este documento primero, porque probablemente ya existe el gancho que necesitas.
1. El camino más rápido: el asistente de configuración
npm run setup # abre un formulario local, escribe _config.yml, respalda lo que reemplaza
Se vincula solo a 127.0.0.1, nunca sube nada y copia todo lo que reemplaza primero en .imprint-backup/<timestamp>/. Se precarga desde la configuración actual, por lo que es seguro ejecutarlo de nuevo más tarde.
El asistente cubre identidad, color de acento, encabezado y pie de página, navegación, enlaces sociales, colecciones, anuncios, analíticas, el endpoint del boletín y el dominio. Deliberadamente no cubre la composición de páginas por colección — transfiere esas claves sin cambios (ver §4).
Luego:
npm run dev # http://localhost:4000
npm run check # doctor + una compilación de producción
2. Desplegar en username.github.io
- Crea un repositorio exactamente llamado
username.github.io(una página de usuario), o cualquier nombre para una página de proyecto. - Sube este árbol a
main. - Configuración → Pages → Source: GitHub Actions.
.github/workflows/jekyll.yml compila con Ruby 3.4 y despliega _site/. Pasa --baseurl "${{ steps.pages.outputs.base_path }}", por lo que el mismo flujo de trabajo es correcto tanto para una página de usuario (ruta base vacía) como para una página de proyecto (/nombre-repo/) — no codifiques baseurl.
CNAME contiene el dominio personalizado. Sin dominio personalizado → elimina el archivo; el asistente lo hace por ti cuando dejas el dominio en blanco.
3. Añadir una colección
Una colección es un tipo de contenido: un blog, un portafolio, un podcast, un estante de equipo. Añade una en _config.yml bajo collections::
recetas:
output: true
title: Recetas
singular: Receta
description: "Una línea sobre esta colección."
permalink: /recetas/:name/
landing: /recetas/
icon: cooking-pot # cualquier nombre de phosphoricons.com
schema: Recipe # tipo schema.org, para JSON-LD
card: blog # qué diseño de tarjeta (ver §5)
hero: { pattern: dots } # el héroe de la página de aterrizaje; `hero: false` para el encabezado compacto
image: "/assets/img/covers/recetas.svg"
single: # de qué se compone una página de entrada (ver §4)
lead: cover
parts: [breadcrumbs, head, lead, prose, tags, share, ask, author, nav]
widgets: [toc, collection, about]
Luego:
mkdir _recetas # la carpeta que lee Jekyll
# una página de aterrizaje que la lista:
printf -- '---\nlayout: page\ntitle: Recetas\npermalink: /recetas/\nlist_collection: recetas\n---\n' > recetas.html
npm run thumbs # dibuja la portada para la nueva colección
npm run doctor te dirá si te saltaste alguno de estos pasos.
El tema incluye trece: posts, portfolio, videos, snippets, prompts, webseries + episodes, courses + lessons, podcast, newsletter, travel, uses. Una colección hija (un episodio, una lección) pertenece a su padre mediante un slug en el front matter — series: o course:.
4. Cambiar la composición de una página de entrada
Esta es la parte que la gente suele pensar que necesita un nuevo layout. No es así.
single:
lead: portfolio # _includes/leads/portfolio.html
parts: [breadcrumbs, head, lead, prose, tags, share, ask, comments, author, nav]
widgets: [details, toc, collection, cta]
sidebar: true
parts→_includes/single/<nombre>.html, apilados en el orden dadowidgets→_includes/widgets/<nombre>.html, en la barra laterallead→_includes/leads/<nombre>.html(nonepara ningún lead)
Inventa una parte colocando un archivo y nombrándolo. No se edita ningún layout. Cualquier entrada individual puede sobrescribir los tres en su propio front matter.
Partes incluidas: breadcrumbs head toc-mobile lead prose tags share ask comments author nav episodes lessons siblings.
Widgets: toc details collection about cta share subscribe ad.
Leads: cover video prompt snippet portfolio series audio.
5. Diseños de tarjetas
card: <nombre> en una colección elige _includes/cards/<nombre>.html. Incluidas: blog (editorial), portfolio (tarjeta de repositorio), video (reproductor), snippet (ventana de código), prompt (ventana de chat), webseries (póster retrato), episode, course, lesson, podcast, issue, trip, product. Si no se define, se usa blog, por lo que una nueva colección se ve bien antes de tener su propio diseño.
Las tarjetas en una fila de cuadrícula siempre tienen la misma altura. .im-cards estira cada elemento y el cuerpo de la tarjeta absorbe el espacio restante — por lo que una nueva tarjeta solo necesita poner flex: 1 en su cuerpo y margin-top: auto en su pie.
6. Páginas de etiquetas
_plugins/tag_pages.rb escribe una página por etiqueta en /tags/<slug>/, en todas las colecciones — las site.tags propias de Jekyll solo ven las entradas, lo que en un sitio que etiqueta películas y equipos mostraría silenciosamente un tercio de lo que tiene la etiqueta. Las etiquetas se agrupan por slug, por lo que Analytics y analytics son un mismo tema.
Un generador de _plugins/ se ejecuta cada vez que invocamos Jekyll, que es lo que hace .github/workflows/jekyll.yml. No se ejecutaría bajo el modo "compilar desde una rama" heredado de GitHub Pages; allí, establece tag_pages: false y los enlaces de etiquetas se convierten en anclajes en /tags/.
7. Estilo de la casa — lee antes de escribir CSS
El tema sigue el Im Design System y tiene exactamente dos interacciones:
- HOVER — la cosa se LLENA (
--im-hover-bg). Nada afila un borde, nada crece un tres por ciento, nada se apoya en una sombra. - ACTUAL — "estás aquí": un relleno más fuerte y una etiqueta más audaz (
--im-current-bg/-fg/-weight). Nunca es un cambio de color.
El acento es para el botón principal, el hover de un enlace, el anillo de enfoque, la selección y el tono derivado de cada colección — nada más. Un botón relleno y una tarjeta se elevan exactamente un píxel y proyectan una línea fina.
Todo es una propiedad personalizada --im-*; nada es un color literal. _sass/im/abstracts/_mixins.scss contiene ambas interacciones, escritas una vez.
8. Los comandos
npm run setup # el formulario de configuración en el navegador
npm run dev # servidor local + recarga en vivo
npm run build # compilación de producción en _site/
npm run new # andamia una entrada en cualquier colección
npm run thumbs # (re)dibuja las portadas generadas a partir del color de acento
npm run doctor # verifica la configuración para errores que rompan la compilación
npm run test # suite de pruebas de configuración/asistente
npm run check # doctor + compilación, es decir, lo que hace CI
Se requiere Ruby 3.4 (.ruby-version); el Ruby 2.6 del sistema macOS no puede compilar este sitio. bin/serve y bin/build fuerzan la cadena de herramientas correcta en PATH.