Skip to content

Commit

Permalink
Docs: Update french documentation, contributing guide and github temp…
Browse files Browse the repository at this point in the history
…lates (ElemeFE#14418)

* Docs: update french translation (fr-FR)

* Contributing: add CONTRIBUTING.fr-FR.md

* GitHub templates: update PULL_REQUEST_TEMPLATE.md with french contributing guide
  • Loading branch information
IvanOdd authored and island205 committed Feb 20, 2019
1 parent f55fbdb commit 4ebbbdb
Show file tree
Hide file tree
Showing 10 changed files with 287 additions and 16 deletions.
60 changes: 60 additions & 0 deletions .github/CONTRIBUTING.fr-FR.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
# Guide de contribution à l'assurance-chômage par élément

Bonjour! Merci d'avoir choisi Element UI.

Element UI est une bibliothèque de composants basée sur Vue 2.0 pour les développeurs, les designers et les chefs de produits.

Nous sommes ravis que vous souhaitiez contribuer à Element. Avant de soumettre votre contribution, veuillez vous assurer de prendre un moment pour lire les indications suivantes.

## Concernant les issues

- Les issues concernent exclusivement les bugs, les demandes de fonctionnalités et les sujets liés à la conception. Les questions concernant d'autres sujets peuvent être fermées directement. Si vous avez des questions à propos de l'utilisation d'Element, veuillez vous rendre sur [Gitter](https://gitter.im/element-en/Lobby) pour obtenir de l'aide.

- Avant de soumettre une issue, veuillez vérifier si des problèmes similaires n'ont pas déjà été signalés.

- Veuillez spécifier la version de `Element` et `Vue` que vous utilisez, et fournir des informations sur le système d'exploitation et le navigateur. [JSFiddle](https://jsfiddle.net/) est recommandé afin de construire une démo pour que votre problème puisse être reproduit clairement.

## Concernant les pull requests

- Faites un fork de ce dépôt vers votre compte. Ne créez pas de branches ici.

- Les informations de validation doivent être formatées en tant que `[Nom du composant] : Info à propos de ce commit` (par exemple `Button : Fix xxx bug`)

- **NE PAS** inclure de fichiers dans le répertoire `lib`.

- Assurez-vous que l'exécution de `npm run dist` génère les bons fichiers.

- Pour des raisons de compatibilité et de taille de fichier, notre configuration babel n'importait que `preset-2015`, donc les API comme `Array.prototype.find` et `Object.assign` dans `ES2015` ne sont pas recommandées. Vous pouvez importer des polyfills si nécessaire.

- Faites un rebase avant la création d'une PR pour garder l'historique clair.

- Assurez-vous que les PRs sont créés dans la branche `dev` au lieu de la branche `master`.

- Si votre PR corrige un bug, veuillez fournir une description du bug en question.

- La fusion d'un PR nécessite deux responsables: l'un approuve les modifications après révision, puis l'autre les révise et les fusionne.

## Pré-requis
`Node.js 4+`, `yarn` et `npm 3+` sont requis. Note: nous utilisons yarn pour verrouiller les versions des dépendances, donc vous devriez installer les dépendances en utilisant `yarn` au lieu de `npm install`.
```shell
git clone [email protected]:ElemeFE/element.git
npm run dev

# open http://localhost:8085
```

> **Remarque** : modifiez le fichier `examples/play/index.vue`, utilisez le composant auquel vous contribuez, puis lancez `npm run dev:play`, allez sur http://localhost:8085, regardez le résultat rapidement et facilement.
Pour le build:

```shell
npm run dist
```

## Concernant le développement de composants
- Exécutez `make new <nom-du-composant>` pour créer un répertoire pour le nouveau composant. Les tests, le fichier d'entrée et la documentation sont inclus.
- Reportez-vous au `Button` pour les composants imbriqués.
- Reportez-vous à `Select` pour connaître les composants qui dépendent d'autres composants.

## Style du code
Il suffit de se conformer à la configuration [ESLint](https://github.com/ElemeFE/eslint-config-elemefe) de [ElemeFE](https://github.com/elemefe).
2 changes: 1 addition & 1 deletion .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Please make sure these boxes are checked before submitting your PR, thank you!

* [ ] Make sure you follow Element's contributing guide ([中文](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.zh-CN.md) | [English](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.en-US.md) | [Español](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.es.md)).
* [ ] Make sure you follow Element's contributing guide ([中文](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.zh-CN.md) | [English](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.en-US.md) | [Español](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.es.md) | [Français](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.fr-FR.md)).
* [ ] Make sure you are merging your commits to `dev` branch.
* [ ] Add some descriptions and refer relative issues for you PR.
15 changes: 9 additions & 6 deletions examples/docs/fr-FR/custom-theme.md
Original file line number Diff line number Diff line change
Expand Up @@ -111,12 +111,15 @@ Vue.use(ElementUI)
Si vous utilisez `babel-plugin-component` pour les imports sur demande, modifiez `.babelrc` et spécifiez `styleLibraryName` avec le chemin où votre thème est localisé relativement à `.babelrc`. N'oubliez pas que `~` est requis:
```json
{
"plugins": [["component", [
{
"libraryName": "element-ui",
"styleLibraryName": "~theme"
}
]]]
"plugins": [
[
"component",
{
"libraryName": "element-ui",
"styleLibraryName": "~theme"
}
]
]
}
```

Expand Down
1 change: 1 addition & 0 deletions examples/docs/fr-FR/i18n.md
Original file line number Diff line number Diff line change
Expand Up @@ -221,6 +221,7 @@ Actuellement, Element supporte les langues suivantes:
<li>Serbe (sr)</li>
<li>Basque (eu)</li>
<li>Kirghize (kg)</li>
<li>Arménien (hy)</li>
</ul>

Si votre langue n'apparaît pas dans la liste, n'hésitez pas a contribuer: ajoutez simplement un fichier de configuration [ici](https://github.com/ElemeFE/element/tree/dev/src/locale/lang) et créez une pull request.
7 changes: 3 additions & 4 deletions examples/docs/fr-FR/icon.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,8 +37,6 @@
line-height: 120px;
color: #666;
font-size: 13px;
transition: color .15s linear;

border-right: 1px solid #eee;
border-bottom: 1px solid #eee;
margin-right: -1px;
Expand All @@ -58,15 +56,16 @@
font-size: 32px;
margin-bottom: 15px;
color: #606266;
transition: color .15s linear;
}
.icon-name {
display: inline-block;
padding: 0 3px;
height: 1em;
color: #606266;
transition: color .15s linear;
}
&:hover {
color: rgb(92, 182, 255);
i,span{color: rgb(92, 182, 255);}
}
}
</style>
Expand Down
1 change: 1 addition & 0 deletions examples/docs/fr-FR/input.md
Original file line number Diff line number Diff line change
Expand Up @@ -716,6 +716,7 @@ Vous pouvez aller chercher des infos de suggestions sur un serveur distant.
| suffix-icon | Classe de l'iĉone de suffixe. | string |||
| hide-loading | Si l'icône de chargement doit être cachée dans le cas d'une recherche distante. | boolean || false |
| popper-append-to-body | Si le menu doit être ajouter au body. Si le positionnement du menu est incorrect, essayez de mettre cette propriété à `false`. | boolean | - | true |
| highlight-first-item | Si la première suggestion de la liste issue de la recherche distante doit être en surbrillance par défaut. | boolean || false |

### Slots de l'autocomplétion

Expand Down
5 changes: 3 additions & 2 deletions examples/docs/fr-FR/select.md
Original file line number Diff line number Diff line change
Expand Up @@ -684,8 +684,8 @@ Si la valeur de Select est un objet, assurez-vous d'utiliser `value-key` comme i
| remote-method | Méthode pour la recherche distante. | function |||
| loading | Si le sélecteur est en train de charger des options. | boolean || false |
| loading-text | Texte à afficher pendant le chargement. | string || Loading |
| no-match-text | Texte à afficher quand le filtrage ne retourne aucune option. | string || No matching data |
| no-data-text | Texte à afficher quand il n'y a aucune option. | string || No data |
| no-match-text | Texte à afficher quand le filtrage ne retourne aucune option. Vous pouvez aussi utiliser le slot `empty`. | string || No matching data |
| no-data-text | Texte à afficher quand il n'y a aucune option. Vous pouvez aussi utiliser le slot `empty`. | string || No data |
| popper-class | Classe du menu déroulant. | string |||
| reserve-keyword | Quand `multiple` et `filter` sont activés, si il faut réserver le mot-clé courant après la sélection d'une option. | boolean || false |
| default-first-option | Sélectionne la première option avec Entrée. Utilisable avec `filterable` ou `remote` | boolean | - | false |
Expand All @@ -709,6 +709,7 @@ Si la valeur de Select est un objet, assurez-vous d'utiliser `value-key` comme i
|---------|-------------|
|| Liste de options. |
| prefix | Contenu du préfixe du sélecteur. |
| empty | Contenu lorsqu'il n'y a aucune option. |

### Attributs du groupe d'options

Expand Down
6 changes: 3 additions & 3 deletions examples/docs/fr-FR/table.md
Original file line number Diff line number Diff line change
Expand Up @@ -2105,9 +2105,9 @@ Vous pouvez personnaliser les indices des colonnes de type `index`.
| cell-mouse-leave | Se déclenche quand la souris sort d'une cellule. | row, column, cell, event |
| cell-click | Se déclenche quand l'utilisateur clique sur une cellule. | row, column, cell, event |
| cell-dblclick | Se déclenche quand l'utilisateur double-clique sur une cellule. | row, column, cell, event |
| row-click | Se déclenche quand l'utilisateur clique sur une ligne. | row, event, column |
| row-contextmenu | Se déclenche quand l'utilisateur fait un click droit sur une ligne. | row, event |
| row-dblclick | Se déclenche quand l'utilisateur double-clique sur une ligne. | row, event |
| row-click | Se déclenche quand l'utilisateur clique sur une ligne. | row, column, event |
| row-contextmenu | Se déclenche quand l'utilisateur fait un click droit sur une ligne. | row, column, event |
| row-dblclick | Se déclenche quand l'utilisateur double-clique sur une ligne. | row, column, event |
| header-click | Se déclenche quand l'utilisateur clique sur une colonne du header. | column, event |
| header-contextmenu | Se déclenche quand l'utilisateur fait un click droit sur une colonne du header. | column, event |
| sort-change | Se déclenche quand l'ordre de tri change. | { column, prop, order } |
Expand Down
202 changes: 202 additions & 0 deletions examples/docs/fr-FR/timeline.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,202 @@
<script>
export default {
data() {
return {
reverse: true,
activities: [{
content: 'Début de l\'évènement',
timestamp: '2018-04-15'
}, {
content: 'Approuvé',
timestamp: '2018-04-13'
}, {
content: 'Succès',
timestamp: '2018-04-11'
}],
activities2: [{
content: 'Icône',
timestamp: '2018-04-12 20:46',
size: 'large',
type: 'primary',
icon: 'el-icon-more'
}, {
content: 'Couleur',
timestamp: '2018-04-03 20:46',
color: '#0bbd87'
}, {
content: 'Taille',
timestamp: '2018-04-03 20:46',
size: 'large'
}, {
content: 'Défaut',
timestamp: '2018-04-03 20:46'
}]
};
}
};
</script>
<style>
.demo-timeline .source .radio {
margin-bottom: 20px;
}
.demo-timeline .source .radio .el-radio-group {
margin-left: 20px;
}
</style>

## Timeline

Affiche une suite d'évènements dans un ordre chronologique.

### Usage

La ligne du temps peut être divisée en plusieurs activités en ordre ascendant ou descendant. Les timestamps sont des caractéristiques importantes qui les distinguent des autres composants. Notez la différence avec Steps.

:::demo
```html
<div class="block">
<div class="radio">
Order:
<el-radio-group v-model="reverse">
<el-radio :label="true">Descendant</el-radio>
<el-radio :label="false">Ascendant</el-radio>
</el-radio-group>
</div>

<el-timeline :reverse="reverse">
<el-timeline-item
v-for="(activity, index) in activities"
:key="index"
:timestamp="activity.timestamp">
{{activity.content}}
</el-timeline-item>
</el-timeline>
</div>

<script>
export default {
data() {
return {
reverse: true,
activities: [{
content: 'Début de l\'évènement',
timestamp: '2018-04-15'
}, {
content: 'Approuvé',
timestamp: '2018-04-13'
}, {
content: 'Succès',
timestamp: '2018-04-11'
}]
};
}
};
</script>
```
:::

### Noeud personnalisé

Vous pouvez personnaliser la taille, la couleur et les icônes de chaque Noeud.

:::demo
```html
<div class="block">
<el-timeline>
<el-timeline-item
v-for="(activity, index) in activities2"
:key="index"
:icon="activity.icon"
:type="activity.type"
:color="activity.color"
:size="activity.size"
:timestamp="activity.timestamp">
{{activity.content}}
</el-timeline-item>
</el-timeline>
</div>

<script>
export default {
data() {
return {
activities2: [{
content: 'Icône',
timestamp: '2018-04-12 20:46',
size: 'large',
type: 'primary',
icon: 'el-icon-more'
}, {
content: 'Couleur',
timestamp: '2018-04-03 20:46',
color: '#0bbd87'
}, {
content: 'Taille',
timestamp: '2018-04-03 20:46',
size: 'large'
}, {
content: 'Défaut',
timestamp: '2018-04-03 20:46'
}]
};
}
};
</script>
```
:::

### Timestamp personnalisé

Le timestamp peut être placé au-dessus du contenu lorsque celui-ci est trop haut.

:::demo
```html
<div class="block">
<el-timeline>
<el-timeline-item timestamp="2018/4/12" placement="top">
<el-card>
<h4>Mise à jour du template GitHub</h4>
<p>Commit de Tom le 2018/4/12 20:46</p>
</el-card>
</el-timeline-item>
<el-timeline-item timestamp="2018/4/3" placement="top">
<el-card>
<h4>Mise à jour du template GitHub</h4>
<p>Commit de Tom le 2018/4/3 20:46</p>
</el-card>
</el-timeline-item>
<el-timeline-item timestamp="2018/4/2" placement="top">
<el-card>
<h4>Mise à jour du template GitHub</h4>
<p>Commit de Tom le 2018/4/2 20:46</p>
</el-card>
</el-timeline-item>
</el-timeline>
</div>
```
:::

### Attributs de Timeline

| Attribut | Description | Type | Valeurs acceptées | Défaut |
|---------- |-------- |---------- |------------- |-------- |
| reverse | Si l'ordre chronologique est ascendant ou descendant, le défaut étant ascendant. | boolean || false |

### Attribut de Timeline-item

| Attribut | Description | Type | Valeurs acceptées | Défaut |
|---------- |-------- |---------- |------------- |-------- |
| timestamp | Le contenu du timestamp. | string | - ||
| hide-timestamp | Si le timestamp doit être affiché. | boolean || false |
| placement | La position du timestamp. | string | top / bottom | bottom |
| type | Le type de noeud. | string | primary / success / warning / danger / info | - |
| color | La couleur de fond du noeud. | string | hsl / hsv / hex / rgb | - |
| size | La taille du noeud | string | normal / large | normal |
| icon | Le nom de classe de l'icône. | string || - |

### Slots de Timeline-Item

| Nom | Description |
|------|--------|
|| Contenu personnalisé pour le timeline-item. |
| dot | Noeud personnalisé. |
4 changes: 4 additions & 0 deletions examples/nav.config.json
Original file line number Diff line number Diff line change
Expand Up @@ -1005,6 +1005,10 @@
{
"path": "/collapse",
"title": "Collapse"
},
{
"path": "/timeline",
"title": "Timeline"
}
]
}
Expand Down

0 comments on commit 4ebbbdb

Please sign in to comment.