From b7cfe3a4f1f66b9f74d5dcfaa0219041b54495db Mon Sep 17 00:00:00 2001 From: Marie Viley <35461138+Mayie@users.noreply.github.com> Date: Tue, 26 Oct 2021 17:26:03 +0200 Subject: [PATCH] Update README_es.md --- docs/README_es.md | 278 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 278 insertions(+) diff --git a/docs/README_es.md b/docs/README_es.md index b797504..2a36b45 100644 --- a/docs/README_es.md +++ b/docs/README_es.md @@ -63,3 +63,281 @@ const templuralDeCH = forLocales('de_CH') // German (Switzerland) Para obtener más información sobre los valores aceptados por `templural.setLocales()` y `forLocales()` ver [argumento locales](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Intl#locales). Los ejemplos siguintos estan especificos en espagnol, ver [Internacionalización](#%EF%B8%8F-internacionalización) para las informaciones sobre los otros idiomas. + +### Relacionar una palabra con un número anterior + +```js +templural`Yoann y Valentin tuvieron ${númerodeideas} idea{s} interesante{s}` +// númeroDeIdeas = 1 ➔ "Yoann y Valentin tuvieron 1 idea interesante" +// númeroDeIdeas = 2 ➔ "Yoann y Valentin tuvieron 2 ideas interesantes" +// númeroDeIdeas = 42 ➔ "Yoann y Valentin tuvieron 42 ideas interesantes" +// númeroDeIdeas = 0 ➔ "Yoann y Valentin tuvieron 0 ideas interesantes" +``` + +### Inserta cualquier otro valor en el texto + +```js +templural`${userName} tiene ${nbPuntos} punto{s}` +// userName = "Joe", nbPuntos = 1 ➔ "Joe tiene 1 punto" +// userName = "Mario", nbPuntos = 1000 ➔ "Mario tiene 1000 puntos" +``` + +### Relacionar varias palabras con el mismo número anterior + +```js +templural`Solo bebí ${nbCervezas} cerveza{s} querida{s}, lo juro{s}` +// nbCervezas = 1 ➔ "Solo bebí 1 cerveza querida, lo juro" +// nbCervezas = 2 ➔ "Solo bebí 2 cervezas querida, lo juro" +// nbCervezas = 6 ➔ "Solo bebí 6 cervezas querida, lo juro" +``` + +### Relacionar varias palabras cada una con un número anterior diferente + +```js +templural`Compré ${nbZanahorias} zanahoria{s} y ${nbPapas} papa{s}` +// nbZanahorias = 1, nbPapas = 1 ➔ "Compré 1 zanahoria y 1 papa" +// nbZanahorias = 1, nbPapas = 3 ➔ "Compré 1 zanahoria y 3 papas" +// nbZanahorias = 2, nbPapas = 1 ➔ "Compré 2 zanahorias y 1 papa" +// nbZanahorias = 2, nbPapas = 3 ➔ "Compré 2 zanahorias y 3 papas" +``` + +### Palabras con una forma diferente en singular y plural + +```js +templural`${nbConnected} {person;people} {is;are} connected` +// nbConnected = 1 ➔ "1 person is connected" +// nbConnected = 2 ➔ "2 people are connected" +// nbConnected = 666 ➔ "666 people are connected" +``` + +### Mezclar todos los ejemplos anteriores + +```js +templural`${nbDogs} dog{s} bark{s;} and ${nbCats} cat{s} meow{s;}` +// nbDogs = 1, nbCats = 1 ➔ "1 dog barks and 1 cat meows" +// nbDogs = 2, nbCats = 1 ➔ "2 dogs bark and 1 cat meows" +// nbDogs = 1, nbCats = 2 ➔ "1 dog barks and 2 cats meow" +// nbDogs = 2, nbCats = 2 ➔ "2 dogs bark and 2 cats meow" +``` + +### Match a word to a *non preceding* number + +```js +templural`There {$1;is;are} ${nbWhales} flying whale{s}` +// nbWhales = 1 ➔ "There is 1 flying whale" +// nbWhales = 2 ➔ "There are 2 flying whales" +``` + +`$1` references the first interpolated expression. + +Use `$2`, `$3` or `$n` to reference the second, the third or the nth interpolated expression. + +### Sintaxis asociativa + +En algunos casos, se puede utilizar la sintaxis asociativa para evitar valores vacíos: + +```js +templural`${nbDogs} dog{s} bark{s;} and ${nbCats} cat{s} meow{s;}` +// may be replaced by +templural`${nbDogs} dog{s} bark{one:s} and ${nbCats} cat{s} meow{one:s}` +``` + +**⚠️ La sintaxis asociativa no debe mezclarse con la sintaxis ordenada:** + +```js +// this is OK: +templural`${nbConnected} {one:person;other:people} connected` +// this is NOT OK: +templural`${nbConnected} {one:person;people} connected` +``` + +## 🗣️ Internacionalización + +templural está construido sobre [Intl.PluralRules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules) y se puede utilizar para formatear frases en cualquier idioma. + +Este README está disponible en los siguientes idiomas: + + - [🇫🇷 Français](https://github.com/nlepage/templural/blob/main/docs/README_fr.md) + - [🇩🇪 Deutsch](https://github.com/nlepage/templural/blob/main/docs/README_de.md) + +### Reglas plurales + +Cada idioma tiene diferentes reglas de plural. + +For example English has two plural categories, `"one"` for singular, and `"other"` for plural: + +```js +templural.setLocales('en') +templural`${n} is in the {one;other} category` +// n = 1 ➔ "1 is in the one category" +// n = 2 ➔ "2 is in the other category" +// n = 1000000 ➔ "1000000 is in the other category" +// n = 0 ➔ "0 is in the other category" +``` + +French is a little different from English, it has a third category `"many"` for some large numbers, and 0 is singular: + +```js +templural.setLocales('fr') +templural`${n} is in the {one;other;many} category` +// n = 1 ➔ "1 is in the one category" +// n = 2 ➔ "2 is in the other category" +// n = 1000000 ➔ "1000000 is in the many category" +// n = 0 ➔ "0 is in the one category" +``` + +See [Language Plural Rules](https://unicode-org.github.io/cldr-staging/charts/latest/supplemental/language_plural_rules.html) for information about plural rules in any language. + +templural's behavior may be customized using three mechanisms: + + - [Category priority](#category-priority) + - [Category order](#category-order) + - [Category fallback](#category-fallback) + +`templural.setLocales()` and `forLocales()` accept `LocalesOptions` as second parameter, see [locales.ts](https://github.com/nlepage/templural/blob/main/src/locales.ts). + +### Category priority + +Category priority defines which categories are valued when not giving values for all categories. + +If priority is: + +1. `many` +2. `other` +3. `one` + +Then: + +```js +// giving only one value is for category many +templural`${n} is {many}` +// giving two values is for categories other and many +templural`${n} is {other;many}` +// giving three values is for categories one, other and many +templural`${n} is {one;other;many}` +``` + +The default priority (regardless of locale) is: + +1. `other` +2. `one` +3. `two` +4. `few` +5. `many` +6. `zero` + +This default priority is filtered to include only categories of the selected locale, for example in English: + +1. `other` +2. `one` + +Some languages may have a different default priority, see [locales.ts](https://github.com/nlepage/templural/blob/main/src/locales.ts). + +### Category order + +Category order defines the order in which categories are valued (regardless of their priority). + +If order is: + +1. `many` +2. `other` +3. `one` + +Then: + +```js +// giving two values is other then one (many has a lower priority) +templural`${n} is {other;one}` +// giving three values is many then other then one +templural`${n} is {many;other;one}` +``` + +The default order (regardless of locale) is: + +1. `zero` +2. `one` +3. `two` +4. `few` +5. `many` +6. `other` + +This default order is filtered to include only categories of the locale, for example in English: + +1. `one` +2. `other` + +Some languages may have a different default order, see [locales.ts](https://github.com/nlepage/templural/blob/main/src/locales.ts). + +### Category fallback + +Certain languages may need a category to fallback to another category. + +For example in French, `many` behaves like a sub-category of `other`, which means `many` needs to fallback to `other`: + +```js +templural`${1000000} is {one;other;many} and falls back to {one;other}` +// ➔ "1000000 is many and falls back to other" +``` + +Some languages may have default fallbacks, see [locales.ts](https://github.com/nlepage/templural/blob/main/src/locales.ts). + +## ❓ FAQ + +### What about negative or floating numbers or any other value? + +templural doesn't care, it relies on [Intl.PluralRules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules). + +### Any new features planned? + +Not for the moment. + +templural is simple and dumb, and it will probably stay like this. + +### Any other questions? + +Use the [Discussions tab](https://github.com/nlepage/templural/discussions). + +## Contributors ✨ + + + + + +

Nicolas Lepage
✍️
+ +Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)): + + + + + + + + + + + + +

Valentin Cocaud
🤔
Yoann Prot
🤔
Svetlana A.
📖 🌍
Marie Viley
📖 🌍
Patrice De Saint Steban
📖
+ + + + + + +This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! + +## 🤝 Contributing + +Contributions, issues and feature requests are welcome! Check out our [Contributing guide](https://github.com/nlepage/templural/blob/main/docs/CONTRIBUTING.md) for more information. + +Para fomentar un entorno abierto y acogedor, hemos adoptado [a Code of Conduct](https://github.com/nlepage/templural/blob/main/docs/CODE_OF_CONDUCT.md) con el que esperamos que los participantes del proyecto se comprometan. Lea el texto completo para comprender qué comportamiento se tolerará o no. + +## Muestre su apoyo + +¡Da un ⭐️ y / o patrocinador si este proyecto te ayudó! + +## 📝 licencia + +Copyright © 2021 [Nicolas Lepage](https://github.com/nlepage).
+Este proyecto tiene [Apache-2.0](https://spdx.org/licenses/Apache-2.0.html) licencia.