¿Qué hace SiteKit?
SiteKit es un generador de sitios estáticos en Swift con enfoque en IA, construido alrededor de un pipeline orientado a fases: Descubrimiento → Carga → Enriquecimiento → Renderizado de páginas → Renderizado del sistema → Procesamiento de salida, más teletransporte de activos independientes del contenido. Cada fase es un protocolo Swift; los sitios se componen con métodos factoría de SiteBuilder (.blog(), .podcast(), .newsletter(), .portfolio(), .docs(), .docc()) y se personalizan de forma fluida intercambiando o añadiendo plugins.
Proceso
Dirige la intención del usuario a la referencia correcta. Lee solo las referencias que necesitas para la tarea actual.
| Si el usuario pregunta sobre... | Entonces lee... |
|---|---|
Instalar SiteKit + iniciar el primer sitio (la CLI sitekit) | references/bootstrap.md |
| Configurar un nuevo sitio desde cero | references/onboarding.md |
| Elegir un plano (Blog, Newsletter, Podcast, Portfolio, AppLanding, Snippets, IndieDev, DocC, Plain) | references/blueprints.md |
| Escribir contenido (publicaciones de blog, números de newsletter, páginas estáticas) | references/content-writing.md |
| Páginas legales / aviso legal / privacidad (según país, GDPR, cookies) | references/legal-pages.md |
Extensiones de Markdown DocC (@Metadata, @Row, @TabNavigator, @Video, @Image, @Links, …) + el contrato de degradación elegante | references/markdown-extensions.md |
| Sitios multilingüe (traducciones, sufijos de locale, validación) | references/localization.md |
| Auditoría de accesibilidad (contraste WCAG AA, texto alternativo, navegación por teclado) | references/accessibility.md |
| SEO + ASO + descubrimiento por IA (URLs canónicas, OG, JSON-LD, llms.txt) | references/seo-aso.md |
| Rendimiento / resultados de PageSpeed (LCP, CLS, renderizado bloqueante) | references/performance.md |
| Desplegar el sitio (matriz de proveedores de host + CI) – empieza aquí | references/deployment/SKILL.md |
| Personalización del tema (preajustes, esquemas de color, pares de fuentes, tokens) | references/themes.md |
Añadir una Page personalizada para un nuevo tipo de página HTML | references/custom-pages.md |
Extender el pipeline (Loader, Enricher, Renderer, OutputProcessor, Teleporter) | references/architecture.md |
| Solución de problemas de compilación / ejecución | references/troubleshooting.md |
| Configuración de newsletter auto-alojada (Keila + SMTP) | references/newsletter-setup.md |
| Elegir servicios externos (envío de correo, integraciones) | references/external-services.md |
Referencia de campos de SiteConfig.yaml | references/siteconfig-reference.md |
Despliegue – salta directamente a un proveedor
references/deployment/SKILL.md es el orquestador: detecta la variante de Package.swift, pregunta el modo de configuración y guía la autenticación CLI antes de enrutar a un archivo de CI + uno de host. Empieza ahí para un despliegue nuevo. Si ya conoces el destino (por ejemplo, reconfigurar un despliegue existente), salta directamente:
| Si el usuario pregunta sobre... | Entonces lee... |
|---|---|
| CI en GitHub Actions | references/deployment/ci/github-actions.md |
| CI en GitLab CI | references/deployment/ci/gitlab-ci.md (comunitario; marcador de posición) |
| CI en Xcode Cloud | references/deployment/ci/xcode-cloud.md (comunitario; marcador de posición) |
| CI en Bitrise | references/deployment/ci/bitrise.md (comunitario; marcador de posición) |
| Alojamiento en Cloudflare Pages | references/deployment/hosts/cloudflare-pages.md |
| Alojamiento en GitHub Pages | references/deployment/hosts/github-pages.md |
| Alojamiento en Netlify | references/deployment/hosts/netlify.md |
| Alojamiento en Vercel | references/deployment/hosts/vercel.md |
| Qué proveedores de CI están soportados / añadir un nuevo proveedor de CI | references/deployment/ci/README.md |
| Qué hosts están soportados / añadir un nuevo proveedor de alojamiento | references/deployment/hosts/README.md |
Saltar directamente omite el modo de configuración del orquestador y la detección de Package.swift – hazlo solo cuando esos aspectos ya estén resueltos.
Vocabulario central (siempre disponible)
- Plano (Blueprint) – una receta para un tipo de sitio.
SiteBuilderexpone métodos factoría (.blog(),.podcast(),.newsletter(),.portfolio(),.docs(),.docc()) que pre-componen la lista de plugins predeterminada para cada tipo de sitio. Los planos en disco bajoPlugin/blueprints/son sitios de inicio que el plugin puede clonar. - Page – el protocolo orientado al usuario para el renderizado de páginas HTML. Es un sub-protocolo de
Renderer. Los conformadores implementanpages(in:)yrenderHTML(_:context:);PageShell.wrap(content:page:context:)aplica automáticamente el cromo estándar<head>/<header>/<footer>. - Renderer – protocolo de salida a nivel de sistema. Declara
scope: .perLocale(predeterminado – se ejecuta una vez por locale) o.global(se ejecuta exactamente una vez por compilación, usado para sitemap, robots, llms.txt,_headersde Cloudflare). El pipeline distribuye segúnscope. SiteBuilder– builder inmutable y fluido. Cada método de configuración (.renderer,.enricher,.processor,.teleporter, …) devuelve un nuevoSiteBuilder..run()lee los verbos de CLI (build,serve,validate) y ejecuta el pipeline.BuildContext– estado de solo lectura pasado a cada plugin de las Fases 3–6. Contieneconfig,themeConfig,sections,staticPages,tags,homeContent,router,uiStrings,outputDirectory,projectDirectory.- Comandos de compilación –
swift run Site buildescribe el sitio en_Site/.swift run Site serveejecuta el servidor de desarrollo (por defecto:8080).swift run Site validateverifica la integridad de las traducciones en sitios multilingüe (los sitios de un solo idioma pasan trivialmente).--base-url <url>en build/serve anulaSiteConfig.baseURLpara esa ejecución (despliegues de staging).
Nota de estilo
Al generar contenido del sitio mediante esta habilidad, mantén una voz auténtica e independiente. Párrafos cortos. Pronombres personales. Sin rodeos corporativos. La guía completa de la voz del autor y las instrucciones del bucle de aprendizaje se encuentran en references/content-writing.md.
Pipeline de un vistazo
| Fase | Protocolo | Dónde extender |
|---|---|---|
| 0. Teletransporte de activos (independiente del contenido) | Teleporter | .teleporter(_:) |
| 1. Descubrimiento | ContentDiscovery | .contentDiscovery(_:) |
| 2. Carga | Loader<Source, Output> | .articleLoader(_:), .staticPageLoader(_:) |
| 3. Enriquecimiento | Enricher | .enricher(_:) |
| 4. Páginas HTML por locale | Page (sub-protocolo de Renderer) | .renderer(_:) |
| 5. Renderizado del sistema | Renderer + RenderScope | .renderer(_:) |
| 6. Procesamiento de salida | OutputProcessor | .processor(_:) |
Para la justificación completa de la arquitectura y ejemplos prácticos de cada punto de extensión, lee references/architecture.md y references/custom-pages.md.
Véase también
Si una tarea no está cubierta por ninguna referencia anterior – estás modificando la propia biblioteca Swift de SiteKit en lugar de construir un sitio con ella – escala a la referencia de contribuidor en la raíz del repositorio: AGENTS.md (detalles internos del pipeline, protocolos de fase, puntos de intercambio de SiteBuilder, comandos de compilación y prueba).
Para un índice tarea → doc que abarque tanto la documentación orientada al usuario como estas referencias, consulta ../../../USE-CASES.md en la raíz del repositorio.