Différences
Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.
codeur:module:arborescence [2008/01/28 08:30] jmsixt |
codeur:module:arborescence [2008/03/18 09:43] (Version actuelle) jmsixt |
||
---|---|---|---|
Ligne 3: | Ligne 3: | ||
Le but de cette page n'est donc pas de présenter le fonctionnement de tous les répertoires mais bien les règles de normalisation de ceux-ci. | Le but de cette page n'est donc pas de présenter le fonctionnement de tous les répertoires mais bien les règles de normalisation de ceux-ci. | ||
+ | |||
Ligne 16: | Ligne 17: | ||
* Un répertoire **meta** : contient les métas et leurs explications. //Ce dossier sera utilisé dans une future version de NPDS// | * Un répertoire **meta** : contient les métas et leurs explications. //Ce dossier sera utilisé dans une future version de NPDS// | ||
* Un répertoire **theme** : contient les fichiers html qui iront dans le thème de l’utilisateur. //Ce dossier sera utilisé dans une future version de NPDS// | * Un répertoire **theme** : contient les fichiers html qui iront dans le thème de l’utilisateur. //Ce dossier sera utilisé dans une future version de NPDS// | ||
- | * Un répertoire css : contient la css à fusionner avec celle du thème. //Ce système est en évolution// | + | * Un répertoire **css** : contient la css à fusionner avec celle du thème. //Ce système est en évolution// |
===== Répertoires facultatifs ===== | ===== Répertoires facultatifs ===== | ||
Ligne 23: | Ligne 24: | ||
* Un répertoire **js** (optionnel) : contenant les fichiers JavaScript. | * Un répertoire **js** (optionnel) : contenant les fichiers JavaScript. | ||
+ | |||
+ | |||
+ | ===== Installation manuelle ===== | ||
+ | Pour permettre une installation manuelle du module, certains fichiers de documentation sont obligatoires! | ||
+ | * extend-modules.txt (détail de la syntaxe du fichier [[Extend-modules]]) localisé dans le sous répertoire install contenant les informations classiques à un appel de l’admin du module via plugin (si nécessaire), placé dans le répertoire doc | ||
+ | * Un fichier de licence en Français et un en Anglais. Ces fichiers sont disponible [[http://modules.npds.org/modules/nmig/licences.zip|ici]]. | ||
+ | * Un fichier reprenant la méthode d'installation. Il est le plus souvent nommé INSTALL.TXT. Voici un exemple de fichier install.txt : | ||
+ | |||
+ | ################################################################################### | ||
+ | ## Nom: Nom de votre application | ||
+ | ## Version: Version | ||
+ | ## Date: Date de publication | ||
+ | ## Auteur: Votre nom ou Pseudo | ||
+ | ## | ||
+ | ## Description: Description rapide de votre application | ||
+ | ## | ||
+ | ################################################################################### | ||
+ | ## INSTALLATION | ||
+ | ## Décrire ici les étapes de l'installation | ||
+ | ## | ||
+ | ## CONFIGURATION | ||
+ | ## Si votre application dispose d'une configuration, indiqué ici la marche à suivre. | ||
+ | ## | ||
+ | ## UTILISATION | ||
+ | ## Appel grace à une URL du type : | ||
+ | ## Pour un module : | ||
+ | ## MON MODULE | ||
+ | ## Pour un Add-On : | ||
+ | ## Mon Add-On | ||
+ | ## | ||
+ | ## ADMINISTRATION DU MODULE | ||
+ | ## Si votre application dispose d'une administration, indiqué comment y accéder. | ||
+ | ## | ||
+ | ################################################################################### | ||
+ | |||
+ | |||
+ | Il faut aussi préciser dans le fichier install.txt les répertoires à supprimer une fois l’installation manuel effectuer (exemple : sql, css, theme, doc, etc.). | ||
===== Index.html ===== | ===== Index.html ===== | ||
Il est vivement recommandé de mettre un fichier **index.html** vide dans chaque répertoire et sous-répertoire. Cela permet d'éviter que n'importe qui puisse lister le contenu des répertoires (moins performant qu’un .htaccess mais plus simple à utiliser). | Il est vivement recommandé de mettre un fichier **index.html** vide dans chaque répertoire et sous-répertoire. Cela permet d'éviter que n'importe qui puisse lister le contenu des répertoires (moins performant qu’un .htaccess mais plus simple à utiliser). |