Fichothèque

Se documenter

Vincent — 2019-12-22T18:08:14Z

Écrire un manuel clair et exhaustif est une très lourde tâche, avec des risques d'obsolescence rapide. C'est pourquoi nous avons préféré dans un premier temps constituer une banque de connaissance constituée de questions et de réponses.

Ce choix est aussi lié à nos propres pratiques. La plupart du temps, nous trouvons la réponse à nos questions informatiques sur le site Stack Overflow plutôt que sur le manuel du logiciel en question.

La banque de connaissance est accessible soit via la recherche libre, soit par les trois axes rappelés sur chaque page : l'accès par niveau (s'il s'agit d'une question d'uilisation courante ou d'une question de configuration pointue), par thématique et par famille de commande.

SI vous êtes administrateur d'une fichothèque gérée par le logiciel BDF, vous constaterez que chaque commande d'administration est dotée d'un code (Trois lettres en majuscules qui correspondent à la famille de la commande suivies d'un chiffre). Vous pouvez trouver les questions relatives à cette commande (si elles existent) via le moteur de recherche ou via l'accès par famille de commandes).

Rappelons qu'un mémento est disponible via l'interface de BDF (voir la fiche Que trouve t-on dans le Mémento ?)

Introduction au logiciel BDF en vidéo

La vidéo qui suit est l'enregistrement d'une présentation donnée lors d'une Soirée de Conversations autour du Libre (SCL) organisée par Parinux. Cette vidéo est hébergée par l'instance PeerTube de la FDN :

Manuels spécifiques à une fichothèque

Le logiciel BDF offre de nombreuses possibilités d'adaptation. Le manuel couvre l'usage générique mais chaque fichothèque a ses specificités propres. Tel corpus est utilisé dans tel cas, tel thésaurus a telle signification, etc. C'est pourquoi des manuels sont parfois rédigés pour décrire une fichothèque particulière. Ils ne sont pas forcément parlants quand on ne dispose pas de l'accès à la fichothèque mais cela reste une source d'inspiration. Les manuels qui peuvent être rendus publics sont listés ici :

Manuel de la fichothèque du site socioeco.org

Tester

Vincent — 2019-12-15T22:12:14Z

Nous vous proposons plusieurs instances de test.

Un Bac à sable avec quelques exemples de fiches et corpus.
Une copie de la fichothèque des musiques libres de Libre à vous, l'émission sur les libertés informatiques de l'April. Cette fichothèque est aussi accessible par son tableau de bord.

Dans les deux cas, l'identifiant est « ADMIN » et le mot de passe « admin ».

Vous pouvez faire toutes les interventions qui vous chantent sur ces instances : le contenu est régulièrement réinitialisé.

Avoir sa propre fichothèque

Notre serveur de test propose un formulaire d'inscription pour disposer de sa propre fichothèque. Il vous sera demandé vos coordonnées et un courriel vous sera envoyé avec un lien pour créer une nouvelle fichothèque.

L'adresse du formulaire d'inscription est la suivante : https://bdf3.fichotheque.net/multi-subscribe

Comme il s'agit d'un serveur de test, nous ne garantissons pas la pérennité des données. Nous serons notamment susceptibles de supprimer les fichothèques inactives après une longue période.

Télécharger

Vincent — 2013-03-27T11:41:56Z

Binaires

Le binaire de BDF peut être obtenu à l'adresse : https://bdf.exemole.fr/latest/. Il s'agit du dernier code mis en production sur le serveur de la fondation Charles Léopold Mayer, il est évidemment censé être stable mais il peut s'agir d'une version avec de nouvelles fonctions qui n'est déployée que pour quelques fichothèques « d'avant-garde », des bogues non repérés sont possibles.

Le suivi des versions est faite avec des étiquettes sur le dépôt Framagit : https://framagit.org/fichotheque/bdf/-/tags. Les versions antérieures sont archivées à l'adresse : https://bdf.exemole.fr/archives/. De manière générale, il vaut mieux attendre quelques jours lorsqu'une nouvelle version est déposée, les bogues introduits sont repérés dans les premiers jours la plupart du temps.

La version .war est conçue pour être déployée directement dans Tomcat (voir la documentation de Tomcat pour avoir plus d'informations sur le déploiement).

Voir sur le sujet la question « Installer une version de test de BDF sous Debian ou Ubuntu » qui décrit la procédure et qui peut être une source d'inspiration pour les autres distributions.

Sources

Les sources du logiciel sont disponibles sur Framagit : https://framagit.org/fichotheque/bdf

Les sources de la version en production sur le serveur de la Charles Léopold Mayer sont également disponible à l'adresse : https://bdf.exemole.fr/latest/

Les instructions de compilation sont indiquées dans le fichier README.

Le logiciel est sous licence GNU GPLv3.

Tomcat

Tomcat est un logiciel libre présent dans toutes les distributions. Toutes les informations sont disponibles sur le site : https://tomcat.apache.org/. BDF a été testé sur les versions 7, 8 et 9 de Tomcat.

Important : Tomcat 10 a changé les noms des paquets javax.servlets.* en jakarta.servlets.*, le logiciel ne peut pas fonctionner en état, il faut assurer sa conversion (voir la migration de Tomcat 9 à 10). Pour Debian 12, le paquet tomcat-jakartaee-migration peut aider à la migration.

Un travail est en cours pour proposer une version compatible Tomcat 10 à la compilation.