BlueGEEK Journal

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 bluegyn_spip

Architecture d’un site Charlemagne

  1. Un site Charlemagne comporte un dossier principal racine
  1. 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

  1. Le moteur Charlemagne (fichiers PHP)
  1. Les fonctions PHP (INC) et JavaScript (JS) globales
  1. La feuille de style (CSS)
  1. 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 :

  1. page_observation_image.jpg
  1. page_observation_image.gif
  1. page_observation_image.png
  1. 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"

  1. Un Titre
  1. 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

  1. Questions
  1. Actions
  1. Issue
  1. 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

  1. Il est préférable de terminer chaque ligne par par un ;
  1. 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.
  1. 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
  1. 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 "é")
  1. 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 :

  1. Titre de la question
  1. Sous Titre
  1. Intitulé du 1er bouton
  1. Intitulé du 2eme bouton
  1. Message à afficher sur la page de réponse lors du clic sur le 1er bouton
  1. Message à afficher lors du clic sur le 2eme bouton
  1. Image à afficher sur la page de réponse en commentaire du 1er choix
  1. 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 ...

2- Gestion des Questions et des Actions