small website update

Pierre-Yves Chibon pingou at pingoured.fr
Fri Feb 15 11:37:41 PST 2013


Le vendredi 15 février 2013 à 10:22 -0800, Dirk Hohndel a écrit :
> Pierre,
> 
> I added a final paragraph about the sources for the GPL and LGPL
> components of the binary packages to the Downloads page on the
> Website. Here is what it reads in English. Would you mind sending me a
> French version?
> 
> "The sources of the GPL and LGPL components shipped with the Mac and
> Windows binaries can be found at MacPorts and MinGW. The MinGW
> distribution currently doesn’t inclode osm-gps-map, sources for that can
> be found at the osm-gps-map github page."

Ok, let's give it a try and I hope Kévin and Jean-Noel are reading above
my shoulder to correct me

"Les sources des composants GPL et LGPL inclusent dans les binaires pour
Windows et Mac OS peuvent être trouver via MacPorts et MinGW. La version
actuelle de MinGW n'inclue pas les sources de la bilbiothèque
osm-gps-map, mais elles sont disponible sur la page github de
osm-gps-map.

> Also, I added to nice Download buttons - I wasn't planning to localize
> those for the German version, but if you think this would be better to
> have in French, just give me the exact verbiage to use and I'll find
> time to make additional buttons in French :-)

I think a French version would be nice, verbiage would be:
«Télécharger Subsurface pour {Windows, MacOS}»

Tbh, I wonder if I would not have put more emphasis on the Window/Mac,
we are already in the download page after all, so we know why we're
here.
Maybe just word them "Subsurface for {Windows,MacOS}"?

Btw, Kévin and Jean-Noel finished to review the last two pages
"Contributing" and "Building", files attached.

Thanks,
Pierre
-------------- next part --------------
Sources
=======

Licence : GPLv2

Récupérer Subsurface depuis le dépôt git :

git clone git://subsurface.hohndel.org/subsurface.git .

ou

git clone http://subsurface.hohndel.org/subsurface.git .

Vous pouvez aussi parcourir les sources via gitweb.


Construire Subsurface sous Linux
--------------------------------

Vous aurez besoin de libxml2-devel, gtk2-devel, glib-2.0 et gconf2-devel pour compiler (et de libusb-1.0 si vous voulez compiler libdivecomputer aussi, mais il est vraisemblablement déjà installé). Vérifiez auprès de votre distribution Linux comment installer ces bibliothèques.

Pour Debian, ces bibliothèques ont des noms différents ; essayer avec libxml2-dev libgtk2.0-dev glib-2.0 libgconf2-dev. Il semble que la version de cairo, au moins dans Squeeze, soit trop vieille.

Vous aurez besoin d'avoir libdivecomputer installé, les commandes pour le faire seront de l'ordre de:

git clone \
git://libdivecomputer.git.sourceforge.net/gitroot/libdivecomputer/libdivecomputer
cd libdivecomputer
autoreconf --install
./configure
make
sudo make install

Attention ! Vous aurez peut être à spécifier au Makefile de Subsurface où vous avez installé libdivecomputer si vous ne l'avez pas mis à son emplacement par défaut : /usr/local/. Ne croyez pas pkg-config pour libdivecomputer puisqu'en général pkg-config ne fonctionne que si la bibliothèque a été installée par la distribution.

Éditez le Makefile directement selon vos besoins. autoconf et ses amis sont les outils du diable.


Construire Subsurface sous Windows
----------------------------------

Subsurface compile gentiment avec MinGW - toutes nos compilations sont faites en compilation croisée sous Linux (à l'heure actuelle Fedora 17). Un script shell pour le faire (ainsi que le fichier .nsi pour créer un installer avec makensis) sont inclus dans le dossier packaging/Windows.

La meilleure façon de compiler libdivecomputer sous Window semble être :

mingw32-configure
mingw32-make
sudo mingw32-make install

Jef Driesen, l'auteur de libdivecomputer utilise une approche différente de la notre pour compiler sous Windows:
./configure --host=i586-mingw32msvc --prefix=$HOME/local
PKG_CONFIG_LIBDIR='/opt/i586-mingw32msvc/lib/pkgconfig'
make
make install

Ces instructions utilisent un chemin différent de celui disponible sous Fedora. Pour compiler de la même manière que Jef, il nous faut utiliser :
PKG_CONFIG_LIBDIR='/usr/i686-w64-mingw32/sys-root/mingw/lib/pkgconfig'

Dans tous les cas, une fois libdivecomputer compilé, vous pouvez utiliser le script shell « packaging/Windows/mingw-make.sh » pour construire Subsurface.


Construire Subsurface sous Mac OS
---------------------------------

Décrit par Henrik Brautaset Aronsen

Installer MacPort et ses dépendances :
sudo port install gtk2 +quartz py27-pygtk +quartz libusb gtk-osx-application \
automake autoconf libtool libsoup osm-gps-map libzip

Installer libdivecomputer :
git clone git://libdivecomputer.git.sourceforge.net/gitroot/libdivecomputer/libdivecomputer
cd libdivecomputer
autoreconf --install
LIBUSB_CFLAGS=-I/opt/local/include ./configure
make
sudo make install

Installer subsurface :
git clone git://subsurface.hohndel.org/subsurface.git
cd subsurface
PKG_CONFIG_PATH="/usr/local/lib/pkgconfig/" make
sudo make install-macosx

-------------- next part --------------
Contribuer

Avant tout, il peut être utile de joindre notre liste de diffusion.

Pour modifier le code, envoyez vos correctifs signés. Si vous ne les signez pas, ils ne seront pas acceptés.
Signer  un correctif correspond à ajouter la ligne « Signed-off-by: votre_nom »  à la fin de chaque correctif. Cela indique que vous avez écrit ce code  et que vous avez légalement le droit de l'envoyer à un projet libre en  tant que correctif.

Voir : ligne de signature « signed-off-by »

Veuillez également faire écrire une description précise du correctif. En voici un exemple :

Ligne d'entête: Une explication courte (sur une ligne) du correctif

Corps de texte du correctif en quelques lignes, expliquant
plus longuement pourquoi ce changement et éventuellement donnant des
informations pour comprendre ce qui est corrigé ou ajouté ici, etc.

Le corps de texte peut être en plusieurs paragraphes et s'il vous plait,
faites attention à garder la largeur inférieure à environ 74
caractères. Ainsi « git log » affichera les messages correctement
même quand c'est indenté.

Reported-by: personne-qui-a-rapporté-l'anomalie
Signed-off-by: Votre-nom

La ligne d'entête doit décrire brièvement le correctif et tenir sur une seule ligne. C'est cette ligne qui est montrée par les outils tels que gitk ou shortlog. Elle doit présenter le changement sur une ligne de texte de façon lisible et compréhensible.

Exemple avec gitk



More information about the subsurface mailing list