-
Notifications
You must be signed in to change notification settings - Fork 5
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge fourth draft for final testing
- Loading branch information
Showing
265 changed files
with
2,735 additions
and
1,564 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,20 @@ | ||
--- | ||
name: append | ||
about: Append new folder <> and/or new file in <> | ||
title: Append new folder <> and/or new file in <> | ||
labels: 'addition' | ||
assignees: gizmecano | ||
|
||
--- | ||
|
||
Add new folder (major) | ||
|
||
- [ ] `<foldername>` | ||
|
||
Add new file in existing folder (minor) | ||
|
||
- [ ] `<foldername>/filename.php` | ||
|
||
Add new string in existing file (patch) | ||
|
||
- [ ] `<foldername>/filename.php` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,17 @@ | ||
--- | ||
name: revamp | ||
about: Revamp files from <> toward <> | ||
title: Revamp files from <> toward <> | ||
labels: 'handling' | ||
assignees: gizmecano | ||
|
||
--- | ||
|
||
Move existing folder to other path (major) | ||
|
||
- [ ] `<foldername>` | ||
|
||
Move existing file from existing folder to other one (minor) | ||
|
||
- [ ] `<foldername>` | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
--- | ||
name: review | ||
about: Review changes in OpenCart release (3.x.x.x) | ||
title: Review changes in OpenCart release (3.x.x.x) | ||
labels: 'management' | ||
assignees: gizmecano | ||
|
||
--- | ||
|
||
Review changes that have appeared in a stable version of OpenCart (3.x.x.x) and create the correlated tasks for the language pack. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
--- | ||
name: revise | ||
about: Revise existing files in <> | ||
title: Revise existing files in <> | ||
labels: 'revision' | ||
assignees: gizmecano | ||
|
||
--- | ||
|
||
Delete obsolete folder (major) | ||
|
||
- [ ] `<foldername>` | ||
|
||
Delete obsolete file in existing folder (minor) | ||
|
||
- [ ] `<foldername>/filename.php` | ||
|
||
Delete obsolete string in existing file (patch) | ||
|
||
- [ ] `<foldername>/filename.php` | ||
|
||
Revise or fix existing string in existing file (patch) | ||
|
||
- [ ] `<foldername>/filename.php` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,104 @@ | ||
# opencart-3-fr | ||
|
||
[English](README.md) | Français | ||
|
||
## Introduction | ||
|
||
**opencart-3-fr** est un pack de langue française pour la plateforme de commerce en ligne [OpenCart](http://www.opencart.com/) (à partir de la version 3.0.2.0). | ||
|
||
Ce pack comprend des traductions de fichiers pour une localisation française de l'interface d'administration (_backend_) ainsi que de la boutique en ligne (_frontend_). | ||
|
||
### Contexte | ||
|
||
Ce projet succède à [**opencart-2-fr**](https://github.com/gizmecano/opencart-2-fr/), développé et maintenu de 2015 à 2018, mais la plupart des traductions ont été entièrement retravaillées à partir des sources originales. | ||
|
||
### Principes | ||
|
||
Ce pack linguistique a été développé avec certains principes de base à l'esprit, à savoir: | ||
|
||
- **traductions idiomatiques** : les chaînes de traduction n'ont pas a été générées automatiquement, mais en comprenant le contexte afin de retranscrire la formulation la plus appropriée | ||
- **Prise en charge native de l'`utf-8`** : les caractères accentués et la plupart des signes typographiques communs utilisent le codage `utf-8` standard | ||
- **usages typographiques appropriés** : les règles et les usages typographiques en vigueur dans la rédaction en langue française (espaces et ponctuations notamment) sont respectés | ||
- **jargon technique discret**: les références techniques sont traduites de la manière la plus compréhensible possible | ||
- **formulations non sexistes**: afin d'être aussi inclusives que possible, les traductions utilisent de préférence des tournures ne faisant pas référence au genre des utilisateurs ou des visiteurs | ||
|
||
### Variantes | ||
|
||
Contrairement au projet qui l'a précédé, ce pack de langue est disponible en deux variantes différentes, toutes deux développées à partir d'une même unique plateforme commune. | ||
|
||
1. la variante libre contient l'ensemble des fichiers nécessaires pour le fonctionnement de base d'une boutique OpenCart : elle devrait s'avérer suffisante dans la plupart des cas | ||
2. la version complète contient des fichiers supplémentaires requis pour une traduction de diverses extensions liées à des services propriétaires : passerelles de paiements, mode d'expédition, etc. | ||
|
||
Cette distinction est due à plusieurs facteurs: | ||
|
||
- conserver une version de base aussi légère que possible pour la plupart des utilisateurs n'utilisant pas les extensions supplémentaires | ||
- essayer de compenser le temps souvent important passer à traduire des fichiers parfois volumineux mais non nécessaires à une majorité d'utilisateurs | ||
|
||
Les fichiers uniquement présents dans la version complète sont listés dans un [document spécifique](cleavage.csv). | ||
|
||
## Installation | ||
|
||
Chaque fois que vous envisagez d'installer un nouvel élément sur un site Opencart existant (module ou pack linguistique), il est fortement recommandé de le tester au préalable sur un environnement de développement local avant de l'installer sur le site de production. | ||
|
||
Pour installer ce pack linguistique, extraire le fichier compressé localement puis transférer les fichiers sur le serveur (en conservant la même structure) sur la base d'un site OpenCart précédemment installé. | ||
|
||
Une fois cela fait, afficher l'interface d'administration d'OpenCart et suivre les étapes ci-dessous (à partir d'une installation par défaut en anglais): | ||
|
||
1. Aller dans la rubrique `System -> Localisation -> Languages` | ||
2. Cliquer sur le bouton `Add New` | ||
3. Renseigner les valeurs suivantes : | ||
- _Language Name_ : `French` | ||
- _Code_ : `fr` | ||
- _Locale_ : `fr,fr-FR,fr_FR.UTF-8,french` | ||
- _Status_ : `Enabled` | ||
- _Sort Order_: `1` | ||
4. Enregistrer ces modifications | ||
5. Aller dans la rubrique `System -> Settings` | ||
6. Cliquer sur l'onglet `Local` et définir les langues standards pour la boutique (_Language_) et le panneau d'administration (_Administration language_) : la langue de l'administration ne changera pas **avant** cette étape) | ||
7. Enregistrer ces modifications | ||
8. Installation terminée | ||
|
||
## Flux des travaux | ||
|
||
### Versionnage | ||
|
||
Le processus de travail sur ce pack de langue se propose de suivre la spécification de la [gestion sémantique de version](https://semver.org/lang/fr/) selon les étapes ci-dessous: | ||
|
||
1. `majeure` (niveau chemin) | ||
- ajouter un nouveau répertoire | ||
- déplacer un répertoire existant à un autre emplacement | ||
- supprimer un répertoire obsolète | ||
2. `mineur` (niveau fichier) | ||
- ajouter un nouveau fichier dans un répertoire existant | ||
- déplacer un fichier existant depuis un répertoire existant à un autre emplacement | ||
- supprimer un fichier obsolète dans un répertoire existant | ||
3. `correctif` (niveau objet) | ||
- ajouter une nouvelle chaîne dans un fichier existant | ||
- réviser ou corriger une chaîne existante dans un fichier existant | ||
- supprimer une chaîne existante dans un fichier existant | ||
|
||
### Contribution | ||
|
||
Toutes suggestions ou propositions (traduction, optimisation, etc.) peuvent être prises en compte en [ouvrant une question](https://github.com/gizmecano/opencart-3-fr/issues) dans le dépôt de la variante libre. | ||
|
||
## Impressum | ||
|
||
### Licence | ||
|
||
opencart-3-fr : un pack de localisation française _opensource_ pour la plateforme de commerce en ligne OpenCart (à partir de la version 3.0.2.0) | ||
|
||
-------------------------------------------------------------------------------- | ||
|
||
Copyright © 2019-2020 P. Mergey | ||
|
||
Ce programme est un logiciel libre : vous pouvez le redistribuer et/ou le modifier au titre des clauses de la [Licence publique générale GNU](LICENSE.md), telle que publiée par la Free Software Foundation, soit la version 3 de la licence ou, à votre discrétion, une version ultérieure quelconque. | ||
|
||
Ce programme est distribué dans l'espoir qu'il sera utile, mais **SANS AUCUNE GARANTIE**, sans même une garantie implicite de **COMMERCIABILITE** ou **DE CONFORMITE A UNE UTILISATION PARTICULIERE**. Voir la [Licence publique générale GNU](LICENSE.md) pour plus de détails. | ||
|
||
Vous devriez avoir reçu un exemplaire de la [Licence publique générale GNU](LICENSE.md) avec ce programme. Si ce n'est pas le cas, vous pouvez consulter [cette page](https://www.gnu.org/licenses/gpl-3.0.fr.html). | ||
|
||
### Crédits | ||
|
||
Les illustrations ont été réalisées en utilisant: | ||
- la photographie _Wild Rooster_ de [榮達 陳](https://unsplash.com/@dareen0987), publiée sur [Unsplash](https://unsplash.com/photos/iHzpnUYS3Zc) sous [licence Unsplash](https://unsplash.com/license) | ||
- la police de caractères [Inter](https://rsms.me/inter/) par Rasmus Andersson, disponible sur [GitHub](https://github.com/rsms/inter) sous [licence SIL](http://scripts.sil.org/OFL) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,104 @@ | ||
# opencart-3-fr | ||
|
||
English | [Français](README-fr.md) | ||
|
||
## Overview | ||
|
||
**opencart-3-fr** is a French language pack for the ecommerce platform [OpenCart](http://www.opencart.com/) (from version 3.0.2.0). | ||
|
||
This pack brings together translated files for a French localization of the administration interface (_backend_) as well as the online store (_frontend_). | ||
|
||
### Background | ||
|
||
This project succeeds to [**opencart-2-fr**](https://github.com/gizmecano/opencart-2-fr/), developed and maintained from 2015 to 2018, but most of the translations have been completely reworked from scratch. | ||
|
||
### Principles | ||
|
||
This language pack has been developed with some basic principles in mind: | ||
|
||
- **idiomatic translations**: translation strings did not have been automatically generated, but by understanding the context in order to draft an appropriate formulation | ||
- **native `utf-8` support**: accented characters and most common typographic signs use standard `utf-8` encoding | ||
- **proper typographics usages**: typographic rules and practices used in the French language redaction (spaces and punctuation marks in particular) are respected | ||
- **understated technical jargon**: technical references are translated in the most understandable manner possible | ||
- **gender-neutral formulations**: in order to be as inclusive as possible, translations preferably use language that does not use the gender of users or visitors | ||
|
||
### Variants | ||
|
||
Unlike the project that preceded it, this language pack is available in two different variants, both developed from a single common platform. | ||
|
||
1. the free variant contains all the files necessary for the basic running of an OpenCart store: it should be sufficient in most cases | ||
2. the full version contains additional files required for translating various extensions related to proprietary services: payment gateways, shipping methods, etc. | ||
|
||
This distinction is due to several factors: | ||
|
||
- keeping a basic version as lighter as possible for most users which are not using the additional extensions | ||
- attempting to balance for often significant time spent translating files which are sometimes large but not necessary for a majority of users | ||
|
||
The files only included in the full version are listed in an [specific document](cleavage.csv). | ||
|
||
## Installation | ||
|
||
Whenever you plan to install a new item on an existing Opencart website (module or language pack), it is strongly recommended that you test it first on a local development environment before installing it on the production site. | ||
|
||
To install this language pack, extract the zipped package locally and transfer the files to the server (keeping the same structure) on the roots of a previously installed OpenCart website. | ||
|
||
After that, open your OpenCart backend and follow the steps below: | ||
|
||
1. Navigate to `System -> Localisation -> Languages` | ||
2. Click the `Add New` button | ||
3. Fill in the following values : | ||
- _Language Name_ : `French` | ||
- _Code_ : `fr` | ||
- _Locale_ : `fr,fr-FR,fr_FR.UTF-8,french` | ||
- _Status_ : `Enabled` | ||
- _Sort Order_: `1` | ||
4. Save these changes | ||
5. Navigate to `System -> Settings` | ||
6. Click on the tab `Local` and define the standard languages for frontend (_Language_) and backend (_Administration language_): backend language will not change **before** this step | ||
7. Save these changes | ||
8. Installation is complete | ||
|
||
## Workflow | ||
|
||
### Versioning | ||
|
||
The working process on this language pack aims to follow [semantic versioning specification](https://semver.org/) according to the steps bellow: | ||
|
||
1. `major` (path level) | ||
- add new folder | ||
- move existing folder to other path | ||
- delete obsolete folder | ||
2. `minor` (file level) | ||
- add new file in existing folder | ||
- move existing file from existing folder to other one | ||
- delete obsolete file in existing folder | ||
3. `patch` (item level) | ||
- add new string in existing file | ||
- revise or fix existing string in existing file | ||
- delete obsolete string in existing file | ||
|
||
## Contribution | ||
|
||
Any suggestions or submissions (translation, optimisation, etc.) might be considered by [opening an issue](https://github.com/gizmecano/opencart-3-fr/issues) into the free variant repository. | ||
|
||
## Imprint | ||
|
||
### License | ||
|
||
opencart-3-fr: a French opensource localization pack for ecommerce platform OpenCart (from version 3.0.2.0) | ||
|
||
-------------------------------------------------------------------------------- | ||
|
||
Copyright © 2019-2020 P. Mergey | ||
|
||
This program is free software: you can redistribute it and/or modify it under the terms of the [GNU General Public License](LICENSE.md) as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. | ||
|
||
This program is distributed in the hope that it will be useful, but **WITHOUT ANY WARRANTY**; without even the implied warranty of **MERCHANTABILITY** or **FITNESS FOR A PARTICULAR PURPOSE**. See the [GNU General Public License](LICENSE.md) for more details. | ||
|
||
You should have received a copy of the [GNU General Public License](LICENSE.md) along with this program. If not, see [this page](https://www.gnu.org/licenses/gpl-3.0.en.html). | ||
|
||
### Credits | ||
|
||
Illustrations were composed using: | ||
- _Wild Rooster_ photo by [榮達 陳](https://unsplash.com/@dareen0987), published on [Unsplash](https://unsplash.com/photos/iHzpnUYS3Zc) under [Unsplash license](https://unsplash.com/license) | ||
- [Inter](https://rsms.me/inter/) font by Rasmus Andersson, available on [GitHub](https://github.com/rsms/inter) under [SIL license](http://scripts.sil.org/OFL) |
Oops, something went wrong.