sexyjekyll-theme 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7676b2fb6a9335165bcb3d2f22674f6829f7211a4bfdcbb24be34c34f1e0095e
+  data.tar.gz: bc0e698014bfe9069f1b992dd03c7be56fb37001e7c7f798185586ae66e82959
+SHA512:
+  metadata.gz: 981e834e7b15ac0880f7739a81145abbc60188d7818e801d0172465d3b89478e729ad8357289f26a29556537c955128e41a664893c18b3a0080131c151905b17
+  data.tar.gz: 11acf898a957a2acad18f4b0112b2618addae35c02243fa814887d02b7cb15a1fdc5c7d8a754cccda7df2335d9589e53826ce47bd7f9c5b3ccbcc54298ae822f

data/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [SexyJekyll Theme]
+
+## [1.0.1] - 2025-11-01
+
+### Changed
+- **Internationalization System**: Complete i18n system for all UI elements, labels, and text strings
+  - Created centralized translation system in `_data/i18n.yml`
+  - Support for 5 languages: English, Italian, German, French, Spanish
+  - All templates updated to use translation keys (nav, footer, blog, post, categories, home, related posts, SEO, llms.txt)
+  - 52 translated strings across 9 logical sections
+  - Comprehensive documentation in `docs/I18N.md`
+- **Date Localization**: Enhanced date formatting plugin
+  - Renamed `italian_date` plugin to `localized_date`
+  - Plugin file renamed from `italian_date.rb` to `localized_date.rb`
+  - Added automatic date localization based on site language setting
+  - Month names now display in the selected language for all 5 supported languages
+  - Backward compatibility maintained with deprecated `italian_date` filter
+  - All templates updated to use `localized_date` filter
+- **Documentation Organization**: Moved technical documentation to `docs/` folder
+  - Moved ACCESSIBILITY.md, SEARCH.md, READING_PROGRESS.md, STRUCTURED_DATA.md, COMMENTS.md to docs/
+  - Created `docs/README.md` as documentation index
+  - Updated all 5 README files with correct documentation links
+  - Better organization for maintainability and discoverability
+- **Dynamic Configuration**: Made robots.txt dynamic
+  - Converted to Liquid template with dynamic `{{ site.url }}` variables
+  - Sitemap URLs now automatically reflect site configuration
+
+### Added
+- Multi-language README files (English, Italian, German, French, Spanish)
+- Complete i18n support for llms.txt files (all metadata labels localized)
+- `.gitignore` file with comprehensive exclusion rules for Jekyll projects
+- Multi-language documentation system
+
+### Fixed
+- Hardcoded Italian text in UI elements now properly localized
+- Hardcoded URLs in robots.txt now dynamic
+- Date formatting now respects site language setting
+- All UI elements now use centralized translation system
+
+## [1.0.0] - 2025-11-01
+
+### Added
+- Initial release of SexyJekyll Theme
+- Modern, responsive design with clean minimalist aesthetic
+- Advanced search functionality with instant results
+- Reading progress indicator for blog posts
+- Related posts system based on categories, tags, and content similarity (TF-IDF algorithm)
+- Comprehensive accessibility features (WCAG 2.1 Level AA)
+- SEO optimization with structured data (JSON-LD)
+- AI-friendly llms.txt generation for each blog post
+- Site-level llms.txt with content overview
+- Multi-language support (Italian and English)
+- Contact page with social media links
+- Category-based post filtering with auto-generated category pages
+- Responsive navigation with mobile support
+- Code syntax highlighting with line numbers
+- RSS feed support
+- Sitemap generation
+- Reading time estimation
+- Responsive images with WebP support
+- Custom 404 page
+- Print-friendly styles
+- Multi-language date formatting filter (English, Italian, German, French, Spanish)
+
+### Features
+- **Layouts**: default, home, blog, post, about, contact, category, llms, 404
+- **Standard Plugins**: jekyll-feed, jekyll-seo-tag, jekyll-paginate, jekyll-sitemap, liquid_reading_time, jekyll_picture_tag
+- **Custom Plugins**: llms_txt_generator, auto_related_posts, category_generator, localized_date (multi-language date formatting)
+- **Accessibility**: Skip to content link, semantic HTML, ARIA labels, reduced motion support
+- **Performance**: Lazy loading images, optimized CSS/JS, WebP image format
+- **SEO**: Meta tags, Open Graph, Twitter Cards, structured data, canonical URLs
+- **AI-Friendly**: llms.txt generation for posts and site, clean semantic markup for AI crawlers
+
+[1.0.1]: https://github.com/amargiovanni/sexyjekyll-theme/releases/tag/v1.0.1
+[1.0.0]: https://github.com/amargiovanni/sexyjekyll-theme/releases/tag/v1.0.0

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Andrea Margiovanni
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.de.md

@@ -0,0 +1,276 @@
+# SexyJekyll Theme
+
+Ein modernes, funktionsreiches Jekyll-Theme, das für professionelle Blogs und persönliche Websites entwickelt wurde. Gebaut mit Fokus auf Barrierefreiheit, Leistung und Benutzererfahrung.
+
+![SexyJekyll Theme](screenshot.png)
+
+## Funktionen
+
+### Design und Benutzererfahrung
+- **Modernes Design**: Saubere, minimalistische Ästhetik
+- **Vollständig responsiv**: Mobile-first Design, das auf allen Geräten funktioniert
+- **Lesefortschritt**: Visueller Indikator für den Leseffortschritt von Artikeln
+- **Druckstile**: Optimierte Layouts zum Ausdrucken
+
+### Inhalts- und Navigationsfunktionen
+- **Erweiterte Suche**: Sofortige clientseitige Suche mit Keyword-Hervorhebung
+- **Verwandte Beiträge**: Intelligente Beitragsempfehlungen basierend auf Kategorien und Tags
+- **Kategorien**: Kategoriebasierte Filterung und Organisation
+- **Paginierung**: Anpassbare Beitragspaginierung
+
+### SEO und Soziale Medien
+- **SEO-optimiert**: Meta-Tags, Open Graph, Twitter Cards
+- **Strukturierte Daten**: JSON-LD Schema für besseres Verständnis durch Suchmaschinen
+- **RSS-Feed**: Automatische Feed-Generierung
+- **Sitemap**: Automatisch generierte Sitemap für Suchmaschinen
+
+### Barrierefreiheit
+- **WCAG 2.1 Level AA**: Umfassende Unterstützung für Barrierefreiheit
+- **Skip to Content**: Hilfen zur Tastaturnavigation
+- **Semantisches HTML**: Richtige HTML5-Landmarks und Struktur
+- **ARIA-Labels**: Bildschirmleser-freundlich
+- **Reduced Motion**: Respektiert Voreinstellungen des Benutzers für Bewegungsanimationen
+- **Hoher Kontrast**: Ausgezeichnete Farbkontrastverhältnisse
+
+### Leistung
+- **Responsive Bilder**: WebP-Format mit mehreren Größen
+- **Lazy Loading**: Bilder werden bei Bedarf geladen
+- **Optimiertes CSS/JS**: Minifizierter und effizienter Code
+- **Schnelle Ladezeiten**: Optimiert für Leistung
+
+### Entwickler-Funktionen
+- **Syntax-Hervorhebung**: Code-Blöcke mit Zeilennummern (Rouge)
+- **Lesezeit**: Automatische Schätzung der Lesezeit
+- **Mehrsprachig**: Vollständiges i18n-System mit Unterstützung für Englisch, Italienisch, Deutsch, Französisch und Spanisch
+- **Anpassbar**: Einfache Konfiguration über `_config.yml`
+- **Gut dokumentiert**: Umfassende Dokumentation enthalten
+
+### KI und LLM-Funktionen
+- **llms.txt-Unterstützung**: Automatische Generierung von KI-freundlichen Inhaltszusammenfassungen
+- **Pro-Beitrag llms.txt**: Jeder Blogbeitrag generiert seine eigene llms.txt-Datei unter `/blog/YYYY/MM/DD/post-slug/llms.txt`
+- **Seitenebene llms.txt**: Hauptdatei llms.txt im Root-Verzeichnis mit Siteübersicht und Inhaltsstruktur
+- **Strukturierter Inhalt**: Saubere, semantische HTML5-Markierung, optimiert für KI-Crawler
+- **JSON-LD Schema**: Umfangreiche strukturierte Daten für besseres Inhaltsverständnis
+- **KI-Crawler-freundlich**: Willkommener Zugang zur KI-Indexierung mit klaren Anweisungen
+
+## Installation
+
+### Als Ruby Gem (empfohlen)
+
+Fügen Sie diese Zeile zur `Gemfile` Ihrer Jekyll-Website hinzu:
+
+```ruby
+gem "sexyjekyll-theme"
+```
+
+Und fügen Sie diese Zeile zu Ihrer Jekyll-Website `_config.yml` hinzu:
+
+```yaml
+theme: sexyjekyll-theme
+```
+
+Führen Sie dann folgendes aus:
+
+```bash
+bundle install
+```
+
+### Remote Theme (GitHub Pages)
+
+Wenn Sie GitHub Pages verwenden, fügen Sie dies zu Ihrer `_config.yml` hinzu:
+
+```yaml
+remote_theme: amargiovanni/sexyjekyll-theme
+```
+
+### Manuelle Installation
+
+1. Laden Sie dieses Repository herunter oder klonen Sie es
+2. Kopieren Sie die Dateien auf Ihre Jekyll-Website
+3. Aktualisieren Sie Ihre `_config.yml` mit den Theme-Einstellungen
+
+## Schnelleinstieg
+
+1. **Installieren Sie das Theme** mit einer der oben genannten Methoden
+
+2. **Konfigurieren Sie** Ihre `_config.yml`:
+
+```yaml
+# Siteeinstellungen
+title: Your Name
+email: your.email@example.com
+description: Your site description
+baseurl: ""
+url: "https://yoursite.com"
+lang: de  # Optionen: en, it, de, fr, es
+
+# Autoreninfos
+author:
+  name: Your Name
+  email: your.email@example.com
+  linkedin: https://www.linkedin.com/in/yourprofile/
+  bluesky: https://bsky.app/profile/yourhandle
+
+# Navigationslogo
+nav_logo:
+  type: text  # 'text' oder 'image'
+  text: YN    # Ihre Initialen oder Text
+  # image: /assets/img/logo.png  # Oder Pfad zum Logo-Bild
+  # alt: Your Logo
+
+# Hero-Sektion
+hero:
+  name: Your Name
+  role: Your Role
+  subtitle: Your Company or Tagline
+  tagline: Your personal tagline
+  description: A brief description about you
+
+# Blog-Sektion
+blog:
+  title: Blog
+  description: Your blog description
+
+# Kontakt-Sektion
+contact:
+  title: Get In Touch
+  description: Contact page description
+  links:
+    - name: Email
+      url: mailto:your.email@example.com
+      type: email
+    - name: LinkedIn
+      url: https://www.linkedin.com/in/yourprofile/
+      type: linkedin
+```
+
+3. **Erstellen Sie Ihren ersten Beitrag** in `_posts/`:
+
+```markdown
+---
+layout: post
+title: "Your First Post"
+subtitle: "Optional subtitle"
+date: 2025-11-01
+categories: blog tech
+---
+
+Your post content here...
+```
+
+4. **Führen Sie Jekyll aus**:
+
+```bash
+bundle exec jekyll serve
+```
+
+Besuchen Sie `http://localhost:4000`, um Ihre Site zu sehen!
+
+## Konfiguration
+
+### Verfügbare Layouts
+
+- `default` - Basis-Layout für alle Seiten
+- `home` - Startseite mit Hero-Sektion
+- `blog` - Blog-Auflistungsseite
+- `post` - Einzelner Blogbeitrag
+- `about` - Über-Seite
+- `contact` - Kontaktseite mit Social-Links
+- `category` - Kategoriespezifische Beitragsauflistung
+- `404` - Benutzerdefinierte 404-Fehlerseite
+
+### Plugins
+
+Das Theme verwendet diese Jekyll-Plugins:
+
+**Standard-Plugins:**
+- `jekyll-feed` - RSS-Feed-Generierung
+- `jekyll-seo-tag` - SEO Meta-Tags
+- `jekyll-paginate` - Beitragspaginierung
+- `jekyll-sitemap` - Sitemap-Generierung
+- `liquid_reading_time` - Schätzung der Lesezeit
+- `jekyll_picture_tag` - Responsive Bilder
+
+**Benutzerdefinierte Plugins:**
+- `llms_txt_generator` - Generiert automatisch llms.txt-Dateien für jeden Blogbeitrag und erstellt KI-freundliche Inhaltszusammenfassungen
+- `auto_related_posts` - Intelligentes Beitragsempfehlungssystem basierend auf Kategorien, Tags und Inhaltsähnlichkeit mit TF-IDF-ähnlichem Algorithmus
+- `category_generator` - Erstellt automatisch dedizierte Seiten für jede Kategorie mit gefilterten Beitragsauflistungen
+- `localized_date` - Liquid-Filter zur Formatierung von Daten entsprechend der ausgewählten Sprache (z.B. "15 January 2025" auf Englisch, "15 gennaio 2025" auf Italienisch, "15 Januar 2025" auf Deutsch)
+
+### Anpassung
+
+#### Farben und Stile
+
+Bearbeiten Sie `css/style.css`, um Farben, Schriftarten und Stile anzupassen.
+
+#### Social Links
+
+Konfigurieren Sie Social Links in `_config.yml` unter `contact.links`. Unterstützte Typen:
+- email, linkedin, bluesky, twitter, github, instagram, facebook
+- youtube, mastodon, telegram, whatsapp, medium, reddit
+- discord, tiktok, twitch, slack
+
+## Dokumentation
+
+Ausführliche Dokumentation ist in den folgenden Dateien verfügbar:
+
+- [I18N.md](docs/I18N.md) - Internationalisierungssystem und Sprachunterstützung
+- [ACCESSIBILITY.md](docs/ACCESSIBILITY.md) - Barrierefreiheitsfunktionen und Tests
+- [SEARCH.md](docs/SEARCH.md) - Suchfunktionalität
+- [READING_PROGRESS.md](docs/READING_PROGRESS.md) - Lesefortschrittsindikator
+- [STRUCTURED_DATA.md](docs/STRUCTURED_DATA.md) - SEO strukturierte Daten
+- [SOCIAL_SHARE.md](SOCIAL_SHARE.md) - Wie man Teilen in sozialen Medien hinzufügt (optional)
+- [COMMENTS.md](docs/COMMENTS.md) - Wie man Kommentare hinzufügt (optional)
+- [CHANGELOG.md](CHANGELOG.md) - Versionsverlauf
+- [PUBLISHING.md](PUBLISHING.md) - Anleitung zum Veröffentlichen Ihres Themes
+
+### In mehreren Sprachen verfügbar
+
+- 🇬🇧 [README.md](README.md) - Englisch
+- 🇮🇹 [README.it.md](README.it.md) - Italienisch
+- 🇩🇪 [README.de.md](README.de.md) - Deutsch
+- 🇫🇷 [README.fr.md](README.fr.md) - Französisch
+- 🇪🇸 [README.es.md](README.es.md) - Spanisch
+
+## Browserunterstützung
+
+- Chrome (neueste Version)
+- Firefox (neueste Version)
+- Safari (neueste Version)
+- Edge (neueste Version)
+- Mobile-Browser (iOS Safari, Chrome Mobile)
+
+## Beiträge
+
+Beiträge sind willkommen! Bitte reichen Sie gerne einen Pull Request ein. Für größere Änderungen öffnen Sie bitte zuerst ein Issue, um zu besprechen, was Sie ändern möchten.
+
+1. Forken Sie das Repository
+2. Erstellen Sie Ihren Feature-Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit Ihre Änderungen (`git commit -m 'Add some AmazingFeature'`)
+4. Pushen Sie zum Branch (`git push origin feature/AmazingFeature`)
+5. Öffnen Sie einen Pull Request
+
+## Support
+
+Wenn Sie auf Probleme stoßen oder Fragen haben:
+
+- Öffnen Sie ein Issue auf [GitHub](https://github.com/amargiovanni/sexyjekyll-theme/issues)
+- Überprüfen Sie die [Dokumentation](https://github.com/amargiovanni/sexyjekyll-theme#readme)
+
+## Lizenz
+
+Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die [LICENSE](LICENSE)-Datei für Details.
+
+## Mitwirkende
+
+Erstellt von [Andrea Margiovanni](https://margiovanni.it)
+
+## Danksagungen
+
+- Gebaut mit [Jekyll](https://jekyllrb.com/)
+- Syntax-Hervorhebung von [Rouge](https://github.com/rouge-ruby/rouge)
+- Symbole und Design-Inspiration von modernen Web-Design-Trends
+
+---
+
+Wenn Sie dieses Theme nützlich finden, ziehen Sie bitte in Betracht, ihm einen Stern auf GitHub zu geben!

data/README.es.md

@@ -0,0 +1,276 @@
+# Tema SexyJekyll
+
+Un tema Jekyll moderno y rico en características diseñado para blogs profesionales y sitios web personales. Construido teniendo en cuenta la accesibilidad, el rendimiento y la experiencia del usuario.
+
+![Tema SexyJekyll](screenshot.png)
+
+## Características
+
+### Diseño y Experiencia de Usuario
+- **Diseño Moderno**: Estética limpia y minimalista
+- **Totalmente Responsivo**: Diseño mobile-first que funciona en todos los dispositivos
+- **Progreso de Lectura**: Indicador visual que muestra el progreso de lectura del artículo
+- **Estilos de Impresión**: Diseños optimizados para imprimir
+
+### Contenido y Navegación
+- **Búsqueda Avanzada**: Búsqueda instantánea del lado del cliente con resaltado de palabras clave
+- **Publicaciones Relacionadas**: Recomendaciones inteligentes de posts basadas en categorías y etiquetas
+- **Categorías**: Filtrado y organización basados en categorías
+- **Paginación**: Paginación de posts personalizable
+
+### SEO y Redes Sociales
+- **Optimizado para SEO**: Meta etiquetas, Open Graph, Twitter Cards
+- **Datos Estructurados**: esquema JSON-LD para mejor comprensión de motores de búsqueda
+- **Feed RSS**: Generación automática de feed
+- **Sitemap**: Sitemap generado automáticamente para motores de búsqueda
+
+### Accesibilidad
+- **WCAG 2.1 Nivel AA**: Soporte de accesibilidad integral
+- **Saltar al Contenido**: Ayudas de navegación por teclado
+- **HTML Semántico**: Puntos de referencia HTML5 adecuados y estructura
+- **Etiquetas ARIA**: Amigable con lectores de pantalla
+- **Movimiento Reducido**: Respeta las preferencias de movimiento del usuario
+- **Alto Contraste**: Excelentes relaciones de contraste de color
+
+### Rendimiento
+- **Imágenes Responsivas**: Formato WebP con múltiples tamaños
+- **Carga Perezosa**: Las imágenes se cargan según sea necesario
+- **CSS/JS Optimizados**: Código minificado y eficiente
+- **Tiempos de Carga Rápidos**: Optimizado para rendimiento
+
+### Características para Desarrolladores
+- **Resaltado de Sintaxis**: Bloques de código con números de línea (Rouge)
+- **Tiempo de Lectura**: Estimación automática del tiempo de lectura
+- **Multiidioma**: Sistema completo de i18n que admite inglés, italiano, alemán, francés y español
+- **Personalizable**: Fácil configuración a través de `_config.yml`
+- **Bien Documentado**: Documentación completa incluida
+
+### Características de IA y LLM
+- **Soporte llms.txt**: Generación automática de resúmenes de contenido amigables con IA
+- **llms.txt por Post**: Cada publicación de blog genera su propio archivo llms.txt dedicado en `/blog/YYYY/MM/DD/post-slug/llms.txt`
+- **llms.txt a Nivel de Sitio**: Archivo llms.txt principal en la raíz con descripción general del sitio y estructura de contenido
+- **Contenido Estructurado**: Marcado HTML5 limpio y semántico optimizado para rastreadores de IA
+- **esquema JSON-LD**: Datos estructurados enriquecidos para mejor comprensión del contenido
+- **Amigable con Rastreadores de IA**: Enfoque acogedor para la indexación de IA con instrucciones claras
+
+## Instalación
+
+### Como una Gema de Ruby (Recomendado)
+
+Añade esta línea al `Gemfile` de tu sitio Jekyll:
+
+```ruby
+gem "sexyjekyll-theme"
+```
+
+Y añade esta línea al `_config.yml` de tu sitio Jekyll:
+
+```yaml
+theme: sexyjekyll-theme
+```
+
+Luego ejecuta:
+
+```bash
+bundle install
+```
+
+### Tema Remoto (GitHub Pages)
+
+Si estás usando GitHub Pages, añade esto a tu `_config.yml`:
+
+```yaml
+remote_theme: amargiovanni/sexyjekyll-theme
+```
+
+### Instalación Manual
+
+1. Descarga o clona este repositorio
+2. Copia los archivos a tu sitio Jekyll
+3. Actualiza tu `_config.yml` con la configuración del tema
+
+## Inicio Rápido
+
+1. **Instala el tema** usando uno de los métodos anteriores
+
+2. **Configura** tu `_config.yml`:
+
+```yaml
+# Configuración del sitio
+title: Tu Nombre
+email: tu.email@ejemplo.com
+description: Descripción de tu sitio
+baseurl: ""
+url: "https://tusitio.com"
+lang: es  # Opciones: en, it, de, fr, es
+
+# Información del autor
+author:
+  name: Tu Nombre
+  email: tu.email@ejemplo.com
+  linkedin: https://www.linkedin.com/in/tuperfil/
+  bluesky: https://bsky.app/profile/tumanejo
+
+# Logo de navegación
+nav_logo:
+  type: text  # 'text' o 'image'
+  text: TN    # Tus iniciales o texto
+  # image: /assets/img/logo.png  # O ruta a la imagen del logo
+  # alt: Tu Logo
+
+# Sección hero
+hero:
+  name: Tu Nombre
+  role: Tu Rol
+  subtitle: Tu Empresa o Eslogan
+  tagline: Tu eslogan personal
+  description: Una breve descripción sobre ti
+
+# Sección blog
+blog:
+  title: Blog
+  description: Descripción de tu blog
+
+# Sección de contacto
+contact:
+  title: Ponte en Contacto
+  description: Descripción de la página de contacto
+  links:
+    - name: Email
+      url: mailto:tu.email@ejemplo.com
+      type: email
+    - name: LinkedIn
+      url: https://www.linkedin.com/in/tuperfil/
+      type: linkedin
+```
+
+3. **Crea tu primer post** en `_posts/`:
+
+```markdown
+---
+layout: post
+title: "Tu Primer Post"
+subtitle: "Subtítulo opcional"
+date: 2025-11-01
+categories: blog tech
+---
+
+El contenido de tu post aquí...
+```
+
+4. **Ejecuta Jekyll**:
+
+```bash
+bundle exec jekyll serve
+```
+
+¡Visita `http://localhost:4000` para ver tu sitio!
+
+## Configuración
+
+### Diseños Disponibles
+
+- `default` - Diseño base para todas las páginas
+- `home` - Página de inicio con sección hero
+- `blog` - Página de listado de blog
+- `post` - Post individual del blog
+- `about` - Página acerca de
+- `contact` - Página de contacto con enlaces sociales
+- `category` - Listado de posts específico de categoría
+- `404` - Página de error 404 personalizada
+
+### Plugins
+
+El tema utiliza estos plugins de Jekyll:
+
+**Plugins Estándar:**
+- `jekyll-feed` - Generación de feed RSS
+- `jekyll-seo-tag` - Meta etiquetas SEO
+- `jekyll-paginate` - Paginación de posts
+- `jekyll-sitemap` - Generación de sitemap
+- `liquid_reading_time` - Estimación del tiempo de lectura
+- `jekyll_picture_tag` - Imágenes responsivas
+
+**Plugins Personalizados:**
+- `llms_txt_generator` - Genera automáticamente archivos llms.txt para cada post de blog y crea resúmenes de contenido amigables con IA
+- `auto_related_posts` - Sistema inteligente de recomendación de posts basado en categorías, etiquetas y similitud de contenido usando algoritmo similar a TF-IDF
+- `category_generator` - Crea automáticamente páginas dedicadas para cada categoría con listados de posts filtrados
+- `localized_date` - Filtro Liquid para formatear fechas según el idioma seleccionado (por ejemplo, "15 January 2025" en inglés, "15 gennaio 2025" en italiano, "15 enero 2025" en español)
+
+### Personalización
+
+#### Colores y Estilos
+
+Edita `css/style.css` para personalizar colores, fuentes y estilos.
+
+#### Enlaces Sociales
+
+Configura los enlaces sociales en `_config.yml` bajo `contact.links`. Tipos soportados:
+- email, linkedin, bluesky, twitter, github, instagram, facebook
+- youtube, mastodon, telegram, whatsapp, medium, reddit
+- discord, tiktok, twitch, slack
+
+## Documentación
+
+La documentación detallada está disponible en los siguientes archivos:
+
+- [I18N.md](docs/I18N.md) - Sistema de internacionalización y soporte de idiomas
+- [ACCESSIBILITY.md](docs/ACCESSIBILITY.md) - Características de accesibilidad y pruebas
+- [SEARCH.md](docs/SEARCH.md) - Funcionalidad de búsqueda
+- [READING_PROGRESS.md](docs/READING_PROGRESS.md) - Indicador de progreso de lectura
+- [STRUCTURED_DATA.md](docs/STRUCTURED_DATA.md) - Datos estructurados SEO
+- [SOCIAL_SHARE.md](SOCIAL_SHARE.md) - Cómo agregar compartición en redes sociales (opcional)
+- [COMMENTS.md](docs/COMMENTS.md) - Cómo agregar comentarios (opcional)
+- [CHANGELOG.md](CHANGELOG.md) - Historial de versiones
+- [PUBLISHING.md](PUBLISHING.md) - Guía para publicar tu tema
+
+### Disponible en Múltiples Idiomas
+
+- 🇬🇧 [README.md](README.md) - Inglés
+- 🇮🇹 [README.it.md](README.it.md) - Italiano
+- 🇩🇪 [README.de.md](README.de.md) - Alemán
+- 🇫🇷 [README.fr.md](README.fr.md) - Francés
+- 🇪🇸 [README.es.md](README.es.md) - Español
+
+## Compatibilidad de Navegadores
+
+- Chrome (última versión)
+- Firefox (última versión)
+- Safari (última versión)
+- Edge (última versión)
+- Navegadores móviles (iOS Safari, Chrome Mobile)
+
+## Contribuciones
+
+¡Las contribuciones son bienvenidas! Siéntete libre de enviar un Pull Request. Para cambios mayores, abre un issue primero para discutir qué te gustaría cambiar.
+
+1. Fork el repositorio
+2. Crea tu rama de feature (`git checkout -b feature/CaracterísticaIncreíble`)
+3. Commit tus cambios (`git commit -m 'Añade CaracterísticaIncreíble'`)
+4. Push a la rama (`git push origin feature/CaracterísticaIncreíble`)
+5. Abre un Pull Request
+
+## Soporte
+
+Si encuentras algún problema o tienes preguntas:
+
+- Abre un issue en [GitHub](https://github.com/amargiovanni/sexyjekyll-theme/issues)
+- Revisa la [documentación](https://github.com/amargiovanni/sexyjekyll-theme#readme)
+
+## Licencia
+
+Este proyecto está licenciado bajo la Licencia MIT - ver el archivo [LICENSE](LICENSE) para detalles.
+
+## Créditos
+
+Creado por [Andrea Margiovanni](https://margiovanni.it)
+
+## Agradecimientos
+
+- Construido con [Jekyll](https://jekyllrb.com/)
+- Resaltado de sintaxis por [Rouge](https://github.com/rouge-ruby/rouge)
+- Iconos e inspiración de diseño de tendencias modernas de diseño web
+
+---
+
+¡Si encuentras este tema útil, considera darle una estrella en GitHub!