VsWiki - User contributions [en]

Development:Translation:FrenchWorkTree:Github

2014-03-17T07:45:24Z

Costalfy: /* Installation de git : */

==Installation de git :==

* S'inscrire sur Github : https://github.com/
* Installer Git
** Sous Linux ou Solaris, le paquet git fait partie de la plupart des distributions. Cette page : http://git-scm.com/download/linux donne la ligne de commande pour l'installer.
** Sous Windows ou MacOsX, télécharger et installer l'exécutable (http://git-scm.com/downloads)

Github a développé un client pour [http://windows.github.com/ windows] et pour [http://mac.github.com/ mac]. A tester pour voir si simplifie les choses lorsqu'on n'a pas d'IDE

==Récupération du dépôt distant==
* Sur son PC, créer un dossier qui servira de répertoire de travail
* Dans une ligne de commande et après s'être placé dans le nouveau dossier, taper : '''git clone https://github.com/costalfy/Vega-Strike.git''' 
Le dépôt s'installe dans le nouveau dossier, avec tout ce qu'il faut pour travailler, créer des commit, des branches, comparer les versions, etc...
*Vous pouvez commencer à modifier les fichiers. (ie dans notre cas, entourer les textes traduisibles par '''_( )''' ). N'hésitez pas à lire [[Development:Translations:FrenchWorkTree:Notes|les remarques]] sur ce qui est à traduire et ce qui ne l'est pas

==Gestion de la version locale et de la version en ligne==
De temps en temps, vous ferez des commits. Il s'agit d'une photographie du code à l'instant t, que vous pourrez envoyer en ligne. 

* '''git status''' (à taper dans le dossier de travail, à l'aide d'une ligne de commande) : renvoie la liste des fichiers qui ont été modifiés depuis votre dernier commit (donc, ceux qui sont susceptibles de faire partie du prochain commit).
* '''git add fichier.py''' ajoute le fichier à la liste de ceux qui feront partie du prochain commit Rq : '''git add -A''' ajoute tous les fichiers qui ont été modifiés.
* '''git commit''' Crée le commit (la photo du code.) Vous pouvez ajouter un texte qui explique ce qui a été modifié.
* '''git push origin''' envoie sur Github le commmit que vous venez d'effectuer. Vos login et mot de passe "Github" vous seront demandés.
* [[FIXME]] Comment faire une pull request?
* '''git pull origin master''' tire depuis Github la dernière version du code, qui sera peut-être différente de celle que vous avez sur votre PC. Si ces différences rendent les deux versions incompatibles, il faudra utiliser un comparateur de fichiers pour régler vous-même les incohérences (par exemple, Meld). Dans ce cas : 
** '''git fetch origin''' récupère la version en ligne mais en la fusionne pas avec la version locale)
** '''git merge origin''' tente de fusionner les deux versions. S'il n'y a pas d'incompatibilité, Git fusionne et le dit. Sinon,
** '''git mergetool''' permet de lancer un comparateur graphique des fichiers différents entre la version en ligne et la version locale. A vous de choisir ligne à ligne la bonne version.

Ce wiki concernant Vega Strike, seules les commandes basiques ont été présentées. Pour plus de renseignements sur git et github, voir : http://git-scm.com/doc

Development:Translation:FrenchWorkTree:Github

2014-03-17T07:45:11Z

Costalfy: /* Installation de git : */

==Installation de git :==

* S'inscrire sur Github : https://github.com/
* Installer Git
** Sous Linux ou Solaris, le paquet git fait partie de la plupart des distributions. Cette page : http://git-scm.com/download/linux donne la ligne de commande pour l'installer.
** Sous Windows ou MacOsX, télécharger et installer l'exécutable (http://git-scm.com/downloads)

Github à développer un client pour [http://windows.github.com/ windows] et pour [http://mac.github.com/ mac]. A tester pour voir si simplifie les choses lorsqu'on n'a pas d'IDE

==Récupération du dépôt distant==
* Sur son PC, créer un dossier qui servira de répertoire de travail
* Dans une ligne de commande et après s'être placé dans le nouveau dossier, taper : '''git clone https://github.com/costalfy/Vega-Strike.git''' 
Le dépôt s'installe dans le nouveau dossier, avec tout ce qu'il faut pour travailler, créer des commit, des branches, comparer les versions, etc...
*Vous pouvez commencer à modifier les fichiers. (ie dans notre cas, entourer les textes traduisibles par '''_( )''' ). N'hésitez pas à lire [[Development:Translations:FrenchWorkTree:Notes|les remarques]] sur ce qui est à traduire et ce qui ne l'est pas

==Gestion de la version locale et de la version en ligne==
De temps en temps, vous ferez des commits. Il s'agit d'une photographie du code à l'instant t, que vous pourrez envoyer en ligne. 

* '''git status''' (à taper dans le dossier de travail, à l'aide d'une ligne de commande) : renvoie la liste des fichiers qui ont été modifiés depuis votre dernier commit (donc, ceux qui sont susceptibles de faire partie du prochain commit).
* '''git add fichier.py''' ajoute le fichier à la liste de ceux qui feront partie du prochain commit Rq : '''git add -A''' ajoute tous les fichiers qui ont été modifiés.
* '''git commit''' Crée le commit (la photo du code.) Vous pouvez ajouter un texte qui explique ce qui a été modifié.
* '''git push origin''' envoie sur Github le commmit que vous venez d'effectuer. Vos login et mot de passe "Github" vous seront demandés.
* [[FIXME]] Comment faire une pull request?
* '''git pull origin master''' tire depuis Github la dernière version du code, qui sera peut-être différente de celle que vous avez sur votre PC. Si ces différences rendent les deux versions incompatibles, il faudra utiliser un comparateur de fichiers pour régler vous-même les incohérences (par exemple, Meld). Dans ce cas : 
** '''git fetch origin''' récupère la version en ligne mais en la fusionne pas avec la version locale)
** '''git merge origin''' tente de fusionner les deux versions. S'il n'y a pas d'incompatibilité, Git fusionne et le dit. Sinon,
** '''git mergetool''' permet de lancer un comparateur graphique des fichiers différents entre la version en ligne et la version locale. A vous de choisir ligne à ligne la bonne version.

Ce wiki concernant Vega Strike, seules les commandes basiques ont été présentées. Pour plus de renseignements sur git et github, voir : http://git-scm.com/doc

Development:Translation:FrenchWorkTree:Github

2014-03-17T07:43:10Z

Costalfy: /* Récupération du dépôt distant */

==Installation de git :==

* S'inscrire sur Github : https://github.com/
* Installer Git
** Sous Linux ou Solaris, le paquet git fait partie de la plupart des distributions. Cette page : http://git-scm.com/download/linux donne la ligne de commande pour l'installer.
** Sous Windows ou MacOsX, télécharger et installer l'exécutable (http://git-scm.com/downloads)

==Récupération du dépôt distant==
* Sur son PC, créer un dossier qui servira de répertoire de travail
* Dans une ligne de commande et après s'être placé dans le nouveau dossier, taper : '''git clone https://github.com/costalfy/Vega-Strike.git''' 
Le dépôt s'installe dans le nouveau dossier, avec tout ce qu'il faut pour travailler, créer des commit, des branches, comparer les versions, etc...
*Vous pouvez commencer à modifier les fichiers. (ie dans notre cas, entourer les textes traduisibles par '''_( )''' ). N'hésitez pas à lire [[Development:Translations:FrenchWorkTree:Notes|les remarques]] sur ce qui est à traduire et ce qui ne l'est pas

==Gestion de la version locale et de la version en ligne==
De temps en temps, vous ferez des commits. Il s'agit d'une photographie du code à l'instant t, que vous pourrez envoyer en ligne. 

* '''git status''' (à taper dans le dossier de travail, à l'aide d'une ligne de commande) : renvoie la liste des fichiers qui ont été modifiés depuis votre dernier commit (donc, ceux qui sont susceptibles de faire partie du prochain commit).
* '''git add fichier.py''' ajoute le fichier à la liste de ceux qui feront partie du prochain commit Rq : '''git add -A''' ajoute tous les fichiers qui ont été modifiés.
* '''git commit''' Crée le commit (la photo du code.) Vous pouvez ajouter un texte qui explique ce qui a été modifié.
* '''git push origin''' envoie sur Github le commmit que vous venez d'effectuer. Vos login et mot de passe "Github" vous seront demandés.
* [[FIXME]] Comment faire une pull request?
* '''git pull origin master''' tire depuis Github la dernière version du code, qui sera peut-être différente de celle que vous avez sur votre PC. Si ces différences rendent les deux versions incompatibles, il faudra utiliser un comparateur de fichiers pour régler vous-même les incohérences (par exemple, Meld). Dans ce cas : 
** '''git fetch origin''' récupère la version en ligne mais en la fusionne pas avec la version locale)
** '''git merge origin''' tente de fusionner les deux versions. S'il n'y a pas d'incompatibilité, Git fusionne et le dit. Sinon,
** '''git mergetool''' permet de lancer un comparateur graphique des fichiers différents entre la version en ligne et la version locale. A vous de choisir ligne à ligne la bonne version.

Ce wiki concernant Vega Strike, seules les commandes basiques ont été présentées. Pour plus de renseignements sur git et github, voir : http://git-scm.com/doc

Fr:Development:Translations:ArboTravailFr

2014-03-17T07:41:04Z

Costalfy: /* Procédure */

= Mise en place =
Un nouveau repository a été créé sur github https://github.com/costalfy/Vega-Strike contenant le repertoire data du trunk de sourceforge en date du 13/04/2014 (r13675)
J'ai été obligé de supprimer les fichiers suivant pour éviter de faire exploser mon quota :
* *.bmp
* *.psd
* *.jpg
* *.png
* *.ogg
* *.texture
* *.image
* *.bfxm
* /textures

J'ai créé un nouveau repertoire i18n/LC_MESSAGES qui contiendra les fichiers à traduire 
Quelques indications pour l'utilisation du dépôt Vega Strike sous Github ici : [[Development:Translation:FrenchWorkTree:Github |Github]]

= Procédure =
Merci de prendre connaissance de la manière de [[Development:Translation:FrenchWorkTree:Github|travailler avec github]] ainsi que [[Development:Translations:FrenchWorkTree:Notes|les remarques sur ce qui est à traduire]] dans le code source
== Ajouter la balise gettext dans le code source ==
Ajouter l'internationalisation dans le code python ou c++ est assez simple à réaliser.
Il faut scanner le code source et repérer le texte anglais hardcodé. Ensuite, pour chaque texte, il faut l'enrober de la balise gettext '''_(...)''' comme ceci :

Base.Message("No? Come back to me again if you change your mind.")
devient :
Base.Message(_("No? Come back to me again if you change your mind."))

un exemple est déjà visible sur le repository https://github.com/costalfy/Vega-Strike/commit/9cf2078c3fc39681404e59512b2a86503b49f887

[[Development:Translations:FrenchWorkTree:Notes | Notes sur les textes traduisibles ou non par type de fichier]]

== Générer le .po depuis le code source avec PoEdit ==
Lorsque tout le code source aura été scanné, on utilisera le logiciel [http://www.poedit.net/ PoEdit] pour scanner le code source et repérer toutes les balises _(...) qu'on aura ajouté.
Le logiciel créera le fichier vegastrike-fr_FR.po qui contiendra l'extration de tout le texte à traduire... magique :)

== Traduire le .po avec PoEdit ==
Les traducteurs utiliseront le meme logiciel pour ouvrir le fichier /data/i18n/LC_MESSAGES/vegastrike-fr_FR.po et devront traduire chaque ligne une par une... ça c'est moins magique ;-)

= Etat d'avancement =
Ajouter l'arboresence qui a été traitée. si tout un répertoire est traité inutile d'indiquer la liste de tous les fichiers, juste un (*) à coté du répertoire suffira ;-)
data
|---bases
| |---fixers
| | |---no.py
| |---bartender.py
| |---computer_lib.py (en cours, GreenD)
| |---mission (*) j'ai du refactorer tous les .mission pour que poedit puisse détecter le texte a traduire

Fr:Development:Translations:ArboTravailFr

2014-03-14T10:50:14Z

Costalfy: /* Etat d'avancement */

= Mise en place =
Un nouveau repository a été créé sur github https://github.com/costalfy/Vega-Strike contenant le repertoire data du trunk de sourceforge en date du 13/04/2014 (r13675)
J'ai été obligé de supprimer les fichiers suivant pour éviter de faire exploser mon quota :
* *.bmp
* *.psd
* *.jpg
* *.png
* *.ogg
* *.texture
* *.image
* *.bfxm
* /textures

J'ai créé un nouveau repertoire i18n/LC_MESSAGES qui contiendra les fichiers à traduire

= Procédure =
== Ajouter la balise gettext dans le code source ==
Ajouter l'internationalisation dans le code python ou c++ est assez simple à réaliser.
Il faut scanner le code source et repérer le texte anglais hardcodé. Ensuite, pour chaque texte, il faut l'enrober de la balise gettext '''_(...)''' comme ceci :

Base.Message("No? Come back to me again if you change your mind.")
devient :
Base.Message(_("No? Come back to me again if you change your mind."))

un exemple est déjà visible sur le repository https://github.com/costalfy/Vega-Strike/commit/9cf2078c3fc39681404e59512b2a86503b49f887

== Générer le .po depuis le code source avec PoEdit ==
Lorsque tout le code source aura été scanné, on utilisera le logiciel [http://www.poedit.net/ PoEdit] pour scanner le code source et repérer toutes les balises _(...) qu'on aura ajouté.
Le logiciel créera le fichier vegastrike-fr_FR.po qui contiendra l'extration de tout le texte à traduire... magique :)

== Traduire le .po avec PoEdit ==
Les traducteurs utiliseront le meme logiciel pour ouvrir le fichier /data/i18n/LC_MESSAGES/vegastrike-fr_FR.po et devront traduire chaque ligne une par une... ça c'est moins magique ;-)

= Etat d'avancement =
Ajouter l'arboresence qui a été traitée. si tout un répertoire est traité inutile d'indiquer la liste de tous les fichiers, juste un (*) à coté du répertoire suffira ;-)
data
|---bases
| |---fixers
| | |---no.py
| |---bartender.py
| |---computer_lib.py (en cours, GreenD)
| |---mission (*) j'ai du refactorer tous les .mission pour que poedit puisse détecter le texte a traduire

Fr:Development:Translations:ArboTravailFr

2014-03-13T14:34:23Z

Costalfy: /* Etat d'avancement */

= Mise en place =
Un nouveau repository a été créé sur github https://github.com/costalfy/Vega-Strike contenant le repertoire data du trunk de sourceforge en date du 13/04/2014 (r13675)
J'ai été obligé de supprimer les fichiers suivant pour éviter de faire exploser mon quota :
* *.bmp
* *.psd
* *.jpg
* *.png
* *.ogg
* *.texture
* *.image
* *.bfxm
* /textures

J'ai créé un nouveau repertoire i18n/LC_MESSAGES qui contiendra les fichiers à traduire

= Procédure =
== Ajouter la balise gettext dans le code source ==
Ajouter l'internationalisation dans le code python ou c++ est assez simple à réaliser.
Il faut scanner le code source et repérer le texte anglais hardcodé. Ensuite, pour chaque texte, il faut l'enrobé de la balise gettext '''_(...)''' comme ceci :

Base.Message("No? Come back to me again if you change your mind.")
devient :
Base.Message(_("No? Come back to me again if you change your mind."))

un exemple est déjà visible sur le repository https://github.com/costalfy/Vega-Strike/commit/9cf2078c3fc39681404e59512b2a86503b49f887

== Générer le .po depuis le code source avec PoEdit ==
Lorsque tout le code source aura été scanné, on utilisera le logiciel [http://www.poedit.net/ PoEdit] pour scanner le code source et repérer toutes les balises _(...) qu'on aura ajouté.
Le logiciel créera le fichier vegastrike-fr_FR.po qui contiendra l'extration de tout le texte à traduire... magique :)

== Traduire le .po avec PoEdit ==
Les traducteurs utiliseront le meme logiciel pour ouvrir le fichier /data/i18n/LC_MESSAGES/vegastrike-fr_FR.po et devront traduire chaque ligne une par une... ça c'est moins magique ;-)

= Etat d'avancement =
Ajouter l'arboresence qui a été traitée. si tout un répertoir est traité inutile d'indiquer la liste de tous les fichiers, juste un (*) a coté du répertoire suffira ;-)
data
|---bases
| |---fixers
| | |---no.py
| |---bartender.py

Fr:Development:Translations:ArboTravailFr

2014-03-13T14:32:52Z

Costalfy:

Fr:Development:Translations:ArboTravailFr

2014-03-13T14:27:47Z

Costalfy: Created page with "= Mise en place = Un nouveau repository a été créé sur github https://github.com/costalfy/Vega-Strike contenant le repertoire data du trunk de sourceforge en date du 13/04/20..."