Naeh.net Le mémo du développeur

4mar/080

Installer PHPDoc et générer une documentation

Dans cet article nous allons voir comment à partir d'un code source bien commenté, générer une documentation comme on aimerait avoir pour tout projet ou application digne de son nom.

Pour cela nous allons utiliser PHPDocumentor. qui va nous permetre de générer une documentation à paritr des sources de notre projet.

Il faut d'abord l'installer avec la commande suivante :

pear install phpdocumentor

(si pear n'est pas installé faites un apt-get install php-pear)

Si vous rencontrez un problème de dépassement de mémoire alouée avec PHP, allez dans /etc/php5/cli/php.ini et augmenter cette limite (il s'agit du paramètre memory_limit).

création d'un fichier de configuration pour le projet :

pour générer la documentation d'un projet nous avons besoin d'un fichier de configuration par projet, en voici un exemple :
fichier nom_du_projet.conf :

[Parse Data]
title = Titre de la documentation
hidden = false
parseprivate = off
javadocdesc = off
defaultcategoryname = Documentation
defaultpackagename = Projet
target = /PATH/OU/SERA/ENREGISTRE/LA/DOCUMENTATION
readmeinstallchangelog = README, INSTALL, FAQ, LICENSE
directory =   /PATH/VERS/LE/PROJET
ignore = templates/,test*.php
sourcecode = on
output=HTML:frames:earthli

et pour tester exécutez la commande suivante (après avoir créé le répertoire cible de la documentation)

phpdoc -c nom_du_projet.conf

et voilà, la génération prend un peu de temps, en fonction de la machine et de la taille du projet.

22déc/071

Microsoft fournit sa documentation à Samba

Comme si les sanctions et amendes infligées à Microsoft en Europe font de l'effet.

Microsoft vient de signer avec Samba, et pour 10 000 € (paiement unique, pas de royalties ni autre), cette dernière a obtenu toute la documentation des protocoles utilisés par Windows.

Samba pour ceux qui ne connaissent pas, est un logiciel libre, en Open source, sous Linux qui permet de faire des partages réseaux entre ordinateurs Windows <--> Linux. Ce dernier avait un peu de mal à suivre toutes les évolutions de windows, et donc, ne pouvait pas vraiment être au top et présentait même des limites dans certaines situations, mais tout cela devrait changer maintenant que les développeurs possèdent la documentation des protocoles, et ainsi Samba n'aura plus d'excuses pour le mauvais fonctionnement dans certains cas bien précis.

12déc/070

Jouer quand on est sous Linux, ON PEUT !

Certes il n'y a pas le même nombre de jeux que sous Windows, loin de là, mais il faut savoir qu'on peut quand même se divertir avec des vrais jeux meme sous linux, il y'en a pour à peu près tous les gouts, jeux de guerre, simulation, FPS, etc.

Voici quelques un parmi les plus connus :

  • America’s Army : Vous êtes GI devinez ce qu'il vous reste a faire :p
  • Tremulous : C'est le Quake du monde du pingouin
  • Tux Racer : Vous aimez le pingouin ? faites le glisser au plus vite :-)
  • The Open Racing Car Simulator : C'est pas NFS mais c'est pas mal (courses en circuit)
  • Frets on Fire : Ca fait fureur ! tout le monde veut devenir guitariste maintenant

et bien d'autres encore, en voici une liste

11déc/070

Picasa bêta 2.7 : Google comble le fossé Linux / Windows

Le logiciel de visualisation et d'organisation de photographies Picasa est disponible sous Linux dans une mouture bêta 2.7, apportant les fonctionnalités qui lui faisaient défaut par rapport à la version Windows.

Picasa est pour rappel un logiciel dédié à la photo devenu propriété de Google en 2004. Gratuit, Picasa permet de trouver et organiser toutes les photos stockées sur un ordinateur, les modifier via l'ajout de quelques effets, les partager facilement avec d'autres utilisateurs notamment via le Web. Un utilitaire pratique pour ceux qui veulent disposer d'une solution simple à l'emploi, sans se lancer dans le parfois difficile apprentissage d'applications plus évoluées.

Par rapport à la dernière version Windows, la version 2.2 de Picasa sous Linux ne tient pas la comparaison avec de nombreuses fonctionnalités qui lui font défaut. Néanmoins, une récente version bêta estampillée 2.7 sous l'OS du manchot promet un rapide changement à ce niveau.

La preview de Picasa 2.7 pour Linux corrige en effet plusieurs bugs de fonctionnement et introduit la prise en charge de Picasa Web Albums, la possibilité de sauvegarder ou non les changements et de revenir facilement à la version originale d'une photo, une nouvelle hiérarchie pour les dossiers, des améliorations concernant l'importation, un meilleur support du RAW...

Pas encore de version native sous Linux
Picasa 2.7 pour Linux est pour le moment une version anglophone destinée à des fins de tests et petits regrets, ne supporte pas la vidéo, les diaporamas grand écran et surtout, nécessite toujours l'utilisation de WINE.

Picasa 2.7 bêta pour Linux

Source : Génération NT