Démarrer avec Lodel
Un article de LodelWiki.
[modifier] L’interface de Lodel
[modifier] Les pages de démarrage
[modifier] Accéder à Lodel
Pour accéder à l’espace de travail Lodel de votre site, une identification est systématiquement demandée. Vous pouvez y accéder :
- depuis le site en cliquant sur le lien « Lodel (accès réservé) »
- ou bien en inscrivant sur la barre d’adresse de votre navigateur web, l’URL de votre site suivie de /lodel. Ex : http://www.monsite.org/lodel, fait accéder à la page d’identification du site.
Insérer le nom d'utilisateur et le mot de passe que l’administrateur général du site vous a attribué, le bouton inférieur permet de continuer.
Après l'identification, la page de démarrage s’ouvre. Elle affiche la racine du site : la « Base » qui est le « conteneur » général.
[modifier] Page de démarrage
Cette page se divise en deux parties : le bandeau supérieur Lodel, et l’espace « Edition ».
[modifier] Le bandeau supérieur
Ce bandeau apparaît à chaque page de Lodel, toujours présent, il permet à l’utilisateur de repérer qu’il se situe dans l’espace de travail de Lodel, et de circuler dans les différents espaces.
A gauche, le logo Lodel indique que vous êtes dans l’espace privé de votre site. Sont indiqués en dessous la version du logiciel, le code du jeu de caractère utilisé (ex : utf-8 pour Unicode). Lors d’une utilisation avancée, les noms des templates modifiés est affiché.
Au centre sont affichés quatre boutons qui permettent de se déplacer dans les grands espaces de travail de Lodel :
- Accueil : pour accéder à la page de démarrage
- Administrer : pour configurer le site
- Voir : pour une visualisation des pages du site
- Aide : pour se référer aux pages d’aides en ligne de Lodel
Les espaces de travail de Lodel :
Signification des codes de couleurs :
Couleur jaune : vous vous trouvez dans l'espace de travail indiqué, l'espace est actif.
Couleur verte : vous n'êtes pas dans cet espace de travail.
Couleur grise : l'espace est inactif et vous n’y avez pas accès.
Pour changer d'espace de travail : cliquez sur le bouton choisi.
A droite se trouvent deux autres boutons :
Recompiler : permet de mettre à jour les changements apportés aux templates de votre site en recompilant l’ensemble des pages du site et de l’interface de Lodel. La recompilation n’est accessible qu’au niveau administrateur.
Déconnecter : permet de sortir de l’espace Lodel de travail et d’administration du site. Il est important de se déconnecter après chaque utilisation, sinon le compte utilisateur reste actif et un utilisateur ayant accès à votre ordinateur pourrait accéder à cet espace privé.
En bas, à gauche du bandeau, le nom du site, le statut de l’utilisateur et son identifiant sont précisés.
[modifier] La page « Edition »
C’est la page d’accueil de l’espace de travail Lodel, elle se divise en 3 espaces :
Barres d’ajout de publications et de documents : boutons « Ajouter… »
Espace d’affichage des données avec leur statut de publication
Espace de traitement des données : boutons « Voir », « Editer »…
[modifier] L’espace « Accueil »
L’espace « Accueil » contient les fonctions de travail d’édition sur Lodel. C’est au sein de cet espace que l’on construit et organise la structure du site en créant les publications principales, que l’on importe des documents et que l’on traite documents et publications.
La barre grise située au-dessous du bandeau Lodel, permet de circuler dans les différents niveaux de l’arborescence : depuis le niveau supérieur qui est la racine (« Base ») jusqu’aux plus petites ramification créées (publications imbriquées).
[modifier] La page « Edition » et son arborescence : créer la structure du site
[modifier] Présentation générale
La page édition permet :
- de créer la structure de votre site en créant des publications emboîtées (on parle également d’arborescence).
- d’ajouter des documents à des publications, situées à divers niveaux de l’arborescence. Ces documents peuvent être de différents types selon le modèle éditorial adopté.
Les boutons « Ajouter … » permettent d’ajouter des publications ou des documents, ils ouvrent, selon le cas, la fenêtre de création d’une publication, la fenêtre de saisie du contenu d’un document ou la fenêtre d’importation d’un document.
[modifier] Mise en place de l’arborescence du site
[modifier] Penser l’arborescence
Avant d’entreprendre la réalisation d’un site, il convient de penser l’arborescence du site. Selon le type de modèle éditorial choisi, divers types de publications et de documents sont proposés. Il s’agit donc avant tout de penser la hiérarchie des publications avant de les créer.
[modifier] Créer l’arborescence
Dans la page « Base », cliquer sur le type de publication à créer. La page d’ajout d’une publication apparaît. Remplir les champs en suivant les consignes affichées. La publication s’affiche alors sur la page « Base ».
Pour créer une publication dans la publication qui vient d’être créée, il faut se placer à l’intérieur de celle-ci. Cliquer sur son titre pour entrer dans la publication. Ajouter ensuite le type de publication de votre choix comme précédement.
[modifier] Pages d’ajout/édition d’une publication
Cette page permet de renseigner des informations sur la publication que l’on désire créer. Il est possible de modifier les informations d’une publication existante en revenant sur cet écran. On accède donc à cette page de deux façons depuis la page de démarrage :
lorsque l’on crée un publication : « Ajouter [nom de la publication] ».
lorsque l’on veut modifier les données d’une publication déjà existante : « Editer ».
[modifier] Créer une publication subordonnée
Une page du même type que la page d’ajout/édition des collections permet de créer des niveaux de publications subordonnés à la publication première. Dans la plupart des modèles éditoriaux, il est possible de créer une infinité de publications subordonnées.
En haut de la page, sous le bandeau, est indiqué le nom de la collection à laquelle la publication créée sera rattachée. « Parent : [nom de la publication parente] »
[modifier] Ajouts de documents : les différentes étapes
La création de documents avec Lodel peut suivre deux procédures tout à fait différentes, elles dépendent du choix fait initialement lors de la création du modèle éditorial.
[modifier] Saisie dans un formulaire
Le document peut être directement saisi dans un formulaire détaillant différents champs, à la page « Edition » du document. On peut donc avoir un champ titre, auteur, texte, etc. La mise en forme doit donc y être saisie manuellement, par un balisage du texte (HTML, Wiki...). Cette procédure est utilisée principalement dans le modèle du blog.
[modifier] Import de document dans Lodel
L’importation d’un document se fait en plusieurs étapes chronologiques, à travers différentes pages : page de sélection du fichier, page de vérification du stylage, page de renseignement des métadonnées, et page de visualisation.
Attention : Certains modèles de documents n’utilisent pas cette fonctionnalité.
[modifier] 1ere étape : page d’importation du fichier
Cette page permet de sélectionner et d’importer des documents que l’on souhaite publier en ligne. On y accède de deux façons différentes depuis la page d’accueil :
« Ajouter un document » lorsque l’on importe pour la première fois un document ;
« Fonctions » puis « Recharger le document », lorsque l’on veut recharger un document déjà importé.
Sous le bandeau supérieur, le titre « Importation de votre fichier » indique que vous vous situez sur la page d’importation des documents.
Sélection et importation du fichier Cette première étape permet de sélectionner le document sur le disque dur de votre ordinateur puis de le télécharger sur Lodel. Pour cela :
- cliquer sur « Browse » ou « Parcourir » (la formulation varie en fonction du navigateur utilisé),
- sélectionner sur votre disque dur le fichier à importer dans la fenêtre qui s’ouvre
- cliquer sur « Charger » pour continuer ou sur « Annuler » pour interrompre l’opération si besoin.
[modifier] 2e étape : la vérification du stylage
Cette page permet de vérifier que les styles de toutes les données sont bien reconnus par Lodel. Chaque style est représenté par un bloc qui correspond à une balise XML. Le texte est donné à voir sous la forme d’un tableau pour une meilleure vérification du balisage des données. Ce tableau est constitué de la colonne « styles » qui indique les styles utilisés, et la colonne « contenu » qui affiche le texte du document.
[modifier] La vérification du stylage
- Le texte doit être intégralement contenu dans le tableau de vérification. Dans certains cas, le texte sort du tableau, ce qui constitue un problème à corriger et/ou à signaler sur la liste Lodel-users (cf chapitre 1).
- Chaque bloc doit être correctement balisé. Si un paragraphe a été stylé avec un style inexistant, le message « style non reconnu par Lodel » apparaît en rouge dans la colonne de gauche. Il arrive que Lodel ne signale pas d’erreur mais que le stylage soit incorrect malgré tout. C’est le cas, par exemple, lorsqu’on style un auteur avec le style « Titre ».
- Certains caractères apparaissent en grisé lorsqu’il s’agit de styles de caractère ou pour les liens hypertexte.
- La police de caractères utilisée par défaut est le Courrier afin d’aider à la détection visuelle des mises en forme locales qui auraient échappé à la vigilance du styleur. Les citations, niveaux de titre, titre illustration, légende illustration apparaissent sous une forme différenciée du corps de texte pour que l’on puisse les repérer.
[modifier] Consignes
La vérification du balisage et du texte doit être la plus complète possible : vérifier que le texte est présent dans sa totalité, que les images, tableaux ont été reconnus, etc.
Lorsque le balisage n’est pas correct, cliquer sur le bouton « Abandonner » situé en haut et en bas de page ; corriger le document issu du traitement de texte situé sur votre ordinateur ; puis recommencer l’opération d’importation d’un fichier depuis la première étape. Attention : Pour annuler, ne pas revenir en arrière avec la flèche « Précédent » de votre navigateur, cela égarerait Lodel. Utiliser obligatoirement le lien « Annuler » de l’interface Lodel.
Si chaque bloc est correctement balisé, cliquer sur le bouton « Continuer » situé en haut et en bas de page.
[modifier] 3e étape : la page d’édition du document
Cette page permet de vérifier les données du document que l’on désire mettre en ligne, et/ou d’y intégrer d’autres informations ; ou bien de modifier les informations sur le document lorsqu’il a déjà été importé.
On accède à cette page de deux façons :
au cours du processus d’importation du document après l’étape 2
depuis la page de démarrage, en cliquant sur « Editer » lorsque l’on veut modifier les données du document.
Sous le bandeau supérieur, le titre « Edition du document » indique que vous vous situez sur la page d’édition du document.
[modifier] Renseignement des champs
Le nombre et la nature des champs demandés dépendent du modèle éditorial adopté. Le chapitre 2 indique quels types de champs sont reconnus par Lodel et sont, par conséquent, susceptibles d’être renseignés. Le chapitre 5 présente divers modèles éditoriaux.
Il est possible d’ajouter des informations qui n’ont pas été stylées, ni renseignées dans le document du traitement de texte. Cependant, ces ajouts ne se répercuteront pas sur le document initial conservé sur votre disque dur ; et si ce dernier est modifié puis rechargé sur Lodel, les informations ajoutées lors de cette troisième étape de l’importation seront perdues.
Du code XHTML peut apparaître à ce stade dans les différents champs. Cela se produit lorsqu’un titre contient des petites majuscules, un caractère spécial, etc. Il ne s’agit pas d’erreurs qui se seraient glissées, il ne faut donc pas les supprimer si vous souhaitez en conserver la mise en forme.
Dans la plupart des cas, le formulaire demande d’associer des entrées d’index au document afin de nourrir les index prévus.
Il y a trois manières d’attribuer des mots clés à un document :
Saisir les entrées d’index dans le fichier (.doc, .rtf, ou.sxw) qui est importé.
Il faut pour cela utiliser les styles correspondants. Par exemple, ajouter « Histoire des institutions, Sociologie des organisations » dans avec le styles « Mots clés ».
Renseigner les mots clés dans le cadre « Autres » puis cliquer sur « Modifier » (ne pas utiliser la touche entrée de votre clavier).
Les mots clés doivent être écrits les uns à la suite des autres, séparés par des virgules. Il est impératif de conserver une stricte orthographe pour chaque mot, et il est fortement conseillé de mettre une majuscule devant chaque mot.
Sélectionner des mots clés déjà intégrés dans la base de données du site, qui s’affichent dans un cadre.
Pour cela il faut cliquer sur le mot clé choisi, puis sur « Modifier ». Dans le cas de plusieurs mots clés, il faut cliquer sur les mots clés choisis, tout en tenant la touche « Ctrl » de votre clavier enfoncée, puis terminer en cliquant sur « Modifier ».
Lorsque les champs ont été remplis, cliquer sur :
- « Terminer » pour confirmer les informations et revenir sur la publication dans laquelle le document est placé ;
- « Terminer et visualiser » pour confirmer les informations et visualiser la page web. Le document est alors mis en ligne, mais non visible par l’internaute. En effet, son statut de publication par défaut est « Prêt à publié ». Il faut donc publier le document pour qu’il soit visible en ligne.
- « Abandonner » pour annuler les modifications. Le processus d’importation et de mise en ligne du fichier est alors annulé.
[modifier] Fonctionnalités disponibles en permanence dans la zone edition
Lorsqu’un document a été mis en ligne ou qu’une publication a été créée, on peut traiter ces données présentes sur Lodel. Six boutons systématiquement affichés devant les documents et les publications proposent autant de fonctions.
[modifier] Changer l’ordre
Les flèches verticales de changement d’ordre permettent de déplacer d'un cran la publication ou le document auquel elles correspondent. Cliquer sur la flèche du haut pour remonter d'un cran. Cliquer sur celle du bas pour descendre d'un cran. L’ordre d’apparition sur le site web des entités concernées peut ainsi évoluer.
[modifier] Voir
Cette fonction permet de prévisualiser le fichier mis en ligne tel que le verra l’internaute. On peut ainsi se rendre compte de la qualité de l’importation et corriger certaines erreurs avant une publication définitive. En cliquant sur cette option, on change d’espace de travail. Dans le bandeau supérieur, le bouton « Voir » est jaune, ce qui indique que cet espace est actif.
Pour revenir à l’article cliquer sur « Accueil » dans le bandeau supérieur, qui mène à la page de démarrage, en haut de l’arborescence du site.
[modifier] Editer
Cette option permet d’accéder à la page de métadonnées d’un document ou d’une publication. Vous pouvez modifier les métadonnées du document, attacher une icône, etc. Cette page est décrite dans ce chapitre.
[modifier] Fonctions
Cette option permet d’accéder à la page de fonctions avancées d’un document. Cette page permet de gérer le document.
[modifier] Statut
Lorsque le document ou la publication a comme statut :
Statut du document ou de la publication
Option proposée Remarque
« Prêt à publier »
« Publier » Attention : l’action de publication possède un caractère définitif.
« Publié »
« Dépublier » Attention : l’action de dépublication d’un document risque de nuire fortement à la continuité d’un site. Il convient donc de ne dépublier un document uniquement lorsque cela est véritablement nécessaire
« Brouillon »
Le statut apparaît en grisé. Il est impossible de changer sur cette page le statut. Pour changer le statut de « Brouillon » à « Prêt à publier », il faut passer les fonctions avancées (« Fonctions »).
« Protégé »
Le statut apparaît en grisé. Il est impossible de changer sur cette page le statut. Pour changer le statut de « Protégé » à « Publié », il faut passer les fonctions avancées (« Fonctions »).
[modifier] Détruire
Ce bouton permet de détruire le document ou la publication concernée. Une confirmation est demandée par Lodel. La destruction est définitive.
Attention : si vous décidez de détruire un document pour ensuite le republier sachez que son URL va changer et que sa citabilité en sera donc atteinte, l'utilisation de la fonction recharger un document du menu fonctions est alors mieux adaptée.
[modifier] Fonctions avancées d’un document
La page se divise en quatre espaces symbolisés par des boutons différents : le statut de publication, la manipulation du fichier, les documents annexes et la gestion du XML.
[modifier] Donner un statut
Ce premier espace indique le titre du document ainsi que son statut. Par défaut, Lodel confère au document le statut de « Prêt à publier ». Cet espace permet de faire passer un document de « Prêt à publier » à « Brouillon » et inversement.
Pour publier ou dépublier une entité, il faut revenir à la page « Base ».
[modifier] Manipulations du fichier
Recharger le document
Cette option permet recharger le document en ligne, en réimportant le document depuis le disque dur de votre ordinateur.
Grâce à cela il est possible de corriger un document mis en ligne sans briser la continuité de la publication. Il n’est pas nécessaire de dépublier un document pour le corriger ou le mettre à jour.
Cliquer sur « Recharger le document ». La page « Importation de votre fichier » apparaît. Suivre les étapes de mise en ligne.
Déplacer le document
Cette option permet de déplacer un document d’une publication à une autre.
Cliquer sur « Déplacer ce document ». La page « Déplacer le document » s’ouvre. Sont affichées toutes les publications du site, hiérarchisées en fonction de l’arborescence.
Cliquer sur la publication dans laquelle le document doit être déplacé. Lodel redirige alors sur la page de fonctions avancées du document.
Il n’y a pas de demande de confirmation pour le déplacement du document. Dès que la publication dans laquelle on veut ranger le document est sélectionnée, le déplacement est effectif. L’URL du document ne change pas et sa citabilité est donc conservée. Récupérer le fichier source
Cette option permet de récupérer sur le disque dur de son ordinateur le fichier mis en ligne sous sa forme Word, RTF ou SXW, selon les cas.
Grâce à cela, il est possible de récupérer un fichier perdu, de corriger, ou modifier la version la plus récente d’un document mis en ligne, de manipuler à distance un même document entre plusieurs utilisateurs.
Cliquer sur « Récupérer le fichier source ». Une fenêtre s’ouvre et propose d’ouvrir le fichier ou de le télécharger sur le disque dur de votre ordinateur. Vous pouvez ensuite modifier le document source sur votre ordinateur, puis le recharger.
[modifier] Documents annexes
Cette option permet d’ajouter, de modifier ou de supprimer un document annexe.
Pages d’ajout de document annexe
Un trombone signale chaque document annexe. Il y a cinq types de documents annexes. Pour chacun de ces types, une page intitulée « Ajout d’un document annexe » apparaît. Le titre du document est renseigné en dessous, ainsi que le type de document annexe. Les champs doivent être remplis.
Type de document
Champs Remarques et consignes
Lien vers un fichier
Titre (*) : indiquer le titre du document annexe.
Commentaire : inscrire ici le texte qui accompagne le document annexe.
Fichier à charger (*) : cliquer sur Browse, sélectionner le fichier
Selon le choix fait lors de la création de la maquette du site, le fichier peut s’ouvrir dans une nouvelle fenêtre ou être proposé au téléchargement de même que le commentaire sera lisible ou non par l’internaute.
Lien vers un site externe
Titre (*) : indiquer le titre du site, ce titre représentera la zone cliquable.
URL (*) : indiquer l’adresse exacte du site.
Il est possible d’inscrire un titre :
- soit sous une forme littéraire ex : Aller sur le site de Lodel.org
- soit sous la forme de l’URL, ex : lodel.org
Lien vers un document interne au site
Titre (*) : indiquer un titre.
ID du document (*) : indiquer l’id du document.
Pour repérer l’ID du document à annexer, il faut aller sur la page web du document, l’ID est indiquée dans la barre URL.
Exemples dans lesquels les ID sont 126, 204 et 138 :
http://www.lodel.org/document126.html
http://figoblog.ouvaton.org/document204.php
http://www.dacos.org/document.php?id=138
Noter la variété des types d’URL possibles avec Lodel.
Lien vers une publication interne au site
Titre (*) : indiquer un titre.
ID de la publication(*) : indiquer l’id de la publication
Suivre la même procédure que pour l’exemple précédent.
[modifier] Gestion du XML
Cet espace permet de manipuler le document au format XML.
Action Description Remarques
Visualiser le XML Permet de voir le XML. Le comportement dépend du navigateur que vous utilisez.
Récupérer le fichier XML Permet de déposer le fichier XML sur votre disque dur. Il existe une fonctionnalité de sauvegarde de la totalité des fichiers XML dans la zone administration.
Valider le XML Permet de lancer une validation du XML afin de vous assurer de sa conformité aux normes. Aucun fichier ne doit produire d’erreur. Si une erreur survenait lors de la validation, signalez-le à l’équipe de développement de Lodel.
[modifier] Fonctions avancées d’une publication
La page se divise en deux espaces symbolisés par des boutons différenciés : le statut de publication, les documents annexes. La mention « Fonctions avancées de la publication » indique que vous êtes sur la page de Fonctions avancées de la publication.
[modifier] Statut de publication
Ce premier espace indique le titre le de la publication ainsi que son statut de publication. Par défaut Lodel attribue à la publication le statut de « Prêt à publier ». Cet espace permet de faire passer une publication de « Prêt à publier » à « Brouillon » et inversement. Pour donner le statut de « Publié » il faut passer par le bouton « Publier » affiché sur la page Edition, en face de la publication.
[modifier] Documents annexes
Cet espace permet d’ajouter, de modifier ou de supprimer un document annexé à la publication. Lodel traite les documents annexés aux publications de la même façon que les documents annexés aux documents.
[modifier] Publier/Brouillon/Dépublier
Ce cinquième bouton affiché sur les pages de l’arborescence du site permet modifier le statut de publication d’un document ou d’une publication. Lodel se comporte ici comme avec un document (voir plus haut).
[modifier] Détruire
Ce dernier bouton permet de détruire un document ou une publication. Une fenêtre de confirmation s’ouvre pour confirmer la suppression du docuent ou de la publication. Attention, lorsque l’on détruit une publication, tous les documents qui y étaient contenus sont aussi détruits.
[modifier] L’espace Administrer
Cet espace permet de gérer le site : définir quels seront les utilisateurs, gérer le modèle éditorial, configurer le site et en assurer les sauvegardes. Seul l’administrateur du site peut intervenir dans cet espace de travail. Cet espace est décrit dans le chapitre 4, qui décrit les usages avancés de Lodel.
