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.
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.
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
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.
Source : Génération NT