Skip to content

Commit 6bbaf9b

Browse files
committed
docs: 📝 améliore la documentation dans le README
1 parent 086a858 commit 6bbaf9b

File tree

3 files changed

+29
-33
lines changed

3 files changed

+29
-33
lines changed

.github/workflows/release-please.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,9 @@ jobs:
3030
if: ${{ steps.release.outputs.release_created }}
3131
- run: npm ci
3232
if: ${{ steps.release.outputs.release_created }}
33-
- run: npm publish --access public
33+
- run: npm run dev:prepare
34+
if: ${{ steps.release.outputs.release_created }}
35+
- run: npm release
3436
if: ${{ steps.release.outputs.release_created }}
3537
env:
3638
NPM_TOKEN: ${{secrets.NPM_TOKEN}}

README.md

Lines changed: 26 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,3 @@
1-
<!--
2-
Get your module up and running quickly.
3-
4-
Find and replace all on all files (CMD+SHIFT+F):
5-
- Name: My Module
6-
- Package name: vue-dsfr-nuxt-module
7-
- Description: My new Nuxt module
8-
-->
9-
101
# Module VueDsfr pour Nuxt
112

123
[![npm version][npm-version-src]][npm-version-href]
@@ -16,35 +7,37 @@ Find and replace all on all files (CMD+SHIFT+F):
167

178
Ce module facilite l’utilisation de la bibliothèque VueDsfr dans un projet Nuxt 3.
189

19-
- [ &nbsp;Release Notes](/CHANGELOG.md)
20-
<!-- - [🏀 Online playground](https://stackblitz.com/github/your-org/vue-dsfr-nuxt-module?file=playground%2Fapp.vue) -->
21-
<!-- - [📖 &nbsp;Documentation](https://example.com) -->
10+
- [ Release Notes](/CHANGELOG.md)
11+
- [🏀 Online playground](https://stackblitz.com/github/laruiss/vue-dsfr-nuxt-module?file=playground%2Fapp.vue)
12+
- [📖 Documentation](https://docs.vue-ds.fr/nuxt)
2213

2314
## Features
2415

2516
<!-- Highlight some of the features your module provide here -->
26-
- 🪄 &nbsp;Imports automagique des imports des composables VueDsfr
27-
- 🪄 &nbsp;Imports automagique des imports des composants VueDsfr
28-
- &nbsp;Facilitation de l’utilisation des icônes de [Oh, Vue Icons](https://oh-vue-icons.netlify.app/)
17+
- 🪄 Imports automagiques des composables VueDsfr
18+
- 🪄 Imports automagiques des composants VueDsfr
19+
- Facilitation de l’utilisation des icônes de [Oh, Vue Icons](https://oh-vue-icons.netlify.app/)
2920

3021
## Configuration rapide
3122

3223
1. Ajouter la dépendance `vue-dsfr-nuxt-module` au projet
3324

3425
```bash
35-
# Using pnpm
26+
# Avec pnpm
3627
pnpm add -D vue-dsfr-nuxt-module
3728

38-
# Using yarn
29+
# Avec yarn
3930
yarn add --dev vue-dsfr-nuxt-module
4031

41-
# Using npm
32+
# Avec npm
4233
npm i -D vue-dsfr-nuxt-module
4334
```
4435

36+
N.B. : Vous devriez déjà avoir les dépendances `@gouvminint/vue-dsfr` et `@gouvfr/dsfr`
37+
4538
2. Ajouter `vue-dsfr-nuxt-module` dans la section `modules` de `nuxt.config.ts`
4639

47-
```ts{3}
40+
```ts
4841
export default defineNuxtConfig({
4942
modules: [
5043
'vue-dsfr-nuxt-module'
@@ -54,25 +47,26 @@ export default defineNuxtConfig({
5447

5548
3. Ajouter le CSS de DSFR dans la section `css` de `nuxt.config.ts`
5649

57-
```ts{5-12}
50+
Rappel : Vous devriez déjà avoir les dépendances `@gouvminint/vue-dsfr` et `@gouvfr/dsfr`
51+
52+
```ts
5853
export default defineNuxtConfig({
5954
modules: [
6055
'vue-dsfr-nuxt-module'
6156
],
6257
css: [
6358
'@gouvfr/dsfr/dist/core/core.main.min.css', // Le CSS minimal du DSFR
64-
'@gouvfr/dsfr/dist/component/component.main.min.css' // Styles de tous les composants du DSFR
65-
'@gouvfr/dsfr/dist/utility/utility.main.min.css' // Classes utilitaires : les composants de VueDsfr en ont besoin
59+
'@gouvfr/dsfr/dist/component/component.main.min.css', // Styles de tous les composants du DSFR
60+
'@gouvfr/dsfr/dist/utility/utility.main.min.css', // Classes utilitaires : les composants de VueDsfr en ont besoin, contient aussi les icônes
6661

67-
'@gouvfr/dsfr/dist/scheme/scheme.min.css' // Facultatif : Si les thèmes sont utilisés (thème sombre, thème en bernes)
68-
'@gouvfr/dsfr/dist/utility/icons/icons.min.css', // Facultatif : Si des icônes sont utilisées avec les classes "fr-icon-..."
62+
'@gouvfr/dsfr/dist/scheme/scheme.min.css', // Facultatif : Si les thèmes sont utilisés (thème sombre, thème en bernes)
6963
],
7064
})
7165
```
7266

73-
4. Facultatif : ajouter les icônes à utiliser avec OhVueIcon
67+
4. Facultatif : ajouter des icônes à utiliser avec OhVueIcon
7468

75-
```ts{5-12}
69+
```ts
7670
import * as icons from './icons'
7771

7872
export default defineNuxtConfig({
@@ -81,22 +75,23 @@ export default defineNuxtConfig({
8175
],
8276
css: [
8377
'@gouvfr/dsfr/dist/core/core.main.min.css', // Le CSS minimal du DSFR
84-
'@gouvfr/dsfr/dist/component/component.main.min.css' // Styles de tous les composants du DSFR
85-
'@gouvfr/dsfr/dist/utility/utility.main.min.css' // Classes utilitaires : les composants de VueDsfr en ont besoin
78+
'@gouvfr/dsfr/dist/component/component.main.min.css', // Styles de tous les composants du DSFR
79+
'@gouvfr/dsfr/dist/utility/utility.main.min.css', // Classes utilitaires : les composants de VueDsfr en ont besoin, contient aussi les icônes
8680

87-
'@gouvfr/dsfr/dist/scheme/scheme.min.css' // Facultatif : Si les thèmes sont utilisés (thème sombre, thème en bernes)
88-
'@gouvfr/dsfr/dist/utility/icons/icons.min.css', // Facultatif : Si des icônes sont utilisées avec les classes "fr-icon-..."
81+
'@gouvfr/dsfr/dist/scheme/scheme.min.css', // Facultatif : Si les thèmes sont utilisés (thème sombre, thème en bernes)
8982
],
9083
runtimeConfig: {
9184
public: {
9285
vueDsfr: {
9386
icons: Object.values(icons),
94-
}
87+
},
9588
},
9689
},
9790
})
9891
```
9992

93+
Et ajouter un fichier `icons.ts` à la racine dans lequel sont réexportées depuis `'oh-vue-icons/icons'` les icônes utilisées :
94+
10095
```ts
10196
export {
10297
RiFlagLine,

playground/nuxt.config.ts

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,6 @@ export default defineNuxtConfig({
1414
'@gouvfr/dsfr/dist/component/component.main.min.css',
1515
'@gouvfr/dsfr/dist/utility/utility.main.min.css',
1616
'@gouvfr/dsfr/dist/scheme/scheme.min.css',
17-
'@gouvfr/dsfr/dist/utility/icons/icons.main.min.css',
1817
],
1918
modules: ['../src/module'],
2019
devtools: { enabled: true }

0 commit comments

Comments
 (0)