Manual:Interface/Sidebar/fr

MediaWiki:Sidebar définit la barre de navigation, laquelle propose des liens vers les emplacements les plus importants du wiki et fournit aux administrateurs un endroits où ajouter une collection permanente de liens. Par exemple, la plupart des wikis intègreront un lien vers la page de discussion de sa communauté et vers quelques outils utiles.

Les habillages Monobook et le Vector placent la barre de navigation en haut à gauche (en haut à droite pour les langues de droite à gauche) suivi de la barre de recherche et de la boîte à outils, mais le placement peut être différent avec d'autres habillages. Cette barre latérale n'est pas montrée aux utilisateurs du site Mobile.

Personnaliser la barre latérale
Pour personnaliser la MediaWiki:Sidebar dans un wiki, vous devez d'abord être connecté avec un utilisateur ayant le droit editinterface - droit attribué par défaut pour les administrateurs (pour les informations sur l'attribution des droits à des groupes ou des utilisateurs, voir ).

Lorsque vous utilisez un lien vers une page sur votre wiki, mais que vous remplacez le titre de votre page (par exemple ) dans la barre d'URL/addresse par   et que vous chargez cette page - vous devez maintenant voir le contenu actuel de la barre latérale (il se peut que vous deviez utiliser la syntaxe //yourdomain/yourwiki/index.php?title=MediaWiki:Sidebar&action=edit si vous utilisez des URLs longues).

Si le contenu de la barre latérale a déjà été modifié, vous pouvez simplement cliquer sur le lien Editer ou Editer le source, sinon vous pourriez avoir à créer la page d'abord en cliquant sur Créer ou Créer le source.

Note: si vous devez créer une nouvelle page, elle vous sera présentée dans l'éditeur avec le contenu par défaut pour la barre latérale. Pour créer avec succès une page MediaWiki:Sidebar, vous avez besoin de changer le contenu avant de sauvegarder.

Ceci est un exemple de code pour une barre latérale :
 * navigation
 * mainpage|mainpage
 * Special:RecentChanges|Recent changes
 * new heading
 * portal-url|portal
 * http://www.mediawiki.org|MediaWiki home

Cette exemple produira la barre latérale suivante :

Titres
La barre de navigation peut être découpée en sections, chacune avec leur propre titre. Ce titre est récupéré à partir de la liste des éléments de premier niveau (« navigation » et « new heading » dans l'exemple ci-dessus).

Si ce texte correspond au nom d'un message d'interface (une page existante qui a ce titre dans l'espace de noms MediaWiki), alors le texte de la page est utilisé comme une étiquette; sinon, le titre de l'entête est utilisé tel quel.

Pour vous assurer que la version internationalisée est utilisée, vous pouvez utiliser le

** randompage-url|

Liens
Les éléments de liste de second ordre sont les liens ( « mainpage|mainpage » dans l'exemple ci-dessus), où le format est : ** target|link text
 * target
 * La cible du lien peut être le nom d'un message d'interface (page de l'espace de noms MediaWiki) ou d'une page wiki, ou un lien externe. Dans chaque cas, le lien peut être interne, interwiki ou externe. Parfois (liens avec le caractère '&'), un message d'interface est nécessaire. La cible du lien ne peut pas être définie en fonction de la langue d'interface définie dans les préférences.


 * Algorithme suivi :
 * Obtenir le texte cible.
 * S'il existe (ou par défaut) un message d'interface avec ce nom, utiliser le contenu de ce message au lieu du texte cible.
 * Si la sortie de l'étape précédente est une URL valide (commençant avec http:// ou autre protocole d'URL), le lien pointera sur cette URL.
 * Sinon, il sera traité comme le lien cible d'une lien wiki (en pointant vers ce nom de page ou interwiki).
 * Dans le cas où il terminerait en pointant sur '-', toute l'entrée est supprimée de la barre latérale (cela est utile pour supprimer une entrée pour toutes les langues en changeant le message où se trouve le lien).


 * Exemples :
 * " " utilise le texte de MediaWiki:Portal-url (qui contient "").
 * " " liens vers Special:RecentChanges, parce qu'il n'existe pas de message d'interface de ce nom.
 * " " pointe vers w:Foo pour la même raison.
 * " " pointe vers http://www.mediawiki.org pour la même raison.


 * link text
 * The link text can be the name of an interface message (page in the MediaWiki namespace) or plain text.
 * If the link text is the name of an existing or default interface message, the content of that message will be used. MediaWiki will check for localized versions; for example, if the current language is fr (French) and the link text is the interface message "forum", it will check for "forum/fr" before using "forum".
 * Otherwise, the link text is used as the target as-is.
 * Notice that the link text is not optional as in normal wiki links. If the link text is missing, the item is ignored.


 * Exemples :
 * uses MediaWiki:Mainpage (which contains "").
 * uses "Recent changes", since there is no interface message of that name.

Ordre des éléments
By default, the sidebar consists of elements in this order: navigation, search, toolbox, languages. The order can be changed (in MediaWiki 1.13+) by adding special keywords (SEARCH, TOOLBOX and LANGUAGES) to MediaWiki:Sidebar using the heading syntax. For example, the following code moves the search box to the top of the sidebar:
 * SEARCH
 * navigation
 * mainpage|mainpage
 * Special:Recentchanges|Recent changed
 * new heading
 * portal-url|portal
 * http://www.mediawiki.org|MediaWiki home

Tooltips and Accesskey
If you add an item to the sidebar, it will have no tooltip associated. But you can create such a tooltip by doing the following:
 * create a wiki page named "MediaWiki:Tooltip-n- "
 * and put the tooltip in that page.

Accesskeys can also be created by doing the following:


 * create a wiki page named "MediaWiki:Accesskey-n- "
 * and put the accesskey in that page.

Example:


 * uses MediaWiki:Tooltip-n-mainpage-description and MediaWiki:Accesskey-n-mainpage-description.

Traductions
Vous pouvez traduire les chaînes que vous utilisez en modifiant les pages correspondantes dans l'espace de noms MediaWiki.

Exemple: la chaîne qui va remplacer l'élément nommé « mainpage », est prise de MediaWiki:Mainpage. Pour initialiser/modifier ce texte pour les utilisateurs qui affichent votre wiki en allemand, vous pouvez mettre le texte approprié sur la page MediaWiki:Mainpage/de.

De cette manière vous pouvez facilement traduire ces textes via l'interface MediaWiki.

Please note that MediaWiki will by default use the content of the Sidebar page in that language, which corresponds to the default language of your wiki. So, if your wiki e.g. uses French as its default language, edit MediaWiki:Mainpage/fr in order to show a modified sidebar to all users, who have not changed their language setting and to all anonymous users.

Pour des traductions plus avancées, voir see.

Personnalisation avancée
The sidebar can be fully customized by implementing JavaScript or Cascading Style Sheets, or by editing the PHP files directly. Before using these methods, note that:
 * JavaScript is fragile: it will not work for users with JavaScript disabled, and scripts frequently fail in different browsers or skins.
 * Editing the PHP files can easily cause unexpected errors, and your changes will be lost in the next update unless you manually change the new files.

Forcer les messages de l'interface utilisateur à suivre la contenu
Certaines pages doivent parfois suivre la langue du contenu, en particulier pour les sites multilingues. Cela peut être contrôlé avec le paramètre. Chaque message remplacé de cette manière doit être explicitement indiqué, par exemple pour permettre à la barre latérale de se lier aux versions fournies par la langue du contenu de la page principale et de la page de portail, en ajoutant les éléments suivants :


 * code

Ajouter ou supprimer des sections de boîte à outils (JavaScript)
The toolbox, which appears under the search bar, is a dynamic element and cannot be easily customized without the use of skinning extensions (otherwise it requires programming in PHP.) If you still want to do so, you can copy, creating a new skin. You can then make a custom skin to generate these links in your preferred fashion.

Une autre solution JavaScript est proposée ci-desous.

Pour que cette solution fonctionne sur le site MediaWiki entier, ce script doit être copié dans MediaWiki:Common.js (MediaWiki:Common.js est disponible pour MediaWiki 1.9 +).

For this solution to work only for a specific user, add this script to Special:MyPage/common.js (or the JS page for the user's current skin, such as Special:MyPage/monobook.js).

Maintenant configurez simplement quel lien doit apparaître dans quelle section. Vous pouvez aussi supprimer certains liens si vous le désirez.


 * code


 * Usage
 * doit être personnalisé pour ajouter ou supprimer des liens dans les sections spécifiques :



 Si vous voulez restreindre la modification des liens à un groupe particulier d'utilisateurs (par exemple les bureaucrates), modifiez to
 * restreindre les modifications à des groupes spécifiques d'utilisateurs

Pour restreindre les modifications à des adresses IP au lieu d'un groupe spécifique d'utilisateurs, utilisez :

Ajouter ou supprimer les sections de la boîte à outils (PHP)
You can add in your file LocalSettings.php the hook described on this page. With this, you can modify via MediaWiki:Sidebar the links in the toolbox panel (remove some links, change their name) and add custom links (e.g. add the "Recent changes" link there instead of the navigation panel.

Rendre la barre latérale développable/repliable à tous les utilisateurs (habillage Monobook seulement)
Si vous utilisez l'habillage Monobook et ne voulez pas perdre la barre de menu extensible qui se trouve par exemple dans l'habillage Vector, collez le code suivant dans MediaWiki:Monobook.js de votre wiki.

Barre latérale avec l'habillage Monobook (CSS)
You can change the width of your sidebar by adding the following CSS rules to your MediaWiki:Monobook.css, note that this is an article, not a file. This changes the width to 15em, the actions position and portlet width should be an em or so less, so I've set them to 14em in this example.

Modifier le contenu de la barre latérale une fois connecté (PHP)
Vous pouvez modifier la barre latérale en utilisant une accroche. Créez par vous-même une petite extension ou écrivez le code directement dans votre fichier LocalSettings.php.

Quelque exemple de code qui ajoute un bloc avec la barre latérale de 'navigation' comprenant un lien de connexion pour les utilisateurs déconnectés.

Fonctions d'analyse de la barre latérale
Although it is not exactly recommended, the sidebar does support parser functions (such as ParserFunctions), provided the  is outside the parser function, and the parser function does not span multiple lines. For example:
 * Heading

fonctionne. Néanmoins ce qui suit ne fonctionnera pas parce que la fonction d'analyse étend les lignes multiples :
 * Heading

Modifications n'apparaissant pas
MediaWiki met automatiquement en cache le contenu de manière agressive lorsque c'est possible, ce qui entraîne souvent la persistance de la barre de navigation après les modifications. Purger la mémoire cache des pages affectées devrait corriger la situation. Pour effectuer une purge en masse de tous les caches à la fois, touchez le fichier  ou tronquez la table   de votre base de données (vous pouvez avoir à faire les deux).

Vous devez aussi avoir $wgUseDatabaseMessages initialisé à.

Si vous êtes un utilisateur ou un administrateur moyen du wiki, vous ne pourrez pas faire les choses avancées ci-dessus pour que les modifications apparaissent. Si purger ne fonctionne pas non plus, vous pourrez parfois toujours voir les modifications CSS immédiatement dans l'aperçu (en particulier lorsque vous modifiez votre CSS personnel). Par exemple; changer la largeur de la barre latérale, le remplissage ou les marges. Les modifications peuvent toutefois prendre un certain temps après la sauvegarde. Si rien ne s'affiche alors, vous devrez peut-être contacter l'administrateur système du wiki global, ou la ferme de wikis.

Etiquettes de liens en minuscules
Si vos liens ne sont pas mis en majuscules comme vous l'espérez, essayez d'ajouter des espaces de chaque côté du caractère barre verticale; par exemple : ** http://www.example.com/download.php?file=44555 | Download

Des sections disparaissent ou affichent un contenu incohérent
Si une section n'affiche pas ou affiche un contenu inattendu, vérifiez que le texte de l'en-tête n'est pas le nom d'un message d'interface en recherchant Special:AllMessages. Si c'est le cas, utilisez un texte d'en-tête différent ou créez un nouveau message d'interface et utilisez-le.

Par exemple, si vous voulez utiliser « Sidebar » comme texte pour le titre, créez le message d'interface « MediaWiki:Sidebar-header » contenant simplement « Sidebar ». Puis utilisez  comme titre.

Les sections ne sont pas affichées s'il n'y a pas de liens de la forme  (c'est à dire quand la cible a été oubliée).

Liens cassés après une mise à jour Special:Version
Cela se produira, par exemple, à chaque fois qu'il y aura de nouvelles traductions pour les éléments de la barre latérale de la langue de votre site. On pourrait ajouter de nouvelles pages de redirection à chaque fois, mais une meilleure solution serait d’utiliser ses propres noms d’éléments de la barre latérale au lieu d’essayer de garder une trace des traductions actuelles de MediaWiki.

Anciennes versions de MediaWiki
Si vous avez une version de développement 1.5 Beta, ou plus ancienne, il est encore possible dans certains cas de modifier la barre latérale :
 * Avant la branche 1.5 (entre la rev:9150 et la rev:9177) le message utilisé était brièvement MediaWiki:Navbar.
 * Avant ceci, la version 1.4 avait (de la rev:5528 à la rev:9150) une variable globale, nommée $wgNavigationLinks.

Voir aussi

 * w:User:Mike Dillon/Sidebar
 * User:Goldbishop/Sidebar (updated for MW 1.19)
 * - Unsupported PHP modifying hacks that used to be on this page
 * w:User:Mike Dillon/Sidebar
 * User:Goldbishop/Sidebar (updated for MW 1.19)
 * - Unsupported PHP modifying hacks that used to be on this page
 * - Unsupported PHP modifying hacks that used to be on this page