Skip to content

Commit

Permalink
[docs] Sync translations (#21925)
Browse files Browse the repository at this point in the history
  • Loading branch information
oliviertassinari authored Jul 25, 2020
1 parent 33a5a68 commit e294394
Show file tree
Hide file tree
Showing 90 changed files with 774 additions and 765 deletions.
20 changes: 10 additions & 10 deletions docs/src/pages/components/about-the-lab/about-the-lab-fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,18 @@

<p class="description">Ce package contient des composants en incubation (en développement) qui ne sont pas encore prêts à être ajoutés au package principal.</p>

La principale différence entre le laboratoire et le noyau est la façon dont les composants sont versionnés. Le fait de disposer d'un paquet de laboratoire séparé nous permet de publier les modifications de rupture si nécessaire, tandis que le paquet de base suit une [politique plus lente](https://material-ui.com/versions/#release-frequency).
La principale différence entre le laboratoire et le noyau est la façon dont les composants sont versionnés. Avoir un paquet laboratoire séparer nous permets de pouvoir effectuer des changements ou d'intégrer de nouvelles fonctionnalités tandis que le noyau suit une [politique plus lente](https://material-ui.com/versions/#release-frequency).

As developers use and test the components and report issues, the maintainers learn more about shortcomings of the components: missing features, accessibility issues, bugs, API design, etc. The older and more used a component is, the less likely it is that new issues will be found and subsequently need to introduce breaking changes.
Lorsque les développeur utilise et test les composant en signalant les éventuels problèmes, les contributeurs en apprennent plus sur se que le composant pourrait manquer, fonctionnalité manquante, problème d'accessibilité, bugs, API design, etc. Plus un composant est âgé, plus il est utilisé, moins il y aura de chances de trouver de nouveaux problèmes et par conséquent de devoir subir d'important changement.

For a component to be ready to move to the core, the following criteria are considered:
Pour qu'un composant soit prêt à être déplacer dans le noyau, les critères suivant doivent être remplis:

* It needs to be **used**. The Material-UI team uses Google Analytics stats among other metrics to evaluate the usage of each component. A lab component with low usage either means that it isn't fully working yet or that there is a low demand for it.
* It needs to match the **code quality** of the core components. It doesn't have to be perfect to be a part of the core, but the component should be reliable enough that developers can depend on it.
* Each component needs **type definitions**. It is not currently required that a lab component is typed, but it would need to be typed to move to the core.
* Requires good **test coverage**. Some of the lab components don't currently have comprehensive tests.
* Can it be used as **leverage** to incentivize users to upgrade to the latest major release? The less fragmented the community is, the better.
* It needs to have a low probability of a **breaking change** in the short/medium future. For instance, if it needs a new feature that will likely require a breaking change, it may be preferable to delay its promotion to the core.
* Il doit être **utilisé**. L'équipe Material-ui utilise les données de Google Analytics et d'autres données, pour évaluer l'utilisation de chaque composant. Un composant du laboratoire avec très peu d'utilisation, veux soit dire qu'il n'est pas entièrement opérationnel, ou qu'il ni a pas suffisamment de demande.
* Il doit satisfaire a un **code de qualité** équivalent au composants du noyau. Sa ne doit pas être parfait pour faire par du noyau, mais le composant doit être suffisamment fiable pour que les développeur puisse en dépendre.
* Chaque composant a besoin de **définitions de type**. Il n'est pas nécessaire qu'un composant du laboratoire soit typés mais pour être déplacer dans le noyau il devra l'être.
* Requiert de bon **test**. Certains composant du laboratoire n'ont actuellement aucun tests.
* Est-ce qu'il peut être utiliser comme **levier** pour inciter les utilisateurs mettre à jours vers la dernières mise à jour majeur ? Moins la communauté est divisé mieux s'est.
* Il doit y avoir une faible probabilité de **changement majeur** dans un un proche/moyen futur. Par exemple, si il y a besoin d'intégrer de nouvelle fonctionnalité induisant d'important changement, alors il serait préférable de retarder son déplacement vers le noyau.

## Installation

Expand All @@ -39,7 +39,7 @@ yarn add @material-ui/core

## TypeScript

In order to benefit from the [CSS overrides](/customization/globals/#css) and [default prop customization](/customization/globals/#default-props) with the theme, TypeScript users need to import the following types. Internally, it uses [module augmentation](/guides/typescript/#customization-of-theme) to extend the default theme structure with the extension components available in the lab.
De manière à pouvoir [ outrepasser le CSS ](/customization/globals/#css) et [ à customiser les props par défaut ](/customization/globals/#default-props) avec le theme, les utilisateurs de TypeScript devront importés les types suivant. En interne, il utilise [le module d'augmentation](/guides/typescript/#customization-of-theme) pour étendre la structure du thème par défaut avec l'extension de composant disponible dans le laboratoire.

```tsx
import type '@material-ui/lab/themeAugmentation';
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Labパッケージとcoreパッケージの明確な違いはどのようにバ

Coreパッケージに移るためには以下の基準を考慮します。

* It needs to be **used**. The Material-UI team uses Google Analytics stats among other metrics to evaluate the usage of each component. A lab component with low usage either means that it isn't fully working yet or that there is a low demand for it.
* **使用されている**必要があります。 The Material-UI team uses Google Analytics stats among other metrics to evaluate the usage of each component. A lab component with low usage either means that it isn't fully working yet or that there is a low demand for it.
* It needs to match the **code quality** of the core components. It doesn't have to be perfect to be a part of the core, but the component should be reliable enough that developers can depend on it.
* Each component needs **type definitions**. It is not currently required that a lab component is typed, but it would need to be typed to move to the core.
* Requires good **test coverage**. Some of the lab components don't currently have comprehensive tests.
Expand Down
18 changes: 9 additions & 9 deletions docs/src/pages/components/about-the-lab/about-the-lab-ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,18 @@

<p class="description">Этот пакет содержит инкубационные компоненты, которые еще не готовы к переходу в основной пакет.</p>

The main difference between the lab and the core is how the components are versioned. Having a separate lab package allows us to release breaking changes when necessary while the core package follows a [slower-moving policy](https://material-ui.com/versions/#release-frequency).
Главное различие между пакетом lab и основным пакетом заключается в очерёдности выхода обновлений. Наличие отдельного пакета lab позволяет нам выпускать критические обновления по мере необходимости, в то время как основной пакет следует [политике "семь раз отмерь..."](https://material-ui.com/versions/#release-frequency).

As developers use and test the components and report issues, the maintainers learn more about shortcomings of the components: missing features, accessibility issues, bugs, API design, etc. The older and more used a component is, the less likely it is that new issues will be found and subsequently need to introduce breaking changes.
По мере использования и тестирования компонентов сторонними разработчиками, разработчики, поддерживающие пакет, узнают больше о недостатках компонентов: недостающих фичах, проблемах универсального доступа, багах, проблемах в дизайне API, и т.д. Чем старше компонент, и чем более интенсивно он используется, тем менее вероятно проявление новых проблем, требующих критических обновлений.

For a component to be ready to move to the core, the following criteria are considered:
Готовность компонента к перемещению в основной пакет определяется следующими критериями:

* It needs to be **used**. The Material-UI team uses Google Analytics stats among other metrics to evaluate the usage of each component. A lab component with low usage either means that it isn't fully working yet or that there is a low demand for it.
* It needs to match the **code quality** of the core components. It doesn't have to be perfect to be a part of the core, but the component should be reliable enough that developers can depend on it.
* Each component needs **type definitions**. It is not currently required that a lab component is typed, but it would need to be typed to move to the core.
* Requires good **test coverage**. Some of the lab components don't currently have comprehensive tests.
* Can it be used as **leverage** to incentivize users to upgrade to the latest major release? The less fragmented the community is, the better.
* It needs to have a low probability of a **breaking change** in the short/medium future. For instance, if it needs a new feature that will likely require a breaking change, it may be preferable to delay its promotion to the core.
* Он должен **использоваться**. Команда Material-UI помимо прочих метрик использует Google Analytics, чтобы оценить использование каждого компонента. Если компонент пакета lab используется редко, это может говорить о том, что он не полностью работоспособен, либо об отсутствии спроса на этот компонент.
* Он должен соответствовать **качеству кода** компонентов основного пакета. Он не обязан быть совершенным, чтобы стать частью основного пакета, но компонент должен быть достаточно надёжным, чтобы сторонние разработчики могли на него положиться.
* Для каждого компонента требуется **определение типов**. Компоненты пакета lab на данный момент не обязаны быть типизированными, но это понадобится для перемещения компонента в основной пакет.
* Требуется хорошее **покрытие тестами**. Некоторые компоненты пакета lab на данный момент не имеют всесторонних тестов.
* Может ли он использоваться как **рычаг**, стимулирующий пользователей к обновлению до последней мажорной версии? Чем менее разрозненно коммьюнити, тем лучше.
* Он должен иметь низкую вероятность **критических изменений** в обозримом будущем. К примеру, если ему не хватает новой фичи, которая скорее всего потребует критических изменений, предпочтительно будет отложить его добавление в основной пакет.

## Инструкция по установке

Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/accordion/accordion-de.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ components: Accordion, AccordionActions, AccordionDetails, AccordionSummary

[Ein Erweiterungspanel](https://material.io/archive/guidelines/components/expansion-panels.html) ist ein leichter Behälter, der entweder alleine stehen kann oder mit einer größeren Oberfläche verbunden ist, beispielsweise einer Karte.

> **Note:** Expansion panels are no longer documented in the [Material Design guidelines](https://material.io/), but Material-UI will continue to support them. It was formerly known as the "expansion panel".
> **Hinweis:** Diese Komponente ist zwar nicht mehr in den [Material-Design-Richtlinien](https://material.io/) dokumentiert, wird aber weiterhin von Material-UI unterstützt. It was formerly known as the "expansion panel".
## Einfaches Erweiterungspanel

Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/accordion/accordion-es.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Extiende el comportamiento por defecto del panel para crear un acordeón con el

## Customized accordions

Here is an example of customizing the component. You can learn more about this in the [overrides documentation page](/customization/components/).
He aquí un ejemplo de personalización del componente. You can learn more about this in the [overrides documentation page](/customization/components/).

{{"demo": "pages/components/accordion/CustomizedAccordions.js"}}

Expand Down
28 changes: 14 additions & 14 deletions docs/src/pages/components/accordion/accordion-fr.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
---
title: Composant React Panneau d'expansion
title: Accordéon Composant React
components: Accordion, AccordionActions, AccordionDetails, AccordionSummary
---

# Accordion (Panneau d'extension)
# Accordéon (Panneau d'extension)

<p class="description">Les panneaux d’extension contiennent des flux de création et permettent une édition légère d’un élément.</p>
<p class="description">L'accordéon contient le flux de création et permet la modification légère de ses éléments.</p>

[Un panneau d'extension](https://material.io/archive/guidelines/components/expansion-panels.html) est un conteneur léger pouvant être autonome ou connecté à une surface plus grande, telle qu'une carte.
[Un accordéonn](https://material.io/archive/guidelines/components/expansion-panels.html) est un conteneur léger pouvant être autonome ou connecté à une surface plus grande, telle qu'une carte.

> **Note:** Expansion panels are no longer documented in the [Material Design guidelines](https://material.io/), but Material-UI will continue to support them. It was formerly known as the "expansion panel".
> **Note:** Le panneau d'expansion n'est plus documenté dans le [Material Design guidelines](https://material.io/), mais Material-UI continue le support. Il était précédemment connus sous le nom de panneau d'expansion.
## Panneau d'extension simple
## Accordéon simple

{{"demo": "pages/components/accordion/SimpleAccordion.js", "bg": true}}

Expand All @@ -21,36 +21,36 @@ components: Accordion, AccordionActions, AccordionDetails, AccordionSummary

{{"demo": "pages/components/accordion/ControlledAccordions.js", "bg": true}}

## Customized accordions
## Customiser l'accordéon

Voici un exemple de personnalisation du composant. Vous pouvez en savoir plus dans la [page de documentation des overrides](/customization/components/).

{{"demo": "pages/components/accordion/CustomizedAccordions.js"}}

## Additional actions
## Actions supplémentaires

In order to put an action such as a `Checkbox` or a button inside of the `AccordionSummary`, you need to stop the propagation of the focus and click events to prevent the panel from expanding/collapsing when using the action. You should also provide an `aria-label` for the action, otherwise the label of the nested action will be included in the label of the parent button that controls the accordion expansion.
Pour pouvoir exécuter une action comme une `Checkbox` ou un bouton à l'intérieur du `AccordionSummary`, vous aurez besoin d'arrêter la propagation du focus et de l'évènement de clique sur l'accordéon à partir de l'expansion/réduction au moment de son utilisation. Vous devriez également fournir un `aria-label` pour l'action, autrement le label de l'action imbriquer sera inclus dans le label du bouton parent qui contrôle l'expansion de l'accordéon.

{{"demo": "pages/components/accordion/ActionsInAccordionSummary.js", "bg": true}}

## Performances

The content of Accordions is mounted by default even if the panel is not expanded. This default behavior has server-side rendering and SEO in mind. If you render expensive component trees inside your panels or simply render many panels it might be a good idea to change this default behavior by enabling the `unmountOnExit` in `TransitionProps`:
Le contenu de l'accordéon est monter par défaut et se même si l'accordéon n'est pas ouvert. Se comportement à le "server-side rendrering" et le SEO comme objectif. Si vous devez rendre un lourd composant au niveau des détails de l'accordéon ou simplement rendre plusieurs accordéons, il serait une bonne idée de changer le comportement par défaut en activant le `unmountOnExit` dans le prop `TransitionProps`:

```jsx
<Accordion TransitionProps={{ unmountOnExit: true }} />
```

As with any performance optimization this is not a silver bullet. Be sure to identify bottlenecks first and then try out these optimization strategies.
Se n'est tout de même pas une solution miracle. Soyez sure de d'abord identifier les goulot d'étranglement et ensuite de considérer ses stratégies d'optimisation.

## En-tête et colonnes secondaires
## Titres et colonnes secondaire

Plusieurs colonnes peuvent être utilisées pour structurer le contenu et un texte d'assistance peut être ajouté au panneau pour aider l'utilisateur.
Plusieurs colonnes peuvent être utilisées pour structurer le contenu et un texte d'assistance peut être ajouté a l'accordéon pour aider l'utilisateur.

{{"demo": "pages/components/accordion/DetailedAccordion.js", "bg": true}}

## Accessibilité

(WAI-ARIA: https://www.w3.org/TR/wai-aria-practices/#accordion)

For optimal accessibility we recommend setting `id` and `aria-controls` on the `AccordionSummary`. The `Accordion` will derive the necessary `aria-labelledby` and `id` for the content region of the panel.
Pour une accessibilité optimal nous recommandons le paramètre `id` et `aria-controls` sur le `AccordionsSummary`. `Accordion` générera les nécessaires `aria-labelledby` et `id` pour le contenu régional de l'accordéon.
4 changes: 2 additions & 2 deletions docs/src/pages/components/alert/alert-de.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ components: Alert, AlertTitle

## Einfache Hinweise

Der Hinweis bietet vier Schweregrade an welche je ein eigenes Icon und eine eigene Farbe besitzen.
Der Hinweis bietet vier Schweregrade an, welche je ein eigenes Icon und eine eigene Farbe besitzen.

{{"demo": "pages/components/alert/SimpleAlerts.js"}}

Expand Down Expand Up @@ -47,7 +47,7 @@ Setting the icon prop to false will remove the icon altogether.

## Varianten

Two additional variants are availableoutlined, and filled:
Zwei weitere Varianten sind verfügbarumrandet und ausgefüllt:

### Umrandung

Expand Down
2 changes: 1 addition & 1 deletion docs/src/pages/components/alert/alert-es.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Al establecer la propiedad `icono` a falso, el icono se removerá completamente.

{{"demo": "pages/components/alert/IconAlerts.js"}}

## Variants
## Variantes

Dos variantes adicionales están disponibles – delineada y rellena:

Expand Down
4 changes: 2 additions & 2 deletions docs/src/pages/components/app-bar/app-bar-es.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ function App() {
return (
<React.Fragment>
<AppBar position="fixed">
<Toolbar>{/* content */}</Toolbar>
<Toolbar>{/* contenido */}</Toolbar>
</AppBar>
<div className={classes.offset} />
</React.Fragment>
Expand Down Expand Up @@ -130,7 +130,7 @@ function HideOnScroll(props) {
const trigger = useScrollTrigger();
return (
<Slide in={!trigger}>
<div>Hello</div>
<div>Hola</div>
</Slide>
);
}
Expand Down
Loading

0 comments on commit e294394

Please sign in to comment.