Skip to content

Commit

Permalink
Merge fourth draft for final testing
Browse files Browse the repository at this point in the history
  • Loading branch information
gizmecano committed Nov 20, 2020
2 parents 173ab21 + f26d35e commit 1ef3358
Show file tree
Hide file tree
Showing 265 changed files with 2,735 additions and 1,564 deletions.
3 changes: 3 additions & 0 deletions .editorconfig
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,6 @@ indent_style = space
indent_size = 2
charset = utf-8
insert_final_newline = true

[*.csv]
insert_final_newline = false
9 changes: 5 additions & 4 deletions .gitattributes
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,10 @@
* text=auto

# Ignored files for export
[Dd]esktop.ini export-ignore
*.git* text export-ignore
/.github/ export-ignore
.editorconfig export-ignore
.git* export-ignore
[Dd]esktop.ini export-ignore
/.github/ISSUE_TEMPLATE export-ignore

# Files always having CRLF line endings
*.php text eol=crlf
*.php text eol=crlf
12 changes: 0 additions & 12 deletions .github/ISSUE_TEMPLATE/addition.md

This file was deleted.

20 changes: 20 additions & 0 deletions .github/ISSUE_TEMPLATE/append.md
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`
17 changes: 17 additions & 0 deletions .github/ISSUE_TEMPLATE/revamp.md
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>`

10 changes: 10 additions & 0 deletions .github/ISSUE_TEMPLATE/review.md
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.
24 changes: 24 additions & 0 deletions .github/ISSUE_TEMPLATE/revise.md
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`
104 changes: 104 additions & 0 deletions .github/README-fr.md
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)
104 changes: 104 additions & 0 deletions .github/README.md
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)
Loading

0 comments on commit 1ef3358

Please sign in to comment.