diff --git a/src/content/docs/fr/config-reference/features.mdx b/src/content/docs/fr/config-reference/features.mdx index e9c15345..c6c64e56 100644 --- a/src/content/docs/fr/config-reference/features.mdx +++ b/src/content/docs/fr/config-reference/features.mdx @@ -4,6 +4,9 @@ title: Fonctionnalités description: Page de référence pour les fonctionnalités de StudioCMS sidebar: order: 3 + badge: + text: Mis à jour + variant: success tableOfContents: minHeadingLevel: 2 maxHeadingLevel: 5 @@ -215,6 +218,47 @@ export default defineStudioCMSConfig({ }) ``` +### `security` + +`security` Permet la personnalisation de la configuration de sécurité + +#### Utilisation + +```ts twoslash {4} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + features: { + dashboardConfig: { + security: {} + } + } +}) +``` + +#### `hideGeneratorTags` + +`hideGeneratorTags` Permet d'activer ou de désactiver les balises méta `generator` dans le code HTML du tableau de bord. + +- **Type :** `boolean` +- **Par défaut :** `false` + +##### Utilisation + +```ts twoslash {5} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + features: { + dashboardConfig: { + security: { + hideGeneratorTags: false + } + } + } +}) +``` + ## `authConfig` `authConfig` permet la personnalisation de la configuration d'authentification @@ -330,7 +374,26 @@ import { defineStudioCMSConfig } from 'studiocms/config'; // ---cut--- export default defineStudioCMSConfig({ features: { - preferredImageService: undefined + preferredImageService: 'cloudinary-js' + } +}) +``` + +## `webVitals` + +`webVitals` Permet d'activer ou de désactiver le suivi des indicateurs de performance web + +- **Type :** `boolean` +- **Par défaut :** `false` + +### Usage + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + features: { + webVitals: true } }) ``` diff --git a/src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-30.mdx b/src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-30.mdx index 1e914ecc..bbb54b91 100644 --- a/src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-30.mdx +++ b/src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-30.mdx @@ -4,9 +4,6 @@ title: "Mise à niveau : 0.1.0-beta.30" description: Mettre à niveau StudioCMS vers la version Beta.30 sidebar: label: 0.1.0-beta.30 - badge: - text: NOUVEAU - variant: success order: 999985 --- diff --git a/src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-31.mdx b/src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-31.mdx new file mode 100644 index 00000000..d14730cf --- /dev/null +++ b/src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-31.mdx @@ -0,0 +1,165 @@ +--- +i18nReady: true +title: "Mise à niveau : 0.1.0-beta.31" +description: Mettre à niveau StudioCMS vers la version Beta.31 +topic: guides +sidebar: + label: 0.1.0-beta.31 + badge: + text: NOUVEAU + variant: success + 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` introduit des changements importants, notamment une nouvelle couche de base de données reposant sur Kysely, un système de modules d'extension remanié et diverses nouvelles fonctionnalités et améliorations. Ce guide vous aidera à mettre à niveau votre projet StudioCMS existant vers la dernière version. + +## Modifications avec rupture de compatibilité +- Système de modules d'extension remanié. Veuillez consulter la [documentation des modules d'extension](/fr/plugins/) pour plus de détails. +- Mise en place d'une nouvelle couche de base de données reposant sur Kysely. +- Suppression de la prise en charge des options de configuration transmises directement à l'intégration Astro de StudioCMS ; désormais, toutes les options de configuration doivent être définies dans le fichier `studiocms.config.mjs`. Veuillez consulter la [référence de configuration](/fr/start-here/configuration/) pour plus de détails. + +## Nouvelles fonctionnalités +- Implémentation d'une nouvelle commande [`studiocms migrate`](/fr/how-it-works/cli/#migrate) pour gérer les migrations de base de données. +- Autorise la désactivation des balises méta `generator` via l'option de configuration [`features.dashboard.security.hideGeneratorTags`](/fr/config-reference/features/#hidegeneratortags). +- StudioCMS prend désormais en charge différents dialectes de base de données via [Kysely](https://kysely.dev/). +- Introduction d'un nouveau middleware pour afficher les erreurs système sur les pages concernées au lieu de faire planter l'ensemble du site. +- Nouvelles fonctionnalités pour les modules d'extension : + - Injection dynamique de composants et de scripts dans le tableau de bord via de nouveaux hooks pour les modules d'extension. + - Nouveaux utilitaires pour un accès plus facile aux bases de données depuis les modules d'extension. +- Ajout d'une nouvelle page de tableau de bord pour la gestion du système. + - Comprend un panneau d'informations système (débogage). + - Permet un accès rapide à vos tables de base de données en production. +- Ajout d'une nouvelle application de barre d'outils pour développeurs intégrée à StudioCMS permettant de visualiser et de gérer votre base de données en mode développement. +- Intégration du suivi optionnel des Core Web Vitals et de l'audience au tableau de bord pour une meilleure compréhension des performances. + - Ceci peut être activé via l'option de configuration [`features.webVitals`](/fr/config-reference/features/#webvitals). + - Pour ceux qui utilisaient auparavant les intégrations `@studiocms/web-vitals` ou `@astrojs/web-vitals`, ceci est désormais intégré et peut être configuré via la configuration de StudioCMS. +- Ajout d'une nouvelle commande CLI [`studiocms debug`](/fr/how-it-works/cli/#debug) pour accéder rapidement à des informations de débogage utiles à propos de votre projet StudioCMS. + +## Corrections de bugs et améliorations +- URL de l'image de l'utilisateur fantôme mise à jour. +- Génération des données de page `urlRoute` remaniée pour une résolution correcte. +- Composants de mise en page du tableau de bord remaniés et simplifiés. +- Amélioration des types dans la configuration et les commentaires JSDoc de StudioCMS. +- Commandes CLI remaniées pour utiliser la nouvelle couche de base de données. +- De nouveaux outils de débogage ont été introduits pour faciliter l'accès aux informations de débogage utiles. + +## Étapes de migration + +Pour mettre à niveau votre projet StudioCMS vers la version `0.1.0-beta.31`, veuillez suivre les étapes suivantes : + + + +1. **Mettez à jour vos dépendances StudioCMS** vers la dernière version : + + +2. **Si vous utilisez des modules d'extension personnalisés**, assurez-vous qu'ils sont à jour afin d'être compatibles avec le nouveau système de modules d'extension. Veuillez vous référer à la [documentation des modules d'extension](/fr/plugins/) pour obtenir des conseils. + +3. **Vérifiez votre fichier `studiocms.config.mjs`** pour vous assurer que toutes les options de configuration sont correctement définies conformément au nouveau schéma. Consultez la [référence de configuration](/fr/start-here/configuration/) pour plus de détails. + + - **Vous utilisiez auparavant les intégrations `@studiocms/web-vitals` ou `@astrojs/web-vitals` ?** Supprimez-les des dépendances de votre projet et configurez le suivi intégré des indicateurs web via l'option `features.webVitals` dans votre fichier `studiocms.config.mjs` : + + ```ts {3} title="studiocms.config.mjs" + export default defineStudioCMSConfig({ + features: { + webVitals: true, + }, + }); + ``` + +4. **Configurez une nouvelle connexion à la base de données pour la nouvelle couche de base de données reposant sur Kysely.** Mettez à jour votre fichier `.env` avec les informations de connexion à la base de données nécessaires. Conservez votre base de données précédente intacte pour la migration. + + Consultez le [guide de configuration de la base de données](/fr/start-here/getting-started/#préparer-votre-base-de-données) pour plus d'informations sur la configuration de votre base de données. + Consultez la [documentation sur les variables d'environnement](/fr/start-here/environment-variables/) pour plus d'informations sur la configuration de vos variables d'environnement. + +5. **Configurez votre dialecte de base de données dans `studiocms.config.mjs` sous l'option `db`. Par exemple, pour utiliser libSQL :** + + ```ts {3} title="studiocms.config.mjs" + export default defineStudioCMSConfig({ + db: { + dialect: 'libsql', // ou 'postgresql', 'mysql' + }, + }); + ``` + + + +6. **Installez les paquets clients de base de données nécessaires** pour le dialecte de base de données que vous avez choisi : + + + + + + + + + + + + + + + + + +7. **Téléchargez l'outil de migration à la racine de votre projet StudioCMS :** + + + + Cet outil lira votre fichier `studiocms.config.mjs` pour pouvoir se connecter au dialecte de base de données approprié. + +8. **Exécution des migrations de schéma :** + + Étant donné que la couche de base de données a changé, vous devrez exécuter des migrations pour mettre à jour votre schéma de base de données afin de le rendre compatible avec la nouvelle version. Il existe deux façons de procéder : + + + + + L'interface de ligne de commande de StudioCMS intègre une nouvelle commande `migrate` qui exécutera les migrations nécessaires pour vous. Pour l'utiliser, exécutez la commande suivante dans le répertoire de votre projet : + + + + Vous serez invité à choisir une option pour migrer votre schéma de base de données vers la dernière version, revenir à une version précédente ou consulter l'état actuel de la migration. Sélectionnez « Migrate to Latest » (Migrer vers la dernière version) pour mettre à jour votre schéma de base de données. + + + + + + + Vous pouvez également utiliser l'outil de migration installé à l'étape précédente. Pour ce faire, passez à l'étape suivante et utilisez l'interface web pour exécuter les migrations. + + + + +9. **Accédez à l'interface web de l'outil de migration :** + + Démarrez l'outil de migration en exécutant la commande suivante dans le répertoire de votre projet : + + + + Cela lancera un serveur web local. Ouvrez votre navigateur et rendez-vous à l'adresse `http://localhost:4321` pour accéder à l'interface de l'outil de migration. + + Cette interface vous offrira des options pour migrer le schéma de votre base de données, ainsi que pour migrer vos données de votre ancienne base de données vers la nouvelle. + +1. Une fois la migration terminée, **démarrez votre projet StudioCMS** comme d'habitude : + + + + Votre projet devrait maintenant fonctionner avec le schéma de base de données et la configuration mis à jour. + + +## Notes finales + +- Assurez-vous de disposer de sauvegardes de votre base de données avant d'effectuer des migrations. +- Après la migration, testez minutieusement votre application afin de détecter rapidement tout problème éventuel. +- Consultez la [documentation de StudioCMS](/fr/start-here/getting-started/) pour plus d'informations sur les nouvelles fonctionnalités et les modifications. +- Si vous rencontrez des problèmes lors du processus de migration, veuillez nous contacter au travers de notre [communauté Discord](https://chat.studiocms.dev) ou ouvrir un ticket dans notre [dépôt GitHub](https://github.com/withstudiocms/studiocms/issues). diff --git a/src/content/docs/fr/how-it-works/cli.mdx b/src/content/docs/fr/how-it-works/cli.mdx index e85c9f1d..aaae5675 100644 --- a/src/content/docs/fr/how-it-works/cli.mdx +++ b/src/content/docs/fr/how-it-works/cli.mdx @@ -3,13 +3,17 @@ i18nReady: true title: "La CLI" description: "Découvrez les CLI de StudioCMS et comment les utiliser." sidebar: - order: 2 + order: 2 + badge: + text: Mis à jour + variant: success tableOfContents: minHeadingLevel: 2 maxHeadingLevel: 4 --- -import { Tabs, TabItem } from '@astrojs/starlight/components'; +import { Steps } from '@astrojs/starlight/components'; +import { PackageManagers } from 'starlight-package-managers' import ReadMore from '~/components/ReadMore.astro'; Les interfaces en ligne de commandes (CLI) de StudioCMS sont des utilitaires qui vous permettent de créer rapidement de nouveaux projets StudioCMS et qui exposent des utilitaires utiles pour StudioCMS. @@ -18,7 +22,8 @@ Il existe plusieurs CLI différentes qui font partie de l’écosystème StudioC - **[`studiocms`](#studiocms)** : La CLI de l’utilitaire StudioCMS. - **[`create-studiocms`](#create-studiocms)** : La CLI d’échafaudage du projet StudioCMS. -- **[`@studiocms/upgrade`](#studiocms-upgrade)**: Mettre à niveau les projets StudioCMS et leurs modules d’extension. +- **[`@studiocms/migrator`](#studiocmsmigrator)**: Migrez votre projet StudioCMS depuis une ancienne version vers la dernière version. +- **[`@studiocms/upgrade`](#studiocmsupgrade)**: Mettre à niveau les projets StudioCMS et leurs modules d’extension. Voici une présentation de la CLI de StudioCMS et de ses composants. @@ -33,35 +38,20 @@ Options : -V, --version Afficher la version actuelle de la boîte à outils CLI. -h, --help afficher l’aide pour la commande -Commandes : - add Ajoutez un ou plusieurs modules d’extension StudioCMS à votre projet - crypto Utilitaires de chiffrement pour la sécurité - get-turso Installer la CLI de Turso - init Initialiser le projet StudioCMS après une nouvelle installation. - users Utilitaires pour peaufiner les utilisateurs dans StudioCMS +COMMANDES + - add Ajoutez un ou plusieurs modules d’extension StudioCMS à votre projet + - crypto Utilitaires de chiffrement pour la sécurité de StudioCMS + - get-turso Installer la CLI de Turso + - init Initialiser le projet StudioCMS après une nouvelle installation. + - users Utilitaires pour peaufiner les utilisateurs dans StudioCMS + - migrate Gérer les migrations de bases de données pour StudioCMS. ``` ### Exemple d’utilisation Depuis la racine de votre projet StudioCMS - - - ```sh - npm run studiocms [command] - ``` - - - ```sh - pnpm studiocms [command] - ``` - - - ```sh - yarn studiocms [command] - ``` - - + ### Présentation des commandes @@ -108,6 +98,18 @@ Options : -h, --help afficher l’aide pour la commande ``` +#### `debug` + +```log +Utilisation : studiocms debug [options] + +Affiche les informations de débogage concernant votre installation de StudioCMS. + +Options : + -h, --help afficher l'aide pour la commande + --debug Activer le mode débogage +``` + #### `get-turso` Télécharge et installe la dernière version de Turso à l’aide du script de @@ -145,13 +147,11 @@ La commande init fournit une expérience de configuration interactive qui vous a 1. Configurez votre fichier d’environnement (.env) avec des options pour : - Utiliser un exemple de modèle `.env` - Utiliser le générateur interactif `.env` qui peut : - - Configurer une nouvelle base de données Turso (si ce n’est pas sous Windows) + - Configurer une connexion à une base de données (libSQL, MySQL, PostgreSQL) - Configurer les fournisseurs OAuth (GitHub, Discord, Google, Auth0) - Définir les clés de chiffrement et autres variables requises - Ignorer la création du fichier d’environnement -2. La commande inclut l’installation automatique de Turso CLI et l’authentification si nécessaire lors de la configuration d’une base de données. - Pour une liste complète des variables d’environnement, consultez la [documentation des variables d’environnement][environment-variables]. #### `users` @@ -165,6 +165,21 @@ Options : -h, --help afficher l’aide pour la commande ``` +#### `migrate` + +```log +Utilisation : studiocms migrate [options] + +Gérer les migrations de bases de données pour StudioCMS. + +Options : + -h, --help afficher l'aide pour la commande + --debug Activer le mode débogage + -r, --rollback Restaurer l'état avant la dernière migration + -l, --latest Migrer vers la dernière version + --status Afficher l'état actuel de la migration +``` + ## `create-studiocms` ### Options et commandes complètes de la CLI @@ -188,43 +203,11 @@ Commandes : ### Exemple d’utilisation - - - ```sh - npm create studiocms@latest - ``` - - - ```sh - pnpm create studiocms - ``` - - - ```sh - yarn create studiocms - ``` - - + `create-studiocms` s’exécute automatiquement en mode _interactif_, mais vous pouvez également spécifier le nom et le modèle de votre projet avec des arguments de ligne de commandes. - - - ```sh - npm create studiocms@latest -- --template studiocms/basics --project-name my-studiocms-project - ``` - - - ```sh - pnpm create studiocms --template studiocms/basics --project-name my-studiocms-project - ``` - - - ```sh - yarn create studiocms --template studiocms/basics --project-name my-studiocms-project - ``` - - + [Découvrez la liste complète][templates] de modèles, disponibles sur GitHub. @@ -243,7 +226,7 @@ Cette commande ouvrira une invite CLI interactive pour vous guider tout au long du processus de création d’un nouveau projet StudioCMS (ou d’un paquet de l’écosystème StudioCMS) à l’aide de l’un des modèles disponibles. -Options: +Options : -t, --template