Accueil > Programmes > Projets PHP pour Sites WEB > Charlemagne > 4- Comment utiliser Charlemagne ? > 1- Installation - Paramétrages
1- Installation - Paramétrages
lundi 19 avril 2010, par
Architecture d’un site Charlemagne
- Un site Charlemagne comporte un dossier principal racine
- Et plusieurs dossiers de travail
Le Dossier principal contient le Moteur Charlemagne
Chaque Dossier de Travail correspond à un exemple didactique.
Installation d’un site Charlemagne
Le package Charlemagne.zip doit être déposé dans le dossier principal
Par exemple pour un dossier "Ecole" :
http//monsite.free.fr/ecole/
Il contient
- Le moteur Charlemagne (fichiers PHP)
- Les fonctions PHP (INC) et JavaScript (JS) globales
- La feuille de style (CSS)
- Et les différentes images communes à toutes les pages
-
- Logo de l’école
-
- Icônes de navigation
Le moteur PHP et les différentes fonctions ne doivent pas être modifié(e)s sans connaissance de la programmation PHP ou Javascript
-
- En particulier les page index.php et sub_index.php qui sont le cœur du programme.
Par contre la feuille de style et les différentes images peuvent être personnalisées à volonté
Le dossier ADMIN
- contient tout ce qu’il faut pour animer chaque page exemple
http//monsite.free.fr/ecole/admin/
Ensuite on crée autant de "Dossiers de travail" dans le Dossier Racine que de Quiz à commenter
http//monsite.free.fr/ecole/Exemple_1
http//monsite.free.fr/ecole/Exemple_2
http//monsite.free.fr/ecole/Exemple_3
...
(1) Recopier le contenu du dossier ADMIN/PHP dans chaque dossier Exemple
http//monsite.free.fr/ecole/Exemple_1/page_observation.php
...
Il contient 7 fichiers PHP courts (raccourcis) qui se contentent d’appeler leur homologue long dans le dossier principal.
ATTENTION
Les fichiers php courts du dossier courant portent les mêmes noms que les fichiers longs du dossier principal,
- Car ils ont la même action
- MAIS, ils n’ont pas du tout le même contenu
Ils sont l’équivalent d’un Raccourci !!! (simple pointeur)
Evitez donc d’écraser un ficher racine avec un fichier court
(2) Recopier le contenu du dossier ADMIN/IMAGES dans chaque dossier fils
http//monsite.free.fr/ecole/Exemple_1/page_observation_image.jpg
...
ATTENTION
Il est important de bien respecter le nom exact des images
Sinon Charlemagne ne les reconnaitra pas :
page_observation_image
Est l’image clef de la page principale à commenter
Charlemagne accepte tous les formats suivant :
- page_observation_image.jpg
- page_observation_image.gif
- page_observation_image.png
- page_observation_image.bmp
page_logo
Correspond à un logo spécifique de chaque exemple
Il est facultatif, s’il est absent c’est le Logo de la page principale qui sera utilisé
(3) Recopier le contenu du dossier ADMIN/TEXTES dans chaque dossier fils
http//monsite.free.fr/ecole/Exemple_1/page_observation_titre.txt
http//monsite.free.fr/ecole/Exemple_1/page_observation_texte.txt
...
Chaque texte peut (et doit) être personnalisé avec n’importe quel éditeur (c’est la simplicité de Charlemagne)
En général chaque page.php recherche avant de s’afficher 2 fichiers "txt"
- Un Titre
- Un Texte
Le Titre comporte une seule ligne et correspond au titre à afficher sur chaque page
Le Texte est multilignes et correspond
- Soit à un simple commentaire
-
- Comme dans page_issue_texte
-
- Ou page_tuto_texte
- Soit à un véritable script
page_navigation_boutons
- Comporte 4 lignes :
- Correspondantes aux 4 intitulés des Boutons de Commande de la page principale
Si ce fichier est manquant ces libellés par défaut sont utilisés
- Questions
- Actions
- Issue
- Enseignement
page_questions_texte
- Comporte autant de lignes que de questions
- Chaque ligne comporte la gestion complète de chaque question,
-
- Avec une série de 8 champs séparés par des points virgules
ASTUCES
- Il est préférable de terminer chaque ligne par par un ;
- Veiller à ne pas laisser de saut de lignes vides après la fin du texte (Charlemagne considère chaque ligne (même vide) comme une question.
- Utiliser un éditeur de texte brut (comme le Notepad) qui permet d’écrire une très longue ligne sans insérer de saut de ligne automatique (NoWrap), ne pas utiliser WORD
- Attention à la page de code utilisé (PSPAD d’origine Tchèque utilise une page de code D’Europe Orientale, il est préférable d’utiliser le Notepad installé sur une machine Française, ou dans le doute de ne pas écrire de caractères accentués, ou d’utiliser les Entités HTML comme
"é"
pour "é")
- Ne pas confondre les ; avec les , ou les : (si les intitulés s’affichent dans un ordre aléatoire, c’est sans doute du à une erreur de balisage)
L’ordre est le suivant :
- Titre de la question
- Sous Titre
- Intitulé du 1er bouton
- Intitulé du 2eme bouton
- Message à afficher sur la page de réponse lors du clic sur le 1er bouton
- Message à afficher lors du clic sur le 2eme bouton
- Image à afficher sur la page de réponse en commentaire du 1er choix
- Image à afficher en commentaire du 2ème choix
Exemple :
La gestion des Questions et des Actions
- ayant évolué depuis la rédaction de cet article,
-
- (ajout des images commentées)
- Sera détaillée dans un chapitre spécifique ...