diff --git a/src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-31.mdx b/src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-31.mdx new file mode 100644 index 00000000..40c20e38 --- /dev/null +++ b/src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-31.mdx @@ -0,0 +1,161 @@ +--- +i18nReady: true +title: "Actualización: 0.1.0-beta.31" +description: Actualización de StudioCMS a Beta.31 +topic: guides +sidebar: + label: 0.1.0-beta.31 + order: 999984 +--- + +import ReadMore from '~/components/ReadMore.astro' +import { PackageManagers } from 'starlight-package-managers' +import { FileTree, TabItem, Tabs, Steps, Aside } from '@astrojs/starlight/components'; + +StudioCMS `0.1.0-beta.31` introduce cambios significativos, incluyendo una nueva capa de base de datos basada en Kysely, un sistema de plugins renovado y varias nuevas características y mejoras. Esta guía te ayudará a actualizar tu proyecto existente de StudioCMS a la última versión. + +## Cambios importantes +- Sistema de plugins refactorizado. Consulta la [documentación de plugins](/es/plugins/) para más detalles. +- Implementada nueva capa de base de datos basada en Kysely. +- Eliminado el soporte para opciones de configuración pasadas directamente a la integración de Astro de StudioCMS, ahora todas las opciones de configuración deben definirse en el archivo `studiocms.config.mjs`. Consulta la [Referencia de Configuración](/es/start-here/configuration/) para más detalles. + +## Nuevas funcionalidades +- Implementado nuevo comando [`studiocms migrate`](/es/how-it-works/cli/#migrate) para manejar las migraciones de base de datos. +- Permitir deshabilitar las etiquetas meta del generador mediante la opción de configuración [`features.dashboard.security.hideGeneratorTags`](/es/config-reference/features/#hidegeneratortags). +- StudioCMS ahora soporta diferentes dialectos de base de datos mediante [Kysely](https://kysely.dev/). +- Introducida nueva middleware para mostrar errores del sistema en páginas con errores en lugar de hacer que todo el sitio se bloquee. +- Nuevas características de plugins: + - Inyección dinámica de componentes y scripts en el panel de control a través de nuevos hooks de plugins. + - Nuevos ayudantes de base de datos para facilitar el acceso a la base de datos dentro de los plugins. +- Introducida nueva página del panel de control para gestionar el sistema. + - Incluye un panel de información del sistema (debug). + - Proporciona acceso rápido a tus tablas de base de datos mientras estás en producción. +- Agregada la nueva aplicación de barra de herramientas de desarrollador integrada en StudioCMS para ver y gestionar tu base de datos mientras estás en modo de desarrollo. +- Integrada rastreo web-vitals/analytics opcional al panel de control para obtener mejores insights de rendimiento. + - Esto puede activarse mediante la opción de configuración [`features.webVitals`](/es/config-reference/features/#webvitals). + - Para quienes anteriormente usaban las integraciones `@studiocms/web-vitals` o `@astrojs/web-vitals`, esto ahora está integrado y puede configurarse mediante la configuración de StudioCMS. +- Agregado nuevo comando CLI [`studiocms debug`](/es/how-it-works/cli/#debug) para acceder rápidamente a información útil de depuración sobre tu proyecto StudioCMS. + +## Correcciones de errores y mejoras +- Actualizada la URL de la imagen del usuario fantasma. +- Refactorizada la generación de `urlRoute` de los datos de la página para resolver correctamente. +- Refactorizados y simplificados los componentes de diseño del panel de control. +- Mejorados los tipos de configuración de StudioCMS y los comentarios de JSDoc. +- Refactorizados los comandos CLI para usar la nueva capa de base de datos. +- Introducidas nuevas utilidades de depuración para facilitar el acceso a información útil de depuración. + +## Instrucciones para la migración + +Para actualizar tu proyecto StudioCMS a la versión `0.1.0-beta.31`, sigue estos pasos: + + + +1. **Actualiza tus dependencias de StudioCMS** a la última versión: + + +2. **Si tienes plugins personalizados**, asegúrate de que estén actualizados para ser compatibles con el nuevo sistema de plugins. Consulta la [documentación de plugins](/es/plugins/) para obtener orientación. + +3. **Revisa tu archivo `studiocms.config.mjs`** para asegurarte de que todas las opciones de configuración estén correctamente establecidas según el nuevo esquema. Consulta la [Referencia de Configuración](/es/start-here/configuration/) para obtener detalles. + + - **¿Anteriormente usaste las integraciones `@studiocms/web-vitals` o `@astrojs/web-vitals`?** Elimínalas de las dependencias de tu proyecto y configura el rastreo web vitals integrado a través de la opción `features.webVitals` en tu archivo `studiocms.config.mjs`: + ```ts {3} title="studiocms.config.mjs" + export default defineStudioCMSConfig({ + features: { + webVitals: true, + }, + }); + ``` + +4. **Configura una nueva conexión de base de datos para la nueva capa de base de datos basada en Kysely.** Actualiza tu archivo `.env` con los detalles de conexión de base de datos necesarios. Mantén tu base de datos anterior intacta para la migración. + + Ir a [Prepara tu base de datos](/es/start-here/getting-started/#prepara-tu-base-de-datos) para más información sobre configurar tu base de datos. + Ir a [Variables de entorno](/es/start-here/environment-variables/) para más información sobre configurar tus variables de entorno. + +5. **Configura tu dialecto de base de datos en `studiocms.config.mjs` bajo la opción `db`. Por ejemplo, para usar libSQL:** + + ```ts {3} title="studiocms.config.mjs" + export default defineStudioCMSConfig({ + db: { + dialect: 'libsql', // o 'postgresql', 'mysql' + }, + }); + ``` + + + +6. **Instala los paquetes de clientes de base de datos necesarios** para tu lenguaje de base de datos elegido: + + + + + + + + + + + + + + + + + +7. **Descarga la herramienta de migración en la raíz de tu proyecto StudioCMS:** + + + + Esta herramienta leerá tu `studiocms.config.mjs` para hacer posible la conexión con el correspondiente lenguaje de tu base de datos. + +8. **Ejecución de esquema de migración:** + + Dado que la capa de base de datos ha cambiado, deberás ejecutar migraciones para actualizar el esquema de tu base de datos y que sea compatible con la nueva versión. Hay dos formas de hacerlo: + + + + + Integrado en la CLI de StudioCMS hay un nuevo comando `migrate` que ejecutará las migraciones necesarias por ti. Para usarlo, ejecuta el siguiente comando en el directorio de tu proyecto: + + + + Se te pedirá que selecciones una opción para migrar el esquema de tu base de datos a la última versión, retroceder a una versión anterior o ver el estado actual de la migración. Selecciona « Migrate to Latest » (Migrar a la última versión) para actualizar el esquema de tu base de datos. + + + + + + + Alternativamente, puedes usar la herramienta de migración que instalaste en el paso anterior. Para hacer esto, continúa con el siguiente paso y utiliza la interfaz web para ejecutar las migraciones. + + + + +9. **Ejecutar la interfaz web de la herramienta de migración:** + + Inicia la herramienta de migración ejecutando el siguiente comando en el directorio de tu proyecto: + + + + Esto iniciará un servidor web local. Abre tu navegador y navega a `http://localhost:4321` para acceder a la interfaz de la herramienta de migración. + + Esta interfaz te dará opciones para migrar el esquema de tu base de datos, así como para migrar tus datos desde tu base de datos anterior a la nueva. + +10. Una vez que la migración esté completa, **inicia tu proyecto de StudioCMS** como de costumbre: + + + + Tu proyecto debería estar funcionando ahora con el esquema de base de datos y configuración actualizados. + + +## Notas finales + +- Asegúrate de tener copias de seguridad de tu base de datos antes de realizar migraciones. +- Prueba tu aplicación a fondo después de la migración para detectar cualquier problema temprano. +- Consulta la [documentación de StudioCMS](/es/start-here/getting-started/) para obtener más información sobre nuevas funciones y cambios. +- Si encuentras algún problema durante el proceso de migración, comunícate con nuestra [comunidad de Discord](https://chat.studiocms.dev) o abre un issue en nuestro [repositorio de GitHub](https://github.com/withstudiocms/studiocms/issues). \ No newline at end of file diff --git a/src/content/docs/es/guides/upgrade/version-guides/0-1-0.mdx b/src/content/docs/es/guides/upgrade/version-guides/0-1-0.mdx new file mode 100644 index 00000000..3497dc23 --- /dev/null +++ b/src/content/docs/es/guides/upgrade/version-guides/0-1-0.mdx @@ -0,0 +1,57 @@ +--- +i18nReady: true +title: "Actualización: v0.1.0" +description: Actualización de StudioCMS a v0.1.0 +topic: guides +sidebar: + label: v0.1.0 + order: 999983 +--- + +import ReadMore from '~/components/ReadMore.astro' +import { PackageManagers } from 'starlight-package-managers' +import { FileTree, TabItem, Tabs, Steps, Aside } from '@astrojs/starlight/components'; + +StudioCMS `0.1.0` introduce muchos cambios importantes, nuevas funcionalidades y arreglos de errores. Esta guía te ayudará a navegar el proceso de actualización sin problemas. + +## Cambios importantes +- Reemplazado `@libsql/kysely-libsql` con `kysely-turso` para el cliente de base de datos Turso. Si estabas usando `@libsql/kysely-libsql` en tu proyecto, por favor actualiza tus dependencias para usar `kysely-turso` en su lugar. + - **Pasos para migrar:** + + 1. Elimina `@libsql/kysely-libsql` de tus dependencias en `package.json`. + + + + 2. Instala `kysely-turso` ejecutando: + + + +- Elimina la variable de configuración del sitio obsoleta `hideDefaultIndex` del SDK y actualiza todas las instancias de uso en StudioCMS. + - Nota para cualquiera que anteriormente dependiera de esta función, ahora ha sido completamente eliminada. Los usuarios deberán ajustar cualquier código que dependa de esta funcionalidad. +- Migra las importaciones de tablas al nuevo export `@withstudiocms/sdk/tables`, y actualiza las importaciones relevantes. +- Migra el sistema de migración al SDK de StudioCMS y actualiza las importaciones para Migrator a `@withstudiocms/sdk/migrator`. + +## Nuevas funcionalidades +- Agregada nueva API de almacenamiento para archivos y activos de StudioCMS. + - Esta nueva API proporciona una forma estandarizada de gestionar archivos y activos dentro de StudioCMS, permitiendo una mejor integración con varios backends de almacenamiento. + - Consulta la [Documentación de la API de Almacenamiento](/es/storage-api/) para obtener más detalles sobre cómo usar la nueva API de Almacenamiento en tus proyectos. +- Implementa un nuevo sistema de renderizado FolderTree y actualiza la barra lateral interna de gestión de contenido +- Implementa la gestión de taxonomías en el panel de control de StudioCMS + - Agrega soporte de taxonomía para REST API y SDK + - Agrega UI de gestión de taxonomía en el panel de control de StudioCMS +- Implementa nueva UI de registro de componentes para páginas de edición de contenido y gestión del sistema. +- Arregla el problema con la información de depuración que tenía salidas no disponibles durante PROD + +## Reparación de errores y mejoras +- Reestructura los tipos de tablas para alinearlos mejor con los esquemas de tablas reales y mejorar la seguridad de tipos en todo el SDK. +- Mejora el manejo de errores y el registro para las operaciones de base de datos para ayudar en la depuración y el mantenimiento. +- Arregla varios problemas de CSS en todas las páginas del panel de control y de autenticación. +- Asegura que el elemento personalizado DB Studio esté definido si no está presente la barra de herramientas de desarrollo +- Reestructura la CLI para corregir el manejo de código asíncrono/síncrono para el comando `studiocms users` +- Reemplaza todas las instancias de `.returning()`/`returningAll()` con transacciones para soportar adecuadamente los dialectos SQL que no soportan retornar como MySQL + +**Lectura adicional** + + + Para una lista completa de cambios en esta versión, por favor consulta el [Changelog](/es/guides/upgrade/release-notes/#010-beta32). + \ No newline at end of file diff --git a/src/content/docs/es/guides/upgrade/version-guides/0-2-0.mdx b/src/content/docs/es/guides/upgrade/version-guides/0-2-0.mdx new file mode 100644 index 00000000..ecb63362 --- /dev/null +++ b/src/content/docs/es/guides/upgrade/version-guides/0-2-0.mdx @@ -0,0 +1,25 @@ +--- +i18nReady: true +title: "Actualización: v0.2.0" +description: Actualización StudioCMS a v0.2.0 +topic: guides +sidebar: + label: v0.2.0 + order: 999982 +--- + +import QuickUpdate from '~/components/QuickUpdate.astro' + + + +## Cambios importantes + +Ninguno. Esta es una versión sin cambios importantes. + +## Reparación de errores y mejoras + +- Migración al paquete cli-kit actualizado para mejorar la funcionalidad de la CLI. +- Agregada expresión regular y manejo de errores adecuado para evitar que se usen caracteres ilegales (no seguros para URL) para objetos S3. +- Se corrigió un problema donde guardar una página que no tiene `draft` establecido en `true`, anteriormente actualizaba el valor de la fecha `publishedAt`. +- Se reestructuraron las verificaciones de permisos para las rutas del panel de control a nivel de middleware para evitar el acceso no autorizado. +- Se actualizaron varias dependencias a sus últimas versiones para garantizar la seguridad y estabilidad. \ No newline at end of file diff --git a/src/content/docs/es/guides/upgrade/version-guides/0-3-0.mdx b/src/content/docs/es/guides/upgrade/version-guides/0-3-0.mdx new file mode 100644 index 00000000..55be7a0b --- /dev/null +++ b/src/content/docs/es/guides/upgrade/version-guides/0-3-0.mdx @@ -0,0 +1,32 @@ +--- +i18nReady: true +title: "Actualización: v0.3.0" +description: Actualización StudioCMS a v0.3.0 +topic: guides +sidebar: + label: v0.3.0 + badge: + text: NEW + variant: success + order: 999981 +--- + +import QuickUpdate from '~/components/QuickUpdate.astro' + + + +## Cambios importantes + +- Elimina los siguientes módulos virtuales obsoletos y no utilizados. + - `studiocms:astro-config/adapter` + - `studiocms:auth/utils/getLabelForPermissionLevel` + - `virtual:studiocms/sdk/env` + +## Reparación de errores y mejoras + +- Reemplaza `chalk` con `styleText` de `node:util` para StudioCMS CLI. +- Actualiza las dependencias de StudioCMS. +- Corrige el problema con `pg` y `mysql2` que requerían ser instalados cuando deberían ser opcionales. +- Corrige la expresión regular del cliente en el frontend para permitir barras dentro de un slug, pero no fuera de este. Esto desbloquea la creación de páginas bajo sub-rutas usando solo el slug (por ejemplo, `docs/getting-started`) y solo afecta la validación del lado del cliente. +- Elimina el código de verificación de dominio de correo electrónico heredado. +- Corrige la renderización de la ruta 404 predeterminada. \ No newline at end of file