Manuel Bokeh

logo-bokeh

 

manuel_bk-01

 

Bibliothèque municipale de Varzy Manuel des bénévoles (mise à jour du 5 août 2026) Source en ligne : https://bibli.dynv6.net/bokeh/ Version PDF disponible ici : Manuel_Bokeh_Varzy.pdf

 

TABLE DES MATIÈRES

Présentation

Bokeh, le site de la bibliothèque

Bokeh, c’est le CMS (Content Management Systeme) des bibliothèques adossé à Waterbear. Il est destiné aux usagers de la bibliothèque.

Bokeh permet :

Base de données de Bokeh

Mise à jour automatique :

Chaque nuit, les modifications faites sur la base de Waterbear sont transférées dans la base de Bokeh. Les nouveaux documents, les nouveaux lecteurs, les documents détruits... tout est mis à jour le lendemain.

Mise à jour manuelle :

En cas de besoin impératif, il est possible de "pousser" une mise à jour à partir de Waterbear en utilisant le compte administrateur.

Composition du site Bokeh

La bannière : c'est l'identité du site, elle contient le logo de la bibliothèque, le logo de la Mairie et le logo de la bibliothèque départementale de la Nièvre. Il est possible de téléverser une nouvelle bannière, puis de l'activer.

Le menu horizontal : c'est un menu déroulant qui permet de naviguer dans les catégories d'articles, mais pas seulement. On trouve notamment un lien vers la page de RECHERCHE avancée. Ce menu est modifiable.

Le menu vertical : il contient plusieurs boîtes (rechercher, Se connecter, Nouveautés). Il est possible d'ajouter (ou retirer) des boîtes (fonctions).

Les articles : Les articles peuvent contenir du texte, des images, des liens, des pièces jointes, des contenus multimédias, des carrousels, des kiosques...

Les catégories : les articles sont classés dans des catégories qui peuvent elles-même contenir des sous-catégories. À ce jour l'arborescence des catégories est la suivante :

manuel_bk-05

ANIMATIONS est une catégorie qui contient quatre sous-catégories (Atelier d'écriture, café lecture...). Ces catégories ont été ajoutées au lancement du site. Il est possible de créer d'autres catégories.

On peut remarquer que ces catégories ont été ajoutées à la barre de menu supérieure. C'est un choix, ce n'est pas automatique :

manuel_bk-07

Quand on clique sur ANIMATIONS, on déroule le menu des animations (Conférences, Atelier...)

manuel_bk-08

Rappel sur les images

Il est important d'insérer des photos ou des images dans les articles. Cependant, il faut impérativement respecter les règles suivantes :

 

Caution

Il est classique de voir dans des documents, des images insérées à leur taille d'origine, en jouant sur la taille d'affichage (en px ou en %).

C'est une mauvaise habitude : les images sont plus petites à l'écran, mais elles gardent leur poids en ko. Il ne faut pas s'étonner ensuite de voir les pages se charger lentement et de voir les documents peser plusieurs Mo.

Tip

Pour redimensionner les images, on peut utiliser les logiciels libres et gratuits :

  • Pinta ou GIMP sous Linux

  • Photofiltre ou GIMP sous Windows

Connexion à Bokeh

Le site Bokeh de la bibliotèque est disponible à l'adresse suivante :

https://new.mabib.fr/la_chouette

Connexion en usager (lecteur)

Pour se connecter, il faut saisir :

Une fois connecté, on a un message d'accueil "Bonjour xxx", et le nombre de prêts en cours :

manuel_bk-02

Connexion en administrateur

L'identifiant de l'administrateur est l'adresse mail (orange) de la bibliothèque. Si vous lisez cette documentation, celà suppose qu'on vous a donné le mot de passe.

manuel_bk-03

On voit immédiatement que l'on est connecté en administrateur, à la présence de plusieurs icônes gris qui permettent d'éditer les différents boîtes. Mais surtout, on a la présence de la clé suivie de "Administration" en haut à gauche.

À partir de là, tout est possible, il convient d'agir avec prudence pour ne pas "planter" le site.

Tip

Il suffit de se positionner (sans cliquer) sur les icônes, pour afficher leur fonction.

Caution

Si les icônes d'administration ne sont pas présentes, il faut cliquer sur Administration (en haut à gauche), puis cocher "Afficher les icônes d'administration" dans le menu vertical.

Le menu d'administration

Pour accéder au menu complet de l'administration, il faut cliquer sur le bouton Administration en haut à gauche, puis sur le premier lien Accès pro.

Dans Gestionnaire de contenu, on a accès à tous les composants du site, dont ceux qui vont nous intéresser en premier lieu :

Caution

Certains dossiers sont sensibles et il convient de ne pas les modifier sous peine de perdre le site :

  • css (Cascading Style Sheets en anglais) : c'est la décoration intégrale du site et c'est une affaire de spécialiste

  • il en va de même pour js, flash, il8n

Contenu de l'explorateur de fichiers lors de la première connexion :

manuel_bk-17

Comme son nom l'indique (userfiles), ce dossier est réservé aux fichiers des administrateurs du site. Il contient des dossiers qui permettent de classer les données par type. On peut bien évidemment ajouter des dossiers pour d'autres types.

Important

Il faut veiller à être particulièrement ordonné, et ne pas hésiter à créer des dossiers et des sous-dossiers, avec des noms explicites et/ou des dates, pour ne pas se retrouver dans une jungle au bout de quelques mois.

Les profils

Par défaut, à la création de votre portail, vous disposez d'au moins un profil. Ce profil est la page d'accueil de votre site qui accueillera les usagers après saisie de l'url dans un moteur de recherche. Toutefois, Bokeh permet la création et la gestion d'un nombre illimité de profils. On peut par exemple imaginer un profil dédié à la jeunesse, un autre au multimédia...

Accès aux profils

Pour accéder à la liste des profils, cliquer dans le menu Profil dans le bloc Mise en page.

À la prise en main du site, on a un profil global nommé "Portail" sous lequel on trouve le profil "Accueil" qui pour l'instant s'applique partout.

manuel_bk-18

Architecture du profil "Portail"

Pour configurer le "Portail" on clique sur le crayon au bout de la ligne :

manuel_bk-15

Dans l'onglet [ Affichage ], on accède à l'allure générale du site :

manuel_bk-19

Sur cette page, on voit qu'actuellement le site a une largeur de 1000 pixels, qu'il est possible d'avoir trois division dans la zone principale, mais que le nombre de divisions actives est 2. La division 1 a une largeur de 220 px, la division 2 a une largeur de 780px (220 px + 780 px = 1000 px).

L'architecture en sortie d'installation est la suivante :

manuel_bk-20

Le haut du site (header) est composé de la bannière et du menu horizontal. En bas du site on trouve le footer.

Note

Les dimensions indiquées correspondent au site fraîchement installé.

Configuration du profil "Portail"

Il est question ici, des différentes boîtes installées dans les divisions.

Pour accéder à la configuration de l'accueil, il faut cliquer sur le crayon à droite de la ligne :

manuel_bk-21

On accède à la fenêtre suivante :

manuel_bk-22

Dans la partie supérieure, on trouve la bibliothèque des boîtes disponibles. On place ces boîtes dans les divisions en fonction du profil :

manuel_bk-23

Dans la partie inférieure, on trouve les boîtes installées dans le profil :

manuel_bk-24

Il suffit de glisser les boîtes de la bibliothèque vers sa destination. Une petite clé permet de paramétrer les boîtes.

La bannière

Pour configurer la bannière, on va dans le menu pro :

manuel_bk-25

Dimensions de l'image de fond de la bannière

L'image que l'on souhaite utiliser pour la bannière doit faire la largeur fixée dans l'architecture du Portail dans l'onglet [ Affichage ].

Il faut maintenant choisir la hauteur :

manuel_bk-26

Dans le cas présent, la bannière fait 1000 x 100 px.

Téléversement de la bannière

On va dans le menu pro : Administration / Accès Pro.

Puis dans Gestionnaire de contenu / Explorateur de fichiers et enfin le dossier bannières.

manuel_bk-13

Il ne reste plus qu'à cliquer sur Téléverser pour envoyer la nouvelle bannière qu'il faudra ensuite choisir.

Choix de la bannière

Toujours dans le menu vertical à gauche : Mise en page / Profils

manuel_bk-14

Cliquer sur le crayon en bout de ligne du "Portail" :

manuel_bk-15

  1. Dans l'onglet Bannière.

  2. Choisir l'Image de fond avec le bouton Explorer le serveur.

  3. Puis Valider.

manuel_bk-16

Confirmer le choix en cliquant sur Sélectionner :

manuel_bk-44

Puis sur Valider :

manuel_bk-45

Il ne reste plus qu'à aller à l'accueil du site pour vérifier. Ne pas hésiter à faire un [Ctrl] + [F5] pour rafraîchir la page.

Catégories et articles

Pour ajouter une catégorie ou un article :

Ajout d'une catégorie :

Exemple : ajout d'une catégorie "Infos".

manuel_bk-34

manuel_bk-35

On renseigne le libellé, on valide et on clique sur Retour.

Note

Il est possible de gérer les droits d'accès sur une catégorie (Cf chapitre dédié aux droits d'accès).

Ajout d'un article

Exemple : ajout d'un article "Contact" dans la catégorie "Infos" :

On clique l'icone "Ajouter un article" au bout de la ligne de la catégorie "Infos".

manuel_bk-36

On accède à la page de configuration de l'article :

manuel_bk-37

On renseigne le titre (contact) de l'article et on clique sur l'onglet [ Article ] pour passer à l'édition de l'article :

manuel_bk-39

Édition de l'article que l'on vient d'ajouter

(Dans l'onglet Article)

Le menu de l'éditeur est typique des éditeurs de blogs.

manuel_bk-10

Détail des fonctions disponibles :

Manuel_bk-11

L'éditeur permet de répondre à la majorité des besoins au sein d'un article.

Pour des besoins spécifiques dans la présentation d'un article, il est possible d'afficher la source (Mode d'affichage) pour travailler directement dans le code HTML de l'article.

Exemple : édition de l'article contact

manuel_bk-40

Résumé de l'article

(Onglet Résumé pour l'affichage dans les boîtes)

C'est le chapeau de l'article, le texte de présentation qui s'affiche avant de demander l'affichage complet de l'article.

Indexation

(Onglet indexation)

Mettre des tags séparés par des ";" pour permettre des recherches par centre d'intérêts.

Laisser la coche sur "Indexer l'article dans le catalogue"

Publication

On clique sur l'onglet Publication.

manuel_bk-12

Les options sont explicites.

Note

Quand on ne donne pas de dates de publication (du, au), l'article est immédiatement publié et sans limite de temps.

Caution

Penser à décocher "Autoriser les commentaires".

Important

Pour que l'article apparaisse dans le menu horizontal, il faut ajouter un lien dans celui-ci (voir "Ajout d'un élément au menu").

Modification d'un article publié

Exemple : modification de la page d'accueil

On entre en mode édition en cliquant sur le crayon incliné dans le titre de l'article :

manuel_bk-04

On obtient la fenêtre de modification de l'article :

manuel_bk-12

Les menus des profils

Il s'agit du menu horizontal situé en-dessous de la bannière. Le menu est propre à un profil.

Pour configurer un menu horizontal, on va dans le menu pro :

manuel_bk-27

On obtient la fenêtre suivante :

manuel_bk-28

Sur un site fraîchement installé, pour le profil "Portail", on trouve deux éléments :

manuel_bk-30

Ajout d'un élément au menu

Cliquer sur l'icone en début de ligne :

manuel_bk-29

Exemple : ajout d'un lien Contact pour afficher l'article Contact de la catégorie Infos.

Cliquer sur l’icône au début de la ligne "Menu horizontal", puis cliquer dans la case "Éléments du menu" :

manuel_bk-31

Une liste d'éléments disponibles apparaît. Il suffit d'ajouter l'élément souhaité à la colonne des éléments sélectionnés. On peut réorganiser la colonne des éléments sélectionnés.

manuel_bk-32

On valide et on ferme. Le lien est présent, mais l'intitulé est absent :

manuel_bk-33

On clique ensuite sur le crayon au début de la ligne qui apparaît pour l'instant vide :

manuel_bk-41

On saisit le texte du lien, on va chercher l'article Contact dans Portail / Infos, puis on clique sur Valider et fermer.

Quand on affiche le site, on trouve bien le lien contact dans le menu horizontal, qui permet d'afficher l'article Contact :

manuel_bk-42

Tip

Parmi les icônes, un œil permet d'afficher le site sans se déconnecter

manuel_bk-43

Supprimer un élément du menu

Pour supprimer un élément du menu, on procède comme pour l'ajout, mais au lieu de déplacer l'élément de DISPONIBLES vers SÉLECTIONNÉ, on fait l'inverse, on renvoie l'élément à supprimer vers DISPONIBLE.

manuel_bk-38

 


Manuel édité sous Typora avec le thème Infobook. licence

Les thèmes

Cliquer sur le bouton Administration en haut à gauche, puis sur le premier lien Accès pro.

Activer le magasin de thèmes

Pour accéder aux thèmes, il activer le magasin.

Aller dans le menu Système > Variables :

manuel_bk-46

Filtrer les variables en cherchant le mot "magasin" :

manuel_bk-47

Il suffit maintenant d'activer l'accès au magasin.

Le magasin de thèmes

Si l'accès a été activé (chapitre précédent), on peut aller dans "Mise en page > Magasin de thèmes" :

manuel_bk-48

On choisit ensuite de tester une thème en cliquant sur la première icône (baguette magique) :

manuel_bk-49

Le thème par défaut est le thème "Historique".

Note

Tester un thème ne conduit pas à son installation. Par-contre, le test ajoute des profils qu'il faudra sans doute supprimer par la suite.

 


Manuel édité sous Typora avec le thème Infobook. licence