Papy-tools

Papy-tools

papy-tools est un outil qui permet de génèrer des grilles americaines adaptés au web. vous pouvez voir un exemple sur notre site http://www.caenalekhine.fr/grilles/opentoussaint/toussaint2011.html.

Pré-requis

Papy-tools nécessite le langage ruby installé sur votre machine. Ci-dessous,pour ceux qui ne dispose de ruby sur leur machine,voir la procédure ci-desssous.

Installation sous window

Télécharger ruby à l'adresse suivante http://rubyinstaller.org/downloads/

Une fois installé,ouvrir la console windows.

Tapez gem install papy-tools --platform 386-mswin32

Installation sous Linux

Ruby est disponible dans toutes les distributions Linux. Utiliser le gestionnaire de logiciel ou de paquets de votre distributions.

Exemple sous ubuntu et debian,

sudo aptitude install ruby1.9.1-full

Une fois installé,tapez gem install papy-tools

Utilisation

En mode console cree un nouveau repertoire de travail et installez vous dedans.

Tapez papy-tools init

Ceci cree les repertoires source,output,template et helper. source désigne l'emplacement des fichiers html crée par papy. output désigne l'emplacement des fichiers généres par papy-tools. template désigne les gabarits utilisés pour la transformations des fichiers. helper désigne des utilitaires utilisés par les templates.

Si vous êtes programmeur,vous pouvez modifier ou creer vos propres templates et helpers.

Taper papy-tools list-template

il devrait afficher la liste des templates existants.

defaut.html.erb utilisé par defaut. etendu.html.erb permet d'ajouter des filtres aux grilles format.json.erb pour les programmeurs transforme la grille en format JSON format.yaml.erb pour les programmeurs transforme la grille en format YAML

Ajouter une grille americaine dans le repertoire source et taper papy-tools create _nom_grilleamericaine

Dans le repertoire output est créé notre grille americaine magique.

On peut aussi créer directement une grille americaine a partir d'une grille du site de la FFE .

exemple:

papy-tools create 'http://www.echecs.asso.fr/Resultat.aspx?URL=Tournois/Id/20009/20009&Action=Ga'

Pour les differentes options disponible,allez voir la section usage

Usage

Usage:

papytools commandes [arguments..] [options..]

commandes:

init: cree les differents repertoires source,output,templates et helpers et importent les differents templates et helpers.

list-template: liste les templates disponibles

create argument [options]: cree la grille americaine avec comme template default.html.erb.argument peut etre l'url de la grille sur le site de la FFE ou un fichier grille americaine généré par papy contenu dans le repertoire source.le fichier cree est dans le repertoire output

exemples:

papy-tools create 'http://www.echecs.asso.fr/Resultat.aspx?URL=Tournois/Id/20009/20009&Action=Ga'

papy-tools create regentblitznovembre.html

options pour create:

--ligue argument :cree en filtrant la grille à une ligue

--premiers argument :cree en filtrant la grille au n [argument] premiers joueurs

--template argument :cree en utilisant un template contenu dans le repertoire template

--liste argument :cree en ajoutant la liste des joueurs gêrés par papy.permet d'obtenir les clubs pour la grille americaine. argument est le fichier liste des joueurs généré par papy contenu dans le repertoire source.

--output argument :change le nom du fichier.le nom du fichier ne doit pas contenir d'extension.

--invisible argument :rend invisibles certaines colonnes de la grille.argument prend comme valeur une chaine de caractêre.cette chaine de caractêre peut contenir les lettre c,l,p,d representant respectivement les colonnes club,ligue,pays et les colonnes departages.