From bd4dc5a17faa46f800b1656f21e0896221f369f2 Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Sun, 30 Mar 2025 15:26:50 -0600 Subject: [PATCH 1/2] i18n(es): update multiple files pt. 2 --- src/content/docs/es/contributing/getting-started.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/content/docs/es/contributing/getting-started.mdx b/src/content/docs/es/contributing/getting-started.mdx index a1dc43c8..9c1ee5a2 100644 --- a/src/content/docs/es/contributing/getting-started.mdx +++ b/src/content/docs/es/contributing/getting-started.mdx @@ -11,7 +11,7 @@ import ContributorList from '~/components/ContributorList.astro'; Lee nuestro [Código de Conducta](https://github.com/withstudiocms/studiocms?tab=coc-ov-file#code-of-conduct-) para mantener nuestra comunidad accesible y respetable. -¡Damos la bienvenida a las contribuciones de la comunidad! Ya sean reportes de errores, solicitudes de funcionalidades o contribuciones de código, agradecemos tu ayuda para mejorar este proyecto. Para navegar por nuestro código base con confianza, consulta la sección [Cómo funciona](/es/how-it-works/). +¡Damos la bienvenida a las contribuciones de la comunidad! Ya sean reportes de errores, solicitudes de funcionalidades o contribuciones de código, agradecemos tu ayuda para mejorar este proyecto. Para navegar por nuestro código base con confianza, consulta la sección [Cómo funciona][how-it-works]. ## Nuestros contribuyentes @@ -23,3 +23,5 @@ Nuestro proyecto existe gracias a todas las personas que contribuyen. [Únete a Si encuentras un error o deseas sugerir una nueva funcionalidad, por favor abre un issue en nuestro [repositorio de GitHub](https://github.com/withstudiocms/studiocms). Al crear un nuevo issue, proporciona tantos detalles como sea posible, incluyendo los pasos para reproducir el problema (para errores) y una descripción clara de la funcionalidad propuesta. +{/* Enlaces */} +[how-it-works]: /es/how-it-works/ \ No newline at end of file From d4416e403bd7480e480eedfbf4a5d04b601ba569 Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Sun, 30 Mar 2025 17:18:09 -0600 Subject: [PATCH 2/2] i18n(es): update documentation for REST API, Web Vitals, and plugins --- src/content/docs/es/how-it-works/restapi.mdx | 1 + .../community-plugins/web-vitals.mdx | 1 + src/content/docs/es/package-catalog/index.mdx | 2 +- .../studiocms-plugins/studiocms-blog.mdx | 2 +- src/content/docs/es/plugins/index.mdx | 74 ++++++++++++++++--- 5 files changed, 69 insertions(+), 11 deletions(-) diff --git a/src/content/docs/es/how-it-works/restapi.mdx b/src/content/docs/es/how-it-works/restapi.mdx index 2bca955a..70e05a67 100644 --- a/src/content/docs/es/how-it-works/restapi.mdx +++ b/src/content/docs/es/how-it-works/restapi.mdx @@ -40,3 +40,4 @@ Estos endpoints son accesibles al público y no requieren autenticación. Propor - **`/studiocms_api/rest/v1/settings/`**: Proporciona la configuración de StudioCMS para el proyecto actual. - **`/studiocms_api/rest/v1/users/`**: Proporciona una lista de todos los usuarios en el proyecto StudioCMS. - **`/studiocms_api/rest/v1/users/[id]`**: Proporciona detalles de un usuario específico en el proyecto StudioCMS. + diff --git a/src/content/docs/es/package-catalog/community-plugins/web-vitals.mdx b/src/content/docs/es/package-catalog/community-plugins/web-vitals.mdx index 476e312b..5b8f1818 100644 --- a/src/content/docs/es/package-catalog/community-plugins/web-vitals.mdx +++ b/src/content/docs/es/package-catalog/community-plugins/web-vitals.mdx @@ -76,3 +76,4 @@ Esta integración de Astro permite el seguimiento del rendimiento del sitio web {/* ## Galería de Demostración */} + diff --git a/src/content/docs/es/package-catalog/index.mdx b/src/content/docs/es/package-catalog/index.mdx index 1a773ba4..2cc567bc 100644 --- a/src/content/docs/es/package-catalog/index.mdx +++ b/src/content/docs/es/package-catalog/index.mdx @@ -23,4 +23,4 @@ Cualquier paquete etiquetado como ### Paquetes de la Comunidad --- - \ No newline at end of file + diff --git a/src/content/docs/es/package-catalog/studiocms-plugins/studiocms-blog.mdx b/src/content/docs/es/package-catalog/studiocms-plugins/studiocms-blog.mdx index 2757d791..013f3438 100644 --- a/src/content/docs/es/package-catalog/studiocms-plugins/studiocms-blog.mdx +++ b/src/content/docs/es/package-catalog/studiocms-plugins/studiocms-blog.mdx @@ -25,7 +25,7 @@ Este plugin habilita las características del Blog de StudioCMS así como un fro 2. Añade `@studiocms/blog` a tu archivo de configuración de Astro: - ```ts title="studiocms.config.mjs" ins={2, 6} + ```ts twoslash title="studiocms.config.mjs" ins={2, 6} import { defineStudioCMSConfig } from 'studiocms/config'; import blog from '@studiocms/blog'; diff --git a/src/content/docs/es/plugins/index.mdx b/src/content/docs/es/plugins/index.mdx index 1b6d01b5..0a3264d9 100644 --- a/src/content/docs/es/plugins/index.mdx +++ b/src/content/docs/es/plugins/index.mdx @@ -139,14 +139,20 @@ type StudioCMSPlugin = { */ fields: SettingsField[]; - /** - * Función que se ejecuta cuando se guarda la página de configuración - * - * Debe devolver una cadena si hay un error, - * de lo contrario devuelve true booleano para indicar éxito - */ - onSave: APIRoute; + /** + * El endpoint para la configuración + * + * Debería exportar un APIRoute llamado `onSave` que se ejecute cuando se guarde la página de configuración + */ + endpoint: string, } | undefined; + /** + * Enlaces de navegación para usar con el complemento `@studiocms/blog` y otros complementos para mostrar enlaces en el frontend + */ + frontendNavigationLinks: Array<{ + label: string; + href: string; + }>; /** * Definición del tipo de página. Si está presente, el complemento quiere poder modificar el proceso de creación de páginas @@ -183,6 +189,8 @@ type StudioCMSPlugin = { * El componente debe tener una prop `content` que sea una cadena para poder mostrar el contenido actual. * * **NOTA:** Actualmente, requiere que uses el id de formulario `page-content` para la salida de contenido. Tu editor también debe poder manejar el envío de formularios. + * + * **NOTA:** ¡Puedes usar `studiocms/markdown` o `studiocms/html` como valor de reserva si estás trabajando con contenido html o markdown! * * @example * ```ts @@ -194,7 +202,51 @@ type StudioCMSPlugin = { * } * ``` */ - pageContentComponent: string; + pageContentComponent: 'studiocms/markdown' | 'studiocms/html' | string; + + /** + * La ruta al componente real que se muestra para el renderizador de la página + * + * **NOTA:** ¡Puedes usar `studiocms/markdown` o `studiocms/html` como valor de reserva si estás trabajando con contenido html o markdown! + */ + rendererComponent: 'studiocms/markdown' | 'studiocms/html' | string; + + /** + * Campos según la especificación + */ + fields: SettingsField[]; + + /** + * Endpoint de API para el tipo de página + * + * Los endpoints de API se utilizan para crear, editar y eliminar páginas de este tipo, + * los endpoints serán proporcionados el contexto completo de la API de Astro desde el APIRoute de Astro. + * + * El archivo debe exportar al menos uno de los siguientes: + * - `onCreate` + * - `onEdit` + * - `onDelete` + * + * @example + * ```ts + * // my-plugin.ts + * import { createResolver } from 'astro-integration-kit'; + * const { resolve } = createResolver(import.meta.url) + * + * { + * apiEndpoint: resolve('./api/pageTypeApi.ts'), + * } + * + * // api/pageTypeApi.ts + * import { APIRoute } from 'astro'; + * + * export const onCreate: APIRoute = async (ctx) => { + * // Lógica personalizada aquí + * return new Response(); + * } + * ``` + */ + apiEndpoint: string; }> | undefined; }; ``` @@ -239,4 +291,8 @@ export const myPlugin = (options: Options) => definePlugin({ En este ejemplo, definimos un complemento de StudioCMS llamado `My Plugin` que requiere la versión `0.1.0-beta.8` o superior de StudioCMS. El complemento también proporciona una Integración Astro que registra un mensaje en la consola cuando se llama al hook `astro:config:setup`. -Para más información sobre la creación de plugins, consulta la Guía [Haciendo Plugins Útiles](/es/plugins/extended) \ No newline at end of file +Para más información sobre la creación de plugins, consulta la Guía [Haciendo Plugins Útiles][reference-page] + +{/* Enlaces */} + +[reference-page]: /es/plugins/reference/ \ No newline at end of file