Installation : Différence entre versions
| (11 révisions intermédiaires par le même utilisateur non affichées) | |||
| Ligne 20 : | Ligne 20 : | ||
** SelectCategory, pour '''faciliter le choix de catégories''' à appliquer lors de la création ou modification de pages ou de fichiers | ** SelectCategory, pour '''faciliter le choix de catégories''' à appliquer lors de la création ou modification de pages ou de fichiers | ||
** MobileFrontend (pour consultation facilitée sur smartphone). L'affichage de cartes (google maps ou OSM) n'est pas encore possible ; la demande d'extension des fonctionnalités de MobileFrontEnd aux cartes a été déposée sur GitHub. | ** MobileFrontend (pour consultation facilitée sur smartphone). L'affichage de cartes (google maps ou OSM) n'est pas encore possible ; la demande d'extension des fonctionnalités de MobileFrontEnd aux cartes a été déposée sur GitHub. | ||
| + | ** Cargo, pour le requêtage de données complexes (exemple : travaux des facteurs) | ||
== En cours == | == En cours == | ||
| Ligne 25 : | Ligne 26 : | ||
* TimedMediaHandler (pour la lecture de fichiers audio ou video) - pb de config - provisoirement désactivé pour éviter plantage des requêtes de la base de données. Pour l'audio, on utilisera plutôt le format mp3 et l'extension Sound Manager 2 | * TimedMediaHandler (pour la lecture de fichiers audio ou video) - pb de config - provisoirement désactivé pour éviter plantage des requêtes de la base de données. Pour l'audio, on utilisera plutôt le format mp3 et l'extension Sound Manager 2 | ||
* DynamicPageList, pour lister les orgues par facteur intervenant | * DynamicPageList, pour lister les orgues par facteur intervenant | ||
| + | * Page Forms, pour créer des masques de saisie de données complexes | ||
== Envisageables == | == Envisageables == | ||
| Ligne 31 : | Ligne 33 : | ||
* Correcteur orthographique | * Correcteur orthographique | ||
* Kartographer (cartes interactives) | * Kartographer (cartes interactives) | ||
| − | |||
== Écartées == | == Écartées == | ||
* ImageMagick : n'est pas à proprement parler une extension de MediaWiki, mais un programme qui devrait être installé sur le serveur pour traiter les reformatages d'images (création de miniatures, etc.). Comme ce n'est pas le cas, j'ai paramétré localsettings.php pour ne pas chercher à utiliser ce programme. Les reformatages sont effectués par GD, qui est installé par défaut. La gestion des images et des miniatures fonctionne convenablement. | * ImageMagick : n'est pas à proprement parler une extension de MediaWiki, mais un programme qui devrait être installé sur le serveur pour traiter les reformatages d'images (création de miniatures, etc.). Comme ce n'est pas le cas, j'ai paramétré localsettings.php pour ne pas chercher à utiliser ce programme. Les reformatages sont effectués par GD, qui est installé par défaut. La gestion des images et des miniatures fonctionne convenablement. | ||
* Html2Wiki : adaptation à HTML5 en cours... une première tentative d'installation s'est soldée par un crash. Requiert une autre extension (Tidy) qui n'est plus tenue à jour. Ne pas réessayer. | * Html2Wiki : adaptation à HTML5 en cours... une première tentative d'installation s'est soldée par un crash. Requiert une autre extension (Tidy) qui n'est plus tenue à jour. Ne pas réessayer. | ||
| + | |||
| + | == Précautions == | ||
| + | La gestion des extensions et des dépendances mutuelles est délicate, même en utilisant '''composer''', qui est censé nous ôter ce souci. Les dépendances mutuelles exprimées sous forme de versions minimales dans composer.json, sous la forme "^7" pour dire "à partir de 7.0", peuvent occasionner des bugs. De telles notations interviennent lors de l'installation, plus ou moins automatique, d'extensions. | ||
| + | |||
| + | Ici, j'ai dû modifier manuellement, dans composer.json, la version requise pour Maps : il y avait "^7", que j'ai remplacé par une référence à la version actuelle, à savoir 7.15.5. Il faudra s'en souvenir à l'occasion d'une éventuelle mise à jour de Maps... | ||
= Modèles ("templates") = | = Modèles ("templates") = | ||
| Ligne 48 : | Ligne 54 : | ||
* Lieu | * Lieu | ||
| − | ** Particulier (l'adresse sera | + | ** Particulier (<nom> si pas problématique ; l'adresse sera éventuellement indiquée dans l'article lui-même, si pas problématique. En général, pas de noms ni d'adresses de personnes vivantes) |
** Conservatoire | ** Conservatoire | ||
** <Région> (actuellement: Hauts-de-France) | ** <Région> (actuellement: Hauts-de-France) | ||
| Ligne 82 : | Ligne 88 : | ||
La catégorie "Cavaillé-Coll" est '''créée''' en saisissant <nowiki>Category:Cavaillé-Coll</nowiki> dans la boîte de recherche. Si déjà créée, elle apparaîtra dans les résultats de recherche. | La catégorie "Cavaillé-Coll" est '''créée''' en saisissant <nowiki>Category:Cavaillé-Coll</nowiki> dans la boîte de recherche. Si déjà créée, elle apparaîtra dans les résultats de recherche. | ||
| − | Elle est '''utilisée''' en insérant <nowiki></nowiki> dans le texte d'une page ou d'une autre catégorie. S'il s'agit d'une page, cela signifie que désormais, cette page appartient à la catégorie "Cavaillé-Coll". S'il s'agit d'une autre catégorie, par exemple "Facteurs français", cela signifie que la catégorie "Cavaillé-Coll" est un cas particulier de "Facteurs français". | + | Elle est '''utilisée''' en insérant <nowiki>[[Catégorie:</nowiki>''nom de la catégorie''<nowiki>]]</nowiki> dans le texte d'une page ou d'une autre catégorie. S'il s'agit d'une page, cela signifie que désormais, cette page appartient à la catégorie "Cavaillé-Coll". S'il s'agit d'une autre catégorie, par exemple "Facteurs français", cela signifie que la catégorie "Cavaillé-Coll" est un cas particulier de "Facteurs français". |
| + | |||
| + | ''N.B. l'extension Mediawiki:SelectCategory permet d'afficher l'arborescence des catégories chaque fois qu'une page est en mode "Modification". Le choix des catégories est obtenu via des cases à cocher. Les choix multiples sont possibles quand ils ont un sens. | ||
| − | Lors de la création d'une page relative à un orgue de Cavaillé-Coll, on insèrera donc <nowiki></nowiki> dans cette page. Ce texte ne sera pas visible en dehors du mode édition, mais créera un lien (en bas de page, dans le bandeau gris) vers la catégorie "Cavaillé-Coll". | + | Lors de la création d'une page relative à un orgue de Cavaillé-Coll, on insèrera donc <nowiki>[[Catégorie:Cavaillé-Coll]]</nowiki> dans cette page. Ce texte ne sera pas visible en dehors du mode édition, mais créera un lien (en bas de page, dans le bandeau gris) vers la catégorie "Cavaillé-Coll". |
Lors de la création d'une page décrivant l'histoire de la manufacture Cavaillé-Coll, on insèrera ce même lien. | Lors de la création d'une page décrivant l'histoire de la manufacture Cavaillé-Coll, on insèrera ce même lien. | ||
Afin d'éviter que la recherche de pages correspondant à la catégorie "Cavaillé-Coll" ne mélange les orgues et les manufactures, on veillera à compléter les pages avec des catégories supplémentaires : | Afin d'éviter que la recherche de pages correspondant à la catégorie "Cavaillé-Coll" ne mélange les orgues et les manufactures, on veillera à compléter les pages avec des catégories supplémentaires : | ||
| − | * <nowiki></nowiki> pour les pages décrivant des orgues ; | + | * <nowiki>[[Catégorie:Orgue]]</nowiki> pour les pages décrivant des orgues ; |
| − | * <nowiki></nowiki> pour les pages décrivant les facteurs ou manufactures. | + | * <nowiki>[[Catégorie:Facteur]]</nowiki> pour les pages décrivant les facteurs ou manufactures. |
| − | + | ||
=== Interventions majeures et mineures === | === Interventions majeures et mineures === | ||
On souhaite associer aux orgues les noms des facteurs qui ont eu un rôle déterminant, sans pour autant s'interdire de nommer les autres. | On souhaite associer aux orgues les noms des facteurs qui ont eu un rôle déterminant, sans pour autant s'interdire de nommer les autres. | ||
| Ligne 102 : | Ligne 110 : | ||
La page d'accueil propose: | La page d'accueil propose: | ||
| − | * la navigation par Lieu (> Département > Commune) | + | * la navigation par Lieu (> Département > Commune), qui donne accès à tous les documents ; |
| − | * la navigation par orgue (ordre alpha des noms de pages, qui commencent par le nom de commune, puis édifice, puis précision du type "orgue de tribune", "orgue de chœur"... | + | * la navigation par orgue (ordre alpha des noms de pages, qui commencent par le nom de commune, puis édifice, puis précision du type "orgue de tribune", "orgue de chœur"... ; elle donne accès aux seules pages de la catégorie "orgue", pas les sous-catégories (orgues disparus, etc.) |
| − | Cela nécessite que toute page décrivant un orgue comporte les wikitextes suivants: <nowiki></nowiki>. | + | Cela nécessite que toute page décrivant un orgue comporte les wikitextes suivants: <nowiki>[[Category:Orgue]][[Category:</nowiki>''nom_du_lieu''<nowiki>]]</nowiki> pour les orgues existants, ou une sous-catégorie de Category:Orgue pour les orgues projetées, déplacées ou disparues. |
| − | Les communes doivent être déclarées comme catégories (taper Category:Nom-de-la-commune dans le champ de recherche) et leur page doit contenir <nowiki></nowiki> afin que l'arborescence fonctionne. | + | Les communes doivent être déclarées comme catégories (taper Category:Nom-de-la-commune dans le champ de recherche) et leur page doit contenir <nowiki>[[Category:</nowiki>''nom du département''<nowiki>]]</nowiki> afin que l'arborescence fonctionne. |
= Photos, enregistrements = | = Photos, enregistrements = | ||
Version actuelle datée du 12 janvier 2020 à 22:49
Ces instructions ne concernent que les sitemestres et collaborateurs.
Sommaire
Extensions
Le principe est de limiter les extensions au strict nécessaire, maintenabilité oblige. Les extensions les plus courantes sont recensées sur Special:ExtensionDistributor. Une liste plus complète est disponible ici.
Des informations détaillées sur la version de Mediawiki et les extensions installées sont disponibles sur la page spéciale Version.
Installées
- Celles comprises dans la configuration de base de MediaWiki 1.33.1 (elles ne sont pas forcément activées)
- WikiEditor est installée par défaut (dans MW 1.33)
- ImageMap permet de rendre des zones d'une image "clicables" (p.ex. image d'une console : cliquer sur un registre permettrait d'entendre un enregistrement du jeu correspondant).
- CategoryTree permet d'afficher l'arborescence de catégories. Utilisée par certaines "pages spéciale" de MediaWiki ; pourrait être utilisées dans des pages nouvellement créées.
- PdfHandler, permet l'affichage de documents pdf. Comme d'habitude, ces documents doivent être importés puis appelés par [[File:Tagada.pdf]] ou [[Fichier:Tagada.pdf]], avec des options d'affichage détaillées ici.
- Supplémentaires
- Composer (gestion de dépendances PHP)
- GeoData (pour localiser les pages)
- Maps (utilise google maps, plutôt que leaflet)
- Sound Manager 2 Button, pour la lecture des mp3
- SelectCategory, pour faciliter le choix de catégories à appliquer lors de la création ou modification de pages ou de fichiers
- MobileFrontend (pour consultation facilitée sur smartphone). L'affichage de cartes (google maps ou OSM) n'est pas encore possible ; la demande d'extension des fonctionnalités de MobileFrontEnd aux cartes a été déposée sur GitHub.
- Cargo, pour le requêtage de données complexes (exemple : travaux des facteurs)
En cours
- ContactPage - pb de configuration
- TimedMediaHandler (pour la lecture de fichiers audio ou video) - pb de config - provisoirement désactivé pour éviter plantage des requêtes de la base de données. Pour l'audio, on utilisera plutôt le format mp3 et l'extension Sound Manager 2
- DynamicPageList, pour lister les orgues par facteur intervenant
- Page Forms, pour créer des masques de saisie de données complexes
Envisageables
- Bluespice : notamment pour utiliser "Page Template", cf. ci-dessous.
- Visual Editor (mieux adapté à des "novices" que l'édition directe du Wikitext)
- Correcteur orthographique
- Kartographer (cartes interactives)
Écartées
- ImageMagick : n'est pas à proprement parler une extension de MediaWiki, mais un programme qui devrait être installé sur le serveur pour traiter les reformatages d'images (création de miniatures, etc.). Comme ce n'est pas le cas, j'ai paramétré localsettings.php pour ne pas chercher à utiliser ce programme. Les reformatages sont effectués par GD, qui est installé par défaut. La gestion des images et des miniatures fonctionne convenablement.
- Html2Wiki : adaptation à HTML5 en cours... une première tentative d'installation s'est soldée par un crash. Requiert une autre extension (Tidy) qui n'est plus tenue à jour. Ne pas réessayer.
Précautions
La gestion des extensions et des dépendances mutuelles est délicate, même en utilisant composer, qui est censé nous ôter ce souci. Les dépendances mutuelles exprimées sous forme de versions minimales dans composer.json, sous la forme "^7" pour dire "à partir de 7.0", peuvent occasionner des bugs. De telles notations interviennent lors de l'installation, plus ou moins automatique, d'extensions.
Ici, j'ai dû modifier manuellement, dans composer.json, la version requise pour Maps : il y avait "^7", que j'ai remplacé par une référence à la version actuelle, à savoir 7.15.5. Il faudra s'en souvenir à l'occasion d'une éventuelle mise à jour de Maps...
Modèles ("templates")
Il faudrait envisager l'extension "Page Template"
- Attention, l'utilisation inconsidérée de modèles peut compromettre le rendu sur smartphones.
- De même, l'utilisation de tableaux (à la place de listes) ou similaires peut compromettre l'utilisation d'éditeurs visuels. Pour l'instant, on n'utilise que l'éditeur en mode Wikitext, mais ce ne sera pas tenable en cas d'ouverture de la rédaction à de nombreux contributeurs.
Catégories
Arborescence
- Lieu
- Particulier (<nom> si pas problématique ; l'adresse sera éventuellement indiquée dans l'article lui-même, si pas problématique. En général, pas de noms ni d'adresses de personnes vivantes)
- Conservatoire
- <Région> (actuellement: Hauts-de-France)
- <Département> (actuellement : les cinq départements concernés)
- <Commune> (à ajouter au fur et à mesure)
- <Partie de commune> (exemples : Flers et Ascq font partie de Villeneuve d'Ascq)
- <Commune> (à ajouter au fur et à mesure)
- <Département> (actuellement : les cinq départements concernés)
- Personnes (physiques ou morales)
- Organiste
- Facteur (ou manufacture)
- <nom du facteur ou de la manufacture>
si manufacture, précisions (p.ex. si "Pascal": "Pascal, Antoine" ou "Pascal, Jean"...)
- Sujet
- Orgue
- Orgue projeté
- Orgue disparu
- Orgue transféré
- Édifice
- Édifice sans orgue
- Édifice fermé ou disparu
- Orgue
- Document
- Annexe
- Photo
- Audio
Utilisation
Pages et catégories
Il convient de distinguer "page" et "catégorie", même si une catégorie comporte en général une page qui la décrit. Cette distinction sera mise à profit pour permettre de trier les orgues en fonction des facteurs. À cet effet : Les catégories relatives aux facteurs seront créées avec par exemple une arborescence comme :
- Cavaillé-Coll
- Aristide Cavaillé-Coll
- Mutin-Cavaillé-Coll
La catégorie "Cavaillé-Coll" est créée en saisissant Category:Cavaillé-Coll dans la boîte de recherche. Si déjà créée, elle apparaîtra dans les résultats de recherche.
Elle est utilisée en insérant [[Catégorie:nom de la catégorie]] dans le texte d'une page ou d'une autre catégorie. S'il s'agit d'une page, cela signifie que désormais, cette page appartient à la catégorie "Cavaillé-Coll". S'il s'agit d'une autre catégorie, par exemple "Facteurs français", cela signifie que la catégorie "Cavaillé-Coll" est un cas particulier de "Facteurs français".
N.B. l'extension Mediawiki:SelectCategory permet d'afficher l'arborescence des catégories chaque fois qu'une page est en mode "Modification". Le choix des catégories est obtenu via des cases à cocher. Les choix multiples sont possibles quand ils ont un sens.
Lors de la création d'une page relative à un orgue de Cavaillé-Coll, on insèrera donc [[Catégorie:Cavaillé-Coll]] dans cette page. Ce texte ne sera pas visible en dehors du mode édition, mais créera un lien (en bas de page, dans le bandeau gris) vers la catégorie "Cavaillé-Coll".
Lors de la création d'une page décrivant l'histoire de la manufacture Cavaillé-Coll, on insèrera ce même lien.
Afin d'éviter que la recherche de pages correspondant à la catégorie "Cavaillé-Coll" ne mélange les orgues et les manufactures, on veillera à compléter les pages avec des catégories supplémentaires :
- [[Catégorie:Orgue]] pour les pages décrivant des orgues ;
- [[Catégorie:Facteur]] pour les pages décrivant les facteurs ou manufactures.
Interventions majeures et mineures
On souhaite associer aux orgues les noms des facteurs qui ont eu un rôle déterminant, sans pour autant s'interdire de nommer les autres. Les "interventions majeures" pourraient être : construction, reconstruction, transformation, relevage avec modifications importantes (reprises complètes d'harmonie)... à débattre. Le problème est que le système de catégories utilisé par Mediawiki permet une arborescence, mais pas un produit cartésien de catégories indépendantes (permettant d'associer deux critères, voire plus, par exemple : Cavaillé ET construction ET en 1862).
Dans un premier temps, on utilisera les catégories fournies, telles que "Cavaillé-Coll", "Mutin", etc. Dans un deuxième temps, on pourrait envisager des sous-catégories, telles que "Cavaillé-Coll : construction", "Cavaillé - Coll : transformation", etc. Ainsi, tous les travaux de Cavaillé-Coll pourraient être obtenus en inspectant la catégorie "Cavaillé-Coll", quel que soit le niveau d'intervention.
La page d'accueil propose:
- la navigation par Lieu (> Département > Commune), qui donne accès à tous les documents ;
- la navigation par orgue (ordre alpha des noms de pages, qui commencent par le nom de commune, puis édifice, puis précision du type "orgue de tribune", "orgue de chœur"... ; elle donne accès aux seules pages de la catégorie "orgue", pas les sous-catégories (orgues disparus, etc.)
Cela nécessite que toute page décrivant un orgue comporte les wikitextes suivants: [[Category:Orgue]][[Category:nom_du_lieu]] pour les orgues existants, ou une sous-catégorie de Category:Orgue pour les orgues projetées, déplacées ou disparues.
Les communes doivent être déclarées comme catégories (taper Category:Nom-de-la-commune dans le champ de recherche) et leur page doit contenir [[Category:nom du département]] afin que l'arborescence fonctionne.
Photos, enregistrements
Ces fichiers doivent être crédités : non pas dans la page descriptive de l'orgue concerné, mais dans la page propre au fichier (celle qui est créée lors du chargement).
Photos, fichiers audio etc. sont également à "catégoriser" selon la ville. Préférer les noms de fichiers commençant aussi par la ville concernée, suivie par une brève description du contenu, afin de faciliter l'édition.
Photos :
- Résolution : de préférence 2000 pixel sur le bord long,
- Poids < 2.5 MB.
Audio :
- de préférence au format MP3, mode d'encodage "extreme" dans Audacity.
Divers
Logo
Fichier *.png placé dans www/resources/assets (mais ce n'est pas recommandé de choisir ce répertoire, car la référence au logo personnalisé sera effacée à la prochaine mise à jour). Format png et taille maxi 135*135.
Ajustements de localsettings.php
- ajout de $wgExternalLinkTarget = '_blank' afin d'ouvrir les liens externes dans de nouvelles pages.
- ajout d'une liste d'extensions de fichiers acceptables, afin de permettre le chargement de fichiers mp3 et ogg. Voir les instructions détaillées sur la page du manuel en ligne : Manual:$wgFileExtensions.
- Modification de la ligne relative au logo : $wgLogo = "$wgResourceBasePath/resources/assets/_DSC8940.png";
Installation de MediaWiki
MediaWiki 1.33.1 a été installé.
Consultez le Guide de l’utilisateur pour plus d’informations sur l’utilisation de ce logiciel de wiki.
Détails sur cette version : cf. la page spéciale "Version".
