Merge pull request #12 from dallay/fix/docs-404-links-3929495371038838219

Author: yacosta738

docs/website/src/content/docs/en/404.mdx

@@ -11,7 +11,7 @@ hero:
       icon: right-arrow
       variant: primary
     - text: View Documentation
-      link: guides/getting-started/
+      link: ../guides/getting-started/
       icon: open-book
       variant: minimal
 ---

docs/website/src/content/docs/en/guides/getting-started.md

@@ -43,6 +43,6 @@ make test
 
 ## Next Steps
 
-- Explore the [Project Structure](./structure/) to understand how files are organized.
-- Check the [Features Checklist](./features/) for available functionalities.
-- Learn about standard [Development Procedures](./development/).
+- Explore the [Project Structure](../structure/) to understand how files are organized.
+- Check the [Features Checklist](../features/) for available functionalities.
+- Learn about standard [Development Procedures](../development/).

docs/website/src/content/docs/en/guides/release.md

@@ -8,7 +8,7 @@ This guide explains how to publish releases and snapshots to Maven Central using
 
 Before you can publish, ensure you have:
 
-1. **GPG Key configured**: Follow the [GPG Setup Guide](gpg-setup) to create and configure your signing key
+1. **GPG Key configured**: Follow the [GPG Setup Guide](../gpg-setup/) to create and configure your signing key
 2. **Maven Central access**: Repository secrets configured:
    - `SIGNING_IN_MEMORY_KEY`: Your GPG private key
    - `SIGNING_IN_MEMORY_KEY_PASSWORD`: GPG key passphrase
@@ -127,6 +127,6 @@ Use this checklist before publishing:
 
 ## See Also
 
-- [GPG Setup Guide](gpg-setup)
+- [GPG Setup Guide](../gpg-setup/)
 - [GitHub Workflows](https://github.com/dallay/starter-gradle/blob/main/.github/workflows/README.md)
 - [Contributing Guide](https://github.com/dallay/starter-gradle/blob/main/.github/CONTRIBUTING.md)

docs/website/src/content/docs/es/404.mdx

@@ -11,7 +11,7 @@ hero:
       icon: right-arrow
       variant: primary
     - text: Ver Documentación
-      link: guides/getting-started/
+      link: ../guides/getting-started/
       icon: open-book
       variant: minimal
 ---

docs/website/src/content/docs/es/guides/getting-started.md

@@ -48,6 +48,6 @@ make test
 
 ## Siguientes Pasos
 
-- Explora la [Estructura del Proyecto](./structure/) para entender cómo están organizados los archivos.
-- Consulta la [Lista de Funcionalidades](./features/) para conocer las capacidades disponibles.
-- Aprende sobre los [Procedimientos de Desarrollo](./development/) estándar.
+- Explora la [Estructura del Proyecto](../structure/) para entender cómo están organizados los archivos.
+- Consulta la [Lista de Funcionalidades](../features/) para conocer las capacidades disponibles.
+- Aprende sobre los [Procedimientos de Desarrollo](../development/) estándar.

docs/website/src/content/docs/es/guides/release.md

@@ -8,7 +8,7 @@ Esta guía explica cómo publicar releases y snapshots en Maven Central usando G
 
 Antes de poder publicar, asegúrate de tener:
 
-1. **Clave GPG configurada**: Sigue la [Guía de Configuración GPG](gpg-setup) para crear y configurar tu clave de firma
+1. **Clave GPG configurada**: Sigue la [Guía de Configuración GPG](../gpg-setup/) para crear y configurar tu clave de firma
 2. **Acceso a Maven Central**: Secrets del repositorio configurados:
    - `SIGNING_IN_MEMORY_KEY`: Tu clave privada GPG
    - `SIGNING_IN_MEMORY_KEY_PASSWORD`: Contraseña de la clave GPG
@@ -127,6 +127,6 @@ Usa este checklist antes de publicar:
 
 ## Ver También
 
-- [Guía de Configuración GPG](gpg-setup)
+- [Guía de Configuración GPG](../gpg-setup/)
 - [GitHub Workflows](https://github.com/dallay/starter-gradle/blob/main/.github/workflows/README.md)
 - [Guía de Contribución](https://github.com/dallay/starter-gradle/blob/main/.github/CONTRIBUTING.md)

docs/website/src/pages/404.astro

@@ -3,6 +3,7 @@ import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro'
 import { Icon } from '@astrojs/starlight/components'
 
 const baseUrl = import.meta.env.BASE_URL
+const normalizedBaseUrl = baseUrl.endsWith('/') ? baseUrl : baseUrl + '/'
 
 // Detect locale from pathname (e.g., /starter-gradle/es/...)
 const pathname = Astro.url.pathname
@@ -40,7 +41,7 @@ const labels = t[locale]
       <p class="tagline">{labels.tagline}</p>
 
       <div class="actions">
-        <a href={`${baseUrl}${locale}/`} class="primary-button">
+        <a href={`${normalizedBaseUrl}${locale}/`} class="primary-button">
           <Icon name="right-arrow" />
           <span>{labels.home}</span>
         </a>
@@ -51,11 +52,11 @@ const labels = t[locale]
       </div>
 
       <div class="links-grid">
-        <a href={`${baseUrl}${locale}/guides/getting-started/`} class="link-card">
+        <a href={`${normalizedBaseUrl}${locale}/guides/getting-started/`} class="link-card">
           <Icon name="rocket" />
           <span>{labels.gettingStarted}</span>
         </a>
-        <a href={`${baseUrl}${locale}/guides/structure/`} class="link-card">
+        <a href={`${normalizedBaseUrl}${locale}/guides/structure/`} class="link-card">
           <Icon name="puzzle" />
           <span>{labels.structure}</span>
         </a>