2. Les fichiers

Résumé :
Les normes de nommage des fichiers, simples, structurent l'environnement de développement.

Nommage des fichiers

Les noms doivent être en ASCII alphanumériques, notamment sans caractères « : », « / », « \ », « # », « | », « & », « @ », « $ », « ! », « » (espace), etc.

Voici les caractères spéciaux autorisés : « . », « _ », et « - ».

Les noms de fichiers et répertoires doivent être moins longs que 30 caractères, pour être compatibles avec MacOS classique.

Extensions de fichiers

Les extensions des fichiers sont : « .php » (et non « .php3 »), « .txt » (et non « .text »), « .xml », « .html », (et non « .htm »), « .xsl », (et non « .xslt »), « .properties ».

Les fichiers « headers », destinés à être inclus dans un autre fichier source, doivent avoir l'extension « .h. » en plus de leur extension propre. Exemples : « .h.php », « .h.xsl »... On met « .h. » juste avant la dernière extension (extension technique) : « content.dtdoc.h.xml », et non « content.h.dtdoc.xml ».

Les feuilles XSLT qui ont un format spécifique de sortie, doivent porter ce format dans leur extension. Exemples :

« .text.xsl » (et non « .txt.xsl ») pour une XSLT qui crée un fichier texte.
« .html.xsl » pour une XSLT qui crée un fichier HTML.
« .build.xsl » pour une XSLT qui crée un fichier Ant.
« .php.xsl » pour une XSLT qui crée un fichier source PHP.
« .java.xsl » pour une XSLT qui crée un fichier source Java.

Répertoires standard

Voici les noms de quelques répertoires standard : « src/ », « src/php/ », « src/xml/ », « xslt/ » (et non « xsl/ »), « test/ », « out/xxx.out », « conf/ », « css/ ».

3/6 DÉBUT PRÉC. SUIV. FIN SOMMAIRE INDEX GLOSSAIRE