Manuel de rédaction Jahia version 1.13, avril 2012 Avertissement préalable Ce manuel est le support du cours "Création et entretien de sites web avec Jahia" dispensé par le Ci. Il ne remplace pas le cours mais le complète. La lecture des informations concernant Jahia accessibles à partir de la page http://www.unil.ch/ci/page4856.html est également indispensable à une bonne compréhension du présent document. Avant de débuter Adresse du site en développement (valable uniquement pour les nouveaux sites Jahia) Pendant la phase de développement initial de votre site, vous y accéderez par une adresse provisoire différente, cachée des moteurs de recherche. Lorsque vous estimez qu'il est prêt à être publié, demandez l activation de son adresse définitive par un e-mail à jahia_help@unil.ch. Exemple: S'il est prévu que votre site soit publié avec l'adresse définitive www.unil.ch/monsite, pendant son développement initial il sera atteignable par l'adresse www.unil.ch/jmonsite. Un "j" (comme Jahia) sera temporairement ajouté avant le nom du site. Pendant la phase de création initiale de votre site, ne pas diffuser l'adresse temporaire de type www.unil.ch/jmonsite! Elle sera en effet obsolète le jour où votre site sera mis en production avec son adresse définitive www.unil.ch/monsite. Votre première page Voici résumée en quelques étapes la marche à suivre pour créer une nouvelle page, y placer un paragraphe de texte et la publier. Les notions qui y sont présentées seront développées en détail dans les chapitres suivants. Se connecter 1. Vous devez d'abord vous authentifier avant de pouvoir effectuer une mise à jour du site. Sur toutes les pages de votre site, le lien login permet d'afficher la fenêtre d'authentification. 2. Saisie et validation de votre nom d'utilisateur et de votre mot de passe. 3. La page se réaffiche, surmontée de la barre d'outils Jahia. Si vous avez le droit d'éditer cette page, cette barre d'outils comprend des onglets "en ligne" et "édition". 4. A la fin de votre session de travail, vous devrez vous déconnecter par le lien logout dans la barre d'outils. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 1
Passer en mode édition Sur une page que vous avez le droit d'éditer, vous verrez apparaître un ou plusieurs onglets dans la barre d'outils Jahia. Ces onglets vous permettent de passer d'un mode à l'autre. mode édition mode prévisualisation mode en ligne permet de mettre à jour la page (ajouter, modifier ou supprimer du contenu) permet d'avoir un aperçu pour contrôle des modifications que vous venez d'effectuer sur une page, avant de les publier permet de voir la version actuellement publiée Ces onglets apparaissent ou non en fonction du contexte. Par exemple, seul l'onglet édition apparaît sur une nouvelle page en cours de création. En mode édition, les éléments sur lesquels vous pouvez exercer une action sont accompagnés d'icônes, dont voici la signification: Le fait de cliquer sur l'un de ces icônes ouvrira une boîte de dialogue permettant d'éditer les différentes propriétés ou le contenu de l'objet concerné. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 2
Eviter de fermer les fenêtre de dialogue de Jahia (=fond gris) en employant leur case de fermeture! Dans certains cas, ceci est susceptible d'activer les verrous du mécanisme qui empêche les mises à jour concurrentes. Il faut employer OK ou annuler pour fermer ces fenêtres. Ajouter une page 1. Se placer sur la page parente (=1 niveau au-dessus) de celle que l'on souhaite créer. 2. Dans le menu de navigation principal (à gauche de la page), cliquer sur l'icône "+". 3. Dans la fenêtre qui s'ouvre, saisir le titre de la nouvelle page, puis valider par OK. 4. De retour sur la page parente, cliquer directement sur le lien nouvellement créé pour afficher la nouvelle page. Cette nouvelle page est maintenant prête à accueillir son contenu. Saisir un paragraphe de texte 1. Cliquer sur le lien "ajouter contenu". 2. Une fenêtre s'ouvre. Saisir le titre du paragraphe (si souhaité) et valider par OK. 3. Pour accéder à l'éditeur de texte, cliquer ensuite sur le lien "ajouter contenu standard". 4. Une fenêtre s'ouvre. Saisir le texte dans la fenêtre de l'éditeur de texte, puis valider par OK. Publier la page La page que vous venez tout juste de créer n'est pour le moment visible qu'en mode édition, et n'est pas encore visible pour les visiteurs du site. Pour la publier, il faut encore la faire passer à Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 3
travers le processus de workflow. Lorsque vous vous trouvez sur une page dont le contenu affiché en mode édition n'est pas encore publié, vous le remarquez au feu rouge affiché à côté du lien "workflow" dans la barre d'outils Jahia: 1. Cliquer sur le lien "workflow" pour ouvrir la fenêtre permettant de sélectionner les modifications à publier. 2. Cocher les cases marquées d'un feu rouge, puis valider par OK. 3. La page est désormais visible par les visiteurs du site. Sélectionner la page nouvellement créée et sa page parente, puis valider Navigation Longueur des titres de pages Si un titre de page dépasse une certaine longueur, son affichage dans le menu de navigation est tronqué à 24 caractères (pages de 1er niveau), puis 40, 37 et 34 caractères pour les niveaux inférieurs suivants. Les caractères non affichés sont emplacées par:... 24 40 37 34 Un titre de page peut ensuite si nécessaire être modifié sur la page elle-même en un intitulé plus long, par le lien "modifier titre long". Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 4
Workflow Principe Les pages que vous venez tout juste de créer ou de modifier ne sont pas visibles de suite par les visiteurs du site. Elles ne sont visibles qu'en mode édition ou prévisualisation, et ceci uniquement par les personnes ayant le droit de les éditer. Pour publier ces pages nouvellement créées ou modifiées, il faut les faire passer à travers le processus de workflow. Pour prendre un comparaison avec les sites web classiques, ceci équivaut en quelque sorte à la différence entre "serveur de test" et "serveur d'exploitation". Nous avons vu précédemment un exemple de workflow simple. Voici quelques explications complémentaires. Ne pas oublier qu'une page nouvellement créée a pour conséquence de modifier également sa page parente puisqu'elle va apparaître dans son menu de navigation. Il faut donc également penser à effectuer le workflow de la page parente. Pour simplifier cette procédure lorsque vous créez ou modifiez plusieurs pages, vous pouvez vous positionner directement sur leur page parente pour sélectionner simultanément plusieurs pages à faire passer par le workflow. Déployer l'arborescence Dans les cas où l'on souhaite publier toutes les pages en attente dans un site avec une hiérarchie complexe, il faut au préalable déployer les niveaux d'arborescence masqués. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 5
Si une page est bloquée par un cadenas Il est possible de supprimer le cadenas et de publier ainsi cette page Types de contenu Pourquoi différents types de contenu? Les pages web que vous créez vont contenir du texte, des liens et des images. Il existe cependant plusieurs moyens pour saisir ces différents éléments en exploitant au mieux les possibilités de Jahia, notamment ses capacités de gestion dynamique. C'est la raison pour laquelle plusieurs types de contenu différents sont disponibles dans les modèles de pages UNIL à votre disposition. En voici une présentation. Lorsque vous cliquez sur un lien "ajouter contenu" dans une page en cours d'édition, vous créez un nouveau paragraphe. Pour ce dernier, vous aurez ensuite à spécifier quel type de contenu vous voulez choisir. Chaque paragraphe ne peut en effet être constitué que d'un seul type de contenu parmi ceux qui sont proposés. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 6
Vous aurez le choix entre les types suivants: contenu standard (texte avec liens, images, documents à télécharger) 90% des cas tableau (présentation en colonnes, texte, liens ou documents à télécharger) 5% des cas FAQ (foire aux questions) galerie d'images liste de navigation dynamique flux RSS. Une page peut contenir plusieurs paragraphes abritant chacun des types de contenus différents. Composition d'un contenu standard Le contenu standard peut accueillir un ou plusieurs des éléments suivants: 1. texte avec images 2. document (=PDF, Word, etc.) 3. commentaire relatif au document (utilisé très rarement) Ces éléments sont tous optionnels toujours affichés dans cet ordre. Chacun ne peut apparaître qu'une seule fois au plus pour un contenu standard. Les liens qui permettent d'éditer les éléments d'un contenu standard Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 7
Ajouter un document à télécharger (=fichier PDF, Word, etc.) Dans la boîte de dialogue affichant la fenêtre d'édition du contenu, cliquer sur le lien "Fichier" Cliquer sur "Dossier partagé (site)". Cliquer sur l'icône "Menu" à la fin de la ligne "Dossier courant". Dans le menu déroulant, choisir "Envoyer un nouveau fichier". Cliquer sur "Parcourir" (ou "Browse" selon les navigateurs). Dans la fenêtre du sélecteur de fichiers, choisir le fichier désiré. Puis valider votre choix. "OK" pour charger votre fichier dans Jahia. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 8
Le fichier que vous venez de charger est sélectionné par défaut, son nom apparaît en gras. "OK" pour valider. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 9
Les autres types de contenu : Galerie d'images La galerie d'images permet d'afficher des images de petite taille, cliquables pour en obtenir une version agrandie. Elle sert principalement deux objectifs: Faciliter la présentation de plusieurs images sur une seule page, car les images de petite taille se chargent rapidement même avec une connexion par modem. Contourner la limitation de la ligne graphique UNIL qui ne permet pas d'utiliser dans les pages des images dépassant 565 pixels de large. La petite image est le seul élément obligatoire de la galerie. Le commentaire et l'image de grande taille sont facultatifs. Les différentes versions JPEG de chaque image doivent être au préalable préparées dans un outil d'édition d'images (par exemple Photoshop). Tableau La boîte de contenu "tableau" vous permet de créer un tableau à 1 2, ou 3 colonnes intégré à la ligne graphique. Chaque cellule composant ce tableau peut contenir à choix: un texte un lien ou un fichier à télécharger rendant ainsi ce type de contenu très polyvalent. Voir le mode d'emploi plus loin dans ce document. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 10
Liste de navigation dynamique La liste de navigation dynamique permet d'afficher dans le contenu d'une page la liste des souspages de n'importe quelle page du site. Ce type de contenu permet d'afficher les titres complets des pages, ce qui est par exemple utile pour des titres longs qui apparaissent habituellement tronqués dans le menu de navigation de la colonne de gauche. Assistant de création de tableaux Lors de la création d'une page web, il est parfois nécessaire d'utiliser des tableaux HTML pour présenter certains types d'informations. Exemple: La mise en page de tableaux HTML n'est guère aisée pour les personnes qui n'ont pas une connaissance détaillée du langage HTML. C'est pour cette raison que nous avons prévu dans les types de contenu proposés dans Jahia un système de création d'un tableau simple comportant une, deux ou trois colonnes. Ce type de contenu "tableau" a entre autres particularités un large champ d'application. En effet, il permet de choisir pour chaque cellule entre plusieurs contenus différents: texte lien (vers une page du site ou vers un site extérieur) fichier (par exemple document PDF à télécharger). Il possède également une fonction de tri automatique, par ordre alphabétique ou par ordre chronologique d'insertion des lignes. Exemple: Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 11
Pour créer un tableau, on procède ainsi lors de la création d'une boîte de contenu: Pour déterminer le nombre de colonnes: Il faut donner un intitulé à chaque colonne que l'on souhaite utiliser. Par exemple, si on donne un intitulé uniquement pour la première colonne, le tableau comportera une seule colonne. Pour déterminer la largeur des colonnes: Les largeurs de la première et de la deuxième colonnes peuvent être sélectionnées par menu déroulant. La largeur de la troisième colonne (quand elle est présente) résulte des choix de largeurs effectués pour les deux premières colonnes. Exemple: Réalisation d'un tableau à deux colonnes étape 1, saisie des titres de colonnes choix des largeurs Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 12
étape 2, choix des types de contenu saisie des contenus dans les champs correspondants Exemples de mises en œuvre avec commentaires sur certaines options: possibilité de varier la largeur des colonnes pour faire apparaître une colonne sans titre, lui attribuer un espace insécable comme titre: possibilité d'employer un tri automatique (alphabétique ou chronologique) si un contenu est trop long pour tenir sur une seule ligne, une nouvelle ligne est créée automatiquement possibilité d'insérer un saut de ligne grâce à la balise HTML <br> Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 13
Fonctionnement des pages et des boîtes de contenu Niveaux de titres, boîtes et blocs de contenu Une page peut contenu plusieurs paragraphes Chaque paragraphe est une boîte de contenu, qui peut être de l'un des types suivants: o contenu standard o galerie d'images o liste de liens o liste de navigation dynamique o flux RSS o tableau Dans un contenu standard, cette boîte de contenu peut contenir plusieurs blocs de contenu Le titre de la page ainsi que les titres et les sous-titres de paragraphes utilisent les baslises HTML indiquant leur niveau de titre: <h1>, <h2>, <h3>. En mode édition En mode prévisualisation titre de page <h1> titre de paragraphe <h2> blocs de contenu boîte de contenu (dans cet exemple, de type contenu standard sous-titre de paragraphe <h3> Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 14
Récapitulatif du fonctionnement des pages, boîtes et blocs 1. Création d'un page (s'effectue à partir de sa page parente). 2. Sur la page nouvellement créée, ajout d'une boîte de contenu (=paragraphe). 3. Ajout d'un contenu dans la boîte nouvellement créée. 4. Ajout de contenu dans la même boîte, ou création d'une autre boîte sur la même page si nécessaire. L'ordre des boîtes sur la page peut par la suite même être modifié. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 15
Possibilité de menu de navigation à l'intérieur de la page Si une page de contenu est réellement très longue (=défilement de plus de 3 ou 4 écrans nécessaires pour l'afficher), il est possible d'activer une table des matières automatique, qui apparaît alors sous le titre de la page. On peut également compléter cette mise en page en faisant apparaître des lignes séparatrices de paragraphes. Pour activer cette table des matières, utiliser le lien "activer/désactiver ancres" figurant sous le titre de la page en mode édition. Pour activer la ligne séparatrice en fin de paragraphe, éditer les propriétés du paragraphe (icône au-dessus de son titre) et choisir la valeur "on" pour le paramètre "afficher/cacher ligne séparatrice". Gestion de fichiers Le gestionnaire de fichiers de Jahia et le protocole WebDAV Le gestionnaire de fichiers de Jahia est basé sur le protocole WebDAV, dont le nom signifie "Web-based Distributed Authoring and Versioning". Il s'agit d'un système de gestion de fichiers sur Internet permettant à plusieurs utilisateurs de stocker et/ou d'échanger des documents, des images ou des programmes, de manière conviviale et sans logiciel additionnel. Ce n'est pas un système inventé par Jahia, mais un standard ouvert et non commercial, utilisé dans des nombreuses applications web. Pour que ce système fonctionne et ne soit pas totalement anarchique, l'espace dans lequel sont stockés ces fichiers est régi par une organisation et une logique, qui déterminent par exemple qui a le droit de charger, de lire ou d'effacer tel ou tel fichier. Dans une application web utilisant une gestion de fichiers WebDAV, on va donc trouver plusieurs dossiers. Certains sont personnels: par ex. le dossier de l'utilisateur Untel et d'autres sont partagés: le dossier du groupe de travail dont fait partie Untel le dossier de l'entreprise, accessible à tous les groupes. Untel et ses collègues auront, selon leur profil, accès à tel ou tel dossier, parfois avec juste la possibilité de lire les documents qui s'y trouvent, parfois avec même le droit de les effacer. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 16
Structure des dossiers Remarque sur les noms de fichiers et de dossiers: Très important: utiliser uniquement des noms de fichiers et de dossiers "compatibles web", c'est à dire: - sans espaces ni caractères accentués - suivis d'extensions appropriées:.pdf,.jpg,.doc, etc. Pour chaque site Jahia, la structure des dossiers du gestionnaire de fichiers se présente de la manière suivante: root groups shared users trucmuche tartempion etc. Dans le dossier principal (=root) se trouvent le dossier partagé du site (=dossier shared) et le dossier utilisateurs (=users), qui va lui-même contenir les dossiers personnels des différents rédacteurs du site (Untel, Tartempion et leurs collègues). L'interface de Jahia vous permet de: naviguer dans cette structure arborescente de dossiers copier depuis votre disque dur des fichiers dans un dossier copier ou déplacer des fichiers d'un dossier à un autre supprimer ou renommer des fichiers (là où vos droits d'accès l'autorisent) créer de nouveaux dossiers sélectionner un fichier afin de le faire afficher dans un contenu Jahia. Voici comment se présente cette interface: Les chiffres 1 à 4 représentent les différentes zones de la navigation et de la manipulation des fichiers. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 17
1. Raccourcis vers les dossiers importants 2. Affichage du chemin d'accès au dossier courant (=celui dans lequel vous vous trouvez) 3. Contenu du dossier courant 4. Fichier sélectionné (=celui qui s'affichera dans votre contenu Jahia). Dans l'exemple ci-dessus, vous vous trouvez dans le dossier partagé du site (=shared), et vous constatez qu'il contient 9 fichiers. Si vous voulez sélectionner l'un des 9 fichiers pour le faire afficher dans votre contenu Jahia, il suffit de cliquer sur son nom, qui va alors apparaître en gras, puis sur OK pour valider votre choix. Quand un fichier est sélectionné (=en gras) pour apparaître dans le contenu en cours d'édition, il est possible, à choix: de cliquer sur un autre fichier pour le sélectionner à sa place de le désélectionner grâce au lien "Déselectionner fichier" si on souhaite qu'aucun fichier n'apparaisse dans le contenu. Quelques précisions utiles Dossier partagé Le dossier partagé (=shared) est commun à tous les rédacteurs du site, chacun pouvant y placer ou y effacer des fichiers. Il vous faut placer tous vos fichiers dans le dossier partagé du site. Vous pouvez même créer des dossiers à l'intérieur du dossier partagé pour y classer vos fichiers si vous en avez un grand nombre à gérer. Propriétés et manipulation des fichiers Le fait de cliquer sur l'icône "menu" à côté d'un nom de fichier vous permet d'accéder par un menu déroulant à plusieurs informations et actions possibles sur ce fichier: Voir utilisation permet d'afficher la liste des page où ce fichier est employé. Si un fichier doit apparaître dans plusieurs pages du site, il suffit de le charger une seule fois dans Jahia Editer les propriétés permet de spécifier le texte alternatif qui apparaît pour les utilisateurs naviguant sans les images. Attention: ce texte est unique, même dans les sites multilingues. Sélectionner permet de sélectionner le fichier à afficher dans le contenu Jahia en cours d'édition. On parvient aussi au même résultat en cliquant simplement sur le nom du fichier. Si aucun fichier ne doit être sélectionner (=pas d'images pour le contenu en cours d'édition), un lien "Unselect file" est disponible au-dessus de la liste des fichiers. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 18
Publication de pages et verouillage des fichiers Lorsque vous publiez une page dont les boîtes de contenus affichent des fichiers, Jahia verouille ces fichiers afin d'interdire leur effacement accidentel. Ce verrouillage se manifeste par une icône "cadenas" apparaissant avant le nom du fichier. Si vous souhaitez supprimer du serveur un fichier verouillé, il faut: 1) dans le gestionnaire de fichiers, cliquer sur le lien "désélectionner le fichier" 2) publier cette modification (workflow) 3) Jahia supprime ainsi le cadenas, vous permettant ainsi d'aller supprimer le fichier. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 19
Feuille de style CSS Les styles mis à disposition sont compatibles avec la ligne graphique. La famille de polices pour tous ces styles est (par ordre de priorité): Verdana, Arial, Helvetica, sans-serif style taille en pixels couleur caractéristique nom dans le menu déroulant texte standard 11 noir standard lien hypertexte 11 noir souligné titre de paragraphe 12 noir gras sous-titre de paragraphe 11 couleur majeure gras sous-titre texte mis en évidence (3 possibilités à choix) - légende pour images - notes de bas de page 11 noir gras 11 noir italique 11 couleur majeure* textecouleur 9 noir légende Certains de ces styles sont automatiquement appliqués en fonction du contexte, les autres sont sélectionnables par menu déroulant dans l'éditeur WYSIWYG intégré. En complément, précisons les point suivants: Les titres de paragraphes, saisis dans les fenêtres "ajouter contenu" lors de la création d'une boîte de contenu, sont balisés en <h2>. Les sous-titres de paragraphes, appliqués via le menu déroulant dans FCKeditor, sont balisés en <h3>. Le soulignement est strictement réservé aux liens et ne peut pas être utilisé pour la mise en évidence du texte. Les liens figurant dans le contenu sont en noir souligné. Les autres couleurs sont à proscrire, sauf rares exceptions. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 20
Multilinguisme Raison d'être d'un site multilingue L'utilisation de l'option "site multilingue" dans Jahia a pour conséquence une gestion de site plus complexe. Elle n'a de sens que pour un site qui est intégralement traduit. Pour un site appelé à ne comporter qu'une section restreinte dans une autre langue, on créera simplement une rubrique pour cette langue dans le menu de navigation. Existence d'une page dans une langue Dans un site multilingue, une page n'existe dans une langue donnée que si elle reçoit un titre de page pour cette langue. La page "Bienvenue" existera également dans la version anglaise du site Partage de contenu entre les langues du site Pour chaque contenu (texte ou fichier), il est possible d'activer ou non son partage entre les différentes langues. On l'activera par exemple pour une image, qui sera identique dans les différentes langues, mais pas pour le commentaire qui lui est associé. Attention! Lors des mises à jour ultérieures, l'option d'activation du partage doit être sélectionnée à nouveau, elle ne s'applique en effet jamais par défaut. Centre informatique de l'université de Lausanne - Manuel de rédaction Jahia - page 21