diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/en/admins/05_Backup.md | 2 | ||||
| -rw-r--r-- | docs/en/internationalization.md | 5 | ||||
| -rw-r--r-- | docs/en/users/05_Configuration.md | 33 | ||||
| -rw-r--r-- | docs/en/users/08_sharing_services.md | 2 | ||||
| -rw-r--r-- | docs/en/users/10_filter.md | 2 | ||||
| -rw-r--r-- | docs/fr/internationalization.md | 10 | ||||
| -rw-r--r-- | docs/fr/users/05_Configuration.md | 34 |
7 files changed, 69 insertions, 19 deletions
diff --git a/docs/en/admins/05_Backup.md b/docs/en/admins/05_Backup.md index c4ad11cd0..061300a37 100644 --- a/docs/en/admins/05_Backup.md +++ b/docs/en/admins/05_Backup.md @@ -2,7 +2,7 @@ FreshRSS global settings are in `./data/config.php` and users' settings are in `./data/users/*/config.php`. You can also back up the whole `./data/` directory but exclude the things you do not want. -If you use extensions, then each directory in `./extensions` the folder `static` contains the user's extension settings. +If you use extensions, then each directory in `./extensions` the folder `static` contains the user’s extension settings. ## Full-Installation Backup diff --git a/docs/en/internationalization.md b/docs/en/internationalization.md index 741a642c7..f362760d4 100644 --- a/docs/en/internationalization.md +++ b/docs/en/internationalization.md @@ -1,6 +1,6 @@ # Contributing to internationalization (i18n) -Thanks to our contributors, FreshRSS is translated into more than 15 languages. This section will explain the basics of internationalization in FreshRSS, from translating the application to your own language to making a specific change. +Thanks to our contributors, FreshRSS is translated into [more than 20 languages](./users/05_Configuration.md#language). This section will explain the basics of internationalization in FreshRSS, from translating the application to your own language to making a specific change. ## Overview @@ -23,7 +23,6 @@ The translation files are quite simple: it’s only a matter of returning a PHP ```php <?php - return array( 'action' => [ 'actualize' => 'Actualiser', @@ -37,7 +36,7 @@ return array( 'about' => 'À propos de FreshRSS', ), // ... -]; +); ``` Each value can be referenced by a key: it consists of a series of identifiers separated by dots. The first identifier indicates from which file to extract the translation, while the following ones indicate array entries. Thus, the `gen.freshrss.about` key is referencing the `about` entry from the `freshrss` entry which is part of the main array returned by the `gen.php` file. This allows us to further organize our translation files. diff --git a/docs/en/users/05_Configuration.md b/docs/en/users/05_Configuration.md index 49dc90572..fc0f6c77d 100644 --- a/docs/en/users/05_Configuration.md +++ b/docs/en/users/05_Configuration.md @@ -3,13 +3,38 @@ ## Language -FreshRSS is currently available in 14 languages. After confirming your choice, the interface will be displayed in your preferred language. +FreshRSS is currently available in 22 languages. After confirming your choice, the interface will be displayed in your preferred language. Depending on the language chosen, parts of the interface may not be not translated yet. If you’re willing to help translate the missing bits or would like to add a new language, please take a look at how you can [contribute to the project](../contributing.md#contribute-to-internationalization-i18n). -Some parts of FreshRSS aren’t translated and aren’t intended to be translated either. For now, this includes the logs visible in the application as well as the log generated by automatic update scripts. - -Available languages are: cz, de, en, es, fr, he, it, ko, nl, oc, pt-br, ru, tr, zh-cn. +Some parts of FreshRSS are not translated and are not intended to be translated either. For now, this includes the logs visible in the application as well as the log generated by automatic update scripts. + +Available languages are: + +| Language (English name) | Language (Endonym) | Ordered by language code (ISO-639-1) | +|:------------------------|:-----------------------|:-------------------------------------| +| Czech | Čeština | cz | +| German | Deutsch | de | +| Greek | Ελληνικά | el | +| English | English | en | +| English (United States) | English (United States) | en-us | +| Spanish | Español | es | +| French | Français | fr | +| Hebrew | עברית | he | +| Indonesian | Bahasa Indonesia | id | +| Italian | Italiano | it | +| Japanease | 日本語 | ja | +| Korean | 한국어 | ko | +| Latvian | Latviešu | lv | +| Dutch | Nederlands | nl | +| Occitan | Occitan | oc | +| Polish | Polski | pl | +| Brazilian Portuguese | Português (Brasil) | pt-br | +| Russian | Русский | ru | +| Slovak | Slovenčina | sk | +| Turkish | Türkçe | tr | +| Chinese (Simplified, People’s Republic of China) | 简体中文 | zh-cn | +| Chinese (Traditional, Taiwan) | 正體中文 | zh-tw | ## Theme diff --git a/docs/en/users/08_sharing_services.md b/docs/en/users/08_sharing_services.md index ad156943c..ecf0ce239 100644 --- a/docs/en/users/08_sharing_services.md +++ b/docs/en/users/08_sharing_services.md @@ -8,7 +8,7 @@ FreshRSS has the option to share links with a bunch of services. |:--------------|:-------------------------------------------------------|:--------------------------------------------------------------| | Clipboard | Copy article link into the operation system clipboard | | | Email | Open the email app to send the article link | | -| Print | Open browser's print dialog to print out the article | | +| Print | Open browser’s print dialog to print out the article | | ## Available Services: Hosted Services diff --git a/docs/en/users/10_filter.md b/docs/en/users/10_filter.md index 2e69b97f8..60310c161 100644 --- a/docs/en/users/10_filter.md +++ b/docs/en/users/10_filter.md @@ -103,7 +103,7 @@ Combining several search criteria implies a logical *and*, but the keyword ` OR can be used to combine several search criteria with a logical *or* instead: `author:Dupont OR author:Dupond` You don’t have to do anything special to combine multiple negative operators. Writing `!intitle:'thing1' !intitle:'thing2'` implies AND, see above. For more pointers on how AND and OR interact with negation, see [this GitHub comment](https://github.com/FreshRSS/FreshRSS/issues/3236#issuecomment-891219460). -Additional reading: [De Morgan's laws](https://en.wikipedia.org/wiki/De_Morgan%27s_laws). +Additional reading: [De Morgan’s laws](https://en.wikipedia.org/wiki/De_Morgan%27s_laws). Finally, parentheses may be used to express more complex queries, with basic negation support: diff --git a/docs/fr/internationalization.md b/docs/fr/internationalization.md index 532ed457d..0a17e0cfd 100644 --- a/docs/fr/internationalization.md +++ b/docs/fr/internationalization.md @@ -1,5 +1,10 @@ # Gestion de la traduction +Grâce à nos contributeurs, FreshRSS est traduit dans [plus de 20 langues](./users/05_Configuration.md#language). +Cette section expliquera les bases de l’internationalisation dans FreshRSS, de la traduction de l’application dans votre propre langue à la réalisation d’un changement spécifique. + +## Aperçu + Il est fréquent (et c’est un euphémisme) de vouloir afficher des phrases à l’utilisateur. Dans l’exemple précédent par exemple, nous affichions un feedback à l’utilisateur en fonction du résultat d’une validation de @@ -31,7 +36,6 @@ retourner un tableau PHP contenant les traductions. Extrait du fichier ```php <?php - return array( 'action' => [ 'actualize' => 'Actualiser', @@ -44,9 +48,7 @@ return array( '_' => 'FreshRSS', 'about' => 'À propos de FreshRSS', ), -]; - -?> +); ``` Pour accéder à ces traductions, `Minz_Translate` va nous aider à l’aide de diff --git a/docs/fr/users/05_Configuration.md b/docs/fr/users/05_Configuration.md index c64572d01..9b290e46d 100644 --- a/docs/fr/users/05_Configuration.md +++ b/docs/fr/users/05_Configuration.md @@ -15,8 +15,32 @@ vocation à l’être. Pour le moment, les logs visibles dans l’application ainsi que celle générées par le script de mise à jour automatique en font partie. -Les langues disponibles sont : cz, de, en, es, fr, he, it, ko, nl, oc, -pt-br, ru, tr, zh-cn. +Les langues disponibles sont: + +| Langue (nom français) | Langue (endonyme) | Classé par code de langue (ISO-639-1) | +|:------------------------|:-----------------------|:-------------------------------------| +| Tchèque | Čeština | cz | +| Allemand | Deutsch | de | +| Grec | Ελληνικά | el | +| Anglais | English | en | +| Anglais (États-Unis) | English (United States) | en-us | +| Espagnol | Español | es | +| Français | Français | fr | +| Hébreu | עברית | he | +| Indonésien | Bahasa Indonesia | id | +| Italien | Italiano | it | +| Japonais | 日本語 | ja | +| Coréen | 한국어 | ko | +| Letton | Latviešu | lv | +| Néerlandais | Nederlands | nl | +| Occitan | Occitan | oc | +| Polonais | Polski | pl | +| Portugais brésilien | Português (Brasil) | pt-br | +| Russe | Русский | ru | +| Slovaque | Slovenčina | sk | +| Turc | Türkçe | tr | +| Chinois (simplifié, République populaire de Chine) | 简体中文 | zh-cn | +| Chinois (traditionnel, Taïwan) | 正體中文 | zh-tw | ## Thème @@ -27,16 +51,16 @@ propose 13 thèmes officiels : |:--------------|:-------------------------------------------------------|:--------------------------------------------------------------| | Alternative Dark | Ghost | | | Ansum | Thomas Guesnon | | -| Blue Lagoon |Mister aiR | N'est plus pris en charge. Sera supprimé avec FreshRSS V1.22.0 | +| Blue Lagoon |Mister aiR | N’est plus pris en charge. Sera supprimé avec FreshRSS V1.22.0 | | Dark | AD | | | Dark pink | Miicat_47 | | -| Flat design | Marien Fressinaud | N'est plus pris en charge. Sera supprimé avec FreshRSS V1.22.0 | +| Flat design | Marien Fressinaud | N’est plus pris en charge. Sera supprimé avec FreshRSS V1.22.0 | | Mapco | Thomas Guesnon | | | Nord theme | joelchrono12 | | | Origine | Marien Fressinaud | (default theme) | | Origine-compact | Kevin Papst | | | Pafat | Plopoyop | | -| Screwdriver | Mister aiR | N'est plus pris en charge. Sera supprimé avec FreshRSS V1.22.0 | +| Screwdriver | Mister aiR | N’est plus pris en charge. Sera supprimé avec FreshRSS V1.22.0 | | Swage | Patrick Crandol | | Si aucun de ceux proposés ne convient, il est toujours possible de [créer |