Documentation Diogenes
- 0. Formation rapide : comment prendre en main Diogenes en peu de temps (Michel Coudreuse)
- 1. Introduction : concepts généraux de Diogenes
- 2. Guide d'installation : comment installer Diogenes sur un serveur web
- 3. Manuel utilisateur : comment utiliser Diogenes du point de vue du visiteur
- 4. Manuel administrateur : comment créer et gérer un site web avec Diogenes
- 5. Manuel root : comment gérer un serveur Diogenes
3. Manuel utilisateur
3.1. Édition d'une page
Pour éditer une page, il faut tout d'abord afficher cette page en la sélectionnant à l'aide du menu comme le ferait n'importe quel visiteur du site. Ensuite, cliquez sur le lien "propriété de la page" du menu de gauche puis sur l'un des liens "éditeur brut" ou "éditeur HTML" en haut de la page, selon que l'on souhaite éditer le code HTML directement, ou que l'on préfère un éditeur inspirer de Word (attention il faut avoir activé java pour utiliser cette fonctionnalité).
Il est aussi possible d'importer un fichier HTML existant, créé sur son propre PC avec un éditeur HTML, qui remplacera le contenu actuel de la page. Pour cela, il suffit d'utiliser le cadre "import HTML" en bas de la page affichée à l'aide du lien "propriété de la page".
Pour créer une page à partir d'un fichier word, il faut :
- l'exporter au format HTML (menu "Enregistrer sous..." > choisir le format HTML)
- utiliser la procédure du paragraphe précédent pour remplacer la page avec le fichier HTML ainsi créé
3.2. Gérer les autorisations d'accès à une page
A chaque page d'un tonneau Diogenes est associé deux niveaux de permissions : un niveau de permission permettant de limiter les autorisations de modification de la page (écriture), un autre pour permettre de limiter les autorisations de consultation de la page (lecture).
La signification des différents niveaux accessibles est la suivante :
- public : la page peut être consultée/modifée par tous
- auth : la page peut uniquement être consultée/modifiée par les utilisateurs qui se sont authentifiés (et ont par conséquent un compte sur le serveur Diogenes!)
- user : la page ne peut être consultée/modifiée que par les utilisateurs déclarés comme "membres" du tonneau
- admin : la page ne peut être consultée/modifiée que par les administrateurs du tonneau
- forbidden : la page ne peut pas être consultée/modifiée
Pour accéder à ce réglage, il faut cliquer sur "Propriété de la page" lorsque la page est affichée.
3.3. Créer une page et l'ajouter au menu
La création d'une page s'effectue depuis la pages de gestion des pages du site. On y accède via le lien "Administration" puis "Catalogue des pages". Lors du remplissage du formulaire de création de page (accessible via le lien "ajouter une page"), il faut laisser la valeur par défaut de "page parent". Le champ "emplacement" correspond à un nom interne de la page, nom qui sera utilisé uniquement dans la partie administration du site diogène et dans l'url d'accès à la page. Le champs "titre", lui, correspond au titre, c'est-à-dire le nom visible par les visiteurs du site, et qui sera afficher en haut de la page (attention, il ne s'agit pas du nom visible dans le menu).
Une fois une page créée, elle n'est pas automatiquement ajoutée au menu, même en choisissant une page dans le ménu déroulant "page parent" du formulaire de création de page. Sur la page d'édition du menu (lien "Administration" puis "Éditer les menus"), il est possible de naviguer dans la hiérachie du menu afin de se placer au niveau qui sera le père de la nouvelle entrée :
3.4. Illustrer une page, stocker des fichiers
Il est possible d'attacher autant de fichiers que souhaité à une page. Pour accéder à la liste des fichiers attachés à une page donnée, en ajouter et en supprimer, cliquez sur le lien "page > parcourir les fichiers" depuis la page des propriétés de cette page. Cette liste contient en particulier un fichier nommé "page.html" qui contient le texte au format HTML de la page :
Cette fonctionnalité peut être utilisée pour insérer une image dans une page. Pour cela, il faut transférer l'image monimage.jpg depuis votre PC vers la liste de fichiers attachés à cette page. Ensuite, à l'aide de l'éditeur HTML, rajoutez la balise suivante à l'endroit où doit apparaître l'image :
<img src="monimage.jpg" />
Il est aussi possible d'utiliser cette fonctionnalité pour stocker un, ou plusieurs, fichiers à télécharger. La procédure est la même que pour une image, à part que la balise à insérer est une balise de lien :
<a href="monfichier.doc">Télécharger le fichier</a>
3.5. Préférences
Une fois authentifié, il vous est possible de cliquer sur Préférences pour obtenir une page résumant vos préférences. Votre nom d'utilisateur ainsi que votre identité sont affichés sur cette page.
Si vous vous êtes connecté avec un compte natif Diogenes (c'est le cas à moins d'utiliser une version modifiée de Diogenes comme sur diogenes.polytechnique.org!), il vous sera proposé de changer de mot de passe.
3.6. Obtenir de l'aide
A tout instant, il vous est proposé de consulter Manuel Utilisateur Diogenes (le document que vous lisez actuellement) en cliquant sur le lien Documentation.
$Id: page.html,v 1.6 2006/01/17 00:56:17 damien.bobillot.2002