Extension:Popups/fr

The Popups extension displays page and reference previews when hovering over a link to an article or respectively to a reference. The former consists of summaries of an article's content, the latter shows the full content of the reference.

The extension is an initiative of the Design team, inspired by the popular Navigation popups gadget. Currently this feature is available on all Wikipedias by default for logged-out users. A description of how the extension functions and more information on its use on Wikimedia projects is available at Page Previews.

The Reference Previews feature was added eventually and aims to fulfill a wish from the German-speaking community's Technical Wishlist. A more detailed description and more information on its use is available at.

Dépendances
This extension has a hard dependency on and. There are also optional dependencies on (if you want to enable the Reference Previews as beta feature), and  and  (for instrumentation).

Installation

 * Install the dependencies.

Page previews API
Every project is different, and what displays in your previews is highly dependent on the content inside your wiki.

Extension:Popups has been optimised to work with Wikipedia-like content (e.g. wikitext). If your wiki is using a different kind of content handler (for example as is the case for ) it will need to provide its own API.

The API can be written in any language, but the response of the API must match the spec defined here:

Defining new APIs is out of scope for the Popups extension.

Once defined, you can configure page previews to point to your API using  configuration option.

Contenu des aperçus de page
Les popups de prévisualisation de la page affichent une image (si elle est disponible) et un petit extrait de texte.

Image
L’image provient du qui retourne la vignette la plus appropriée associée à un article. Il ignore les modèles de maintenance, les talons, les icônes de drapeau, etc.

Texte
Les aperçus de page peuvent être configurés avec n’importe quelle API compatible compatible avec Page content service summary endpoint en utilisant. Pour les tiers, nous encourageons l’utilisation du Page Content Service pour profiter de l’utilisation de Popups avec votre wiki local.

Vous pouvez également utiliser l’extension. Cette extension a various caveats et nous ne supportons pas activement l’utilisation de cette API.

Contenu des aperçus de référence


Le contenu de la fenêtre de prévisualisation de référence est directement extrait de la section de référence de la page elle-même. Aucun service externe n’est impliqué ici. Si le contenu dépasse la taille du popup, les barres de défilement sont affichées pour que tout puisse être regardé.

Types de référence
Les types de référence affichés sont définis en utilisant des classes CSS spécifiques sur la balise qui peuvent être utilisées pour encapsuler le contenu d’une référence par ex.. Actuellement, les types suivants sont pris en charge :,  ,  ,  ,. En dehors de cela, il y a toujours un repli générique si ni la balise cite n’a été trouvée ni une classe appropriée n’a été utilisée. Veuillez noter qu’il n’est pas recommandé d’utiliser les classes CSS directement dans wikitext, mais plutôt en créant templates.

Le moteur de rendu
Ces extensions n’ont actuellement qu’un seul moteur de rendu, c’est-à-dire pour les pages ordinaires.

De nouveaux rendus pour différents types de pages, ou des choses comme des références peuvent être facilement ajoutées.

Il faut créer un nouvel objet avec les méthodes suivantes:



Vous pouvez voir les détails de ces méthodes dans ext.popups.renderer.article.js ou dans ce patch qui ajoute un moteur de recherche pour les références.

Problèmes connus

 * Les utilisateurs de l’extension Translate devraient noter que Page Previews demande des prévisualisations dans la langue de contenu de la page. Si l’aperçu contient un bloc traduisible complet, il sera traduit. Si, cependant, l’aperçu contient un bloc traduisible incomplet – parce qu’une phrase est coupée, disons – alors il n’est pas traduit et sera affiché dans la langue de contenu de la page. Si vous observez ce comportement, vous devriez envisager de marquer des phrases individuelles dans votre section principale.
 * T167852 est destiné à un public technique mais contient plus d’informations sur le problème sous-jacent.
 * Découpage de formules mathématiques plus longues en aperçu - les formules mathématiques ou chimiques longues (formules plus larges que la largeur de l’aperçu) s’affichent tronquées dans les aperçus. Nous n’avons pas été en mesure d’ajouter un gradient pour indiquer que la formule se poursuit sur l’article lui-même.

Pourquoi ne puis-je pas copier et coller du texte à partir d’un aperçu ?
Au moment de la rédaction, les inconvénients de le faire l’emportent sur les avantages. Essentiellement, il se résume à diminuer la zone de contact pour lire l’article au complet. Une fois que Page Previews est déployé sur Wikipedia anglais et allemand, n’hésitez pas à rouvrir cette tâche et relancer la discussion, mais pour l’instant nous n’avons pas de plans.

Comment puis-je modifier l’image que je vois sur l’aperçu ?
Voir Extension:PageImages#Image choice.

Comment puis-je supprimer le contenu d’un aperçu de page ?
Tout élément marqué avec la classe  sera retiré du résumé.

D’où proviennent les résumés?
Ceux-ci sont fournis par Summary REST API.

Pourquoi les parenthèses sont-elles enlevées ?
Il y a une bonne discussion en cours en T91344 dans Phabricator. Si vous avez des vues sur ceci ou voyez des problèmes relatifs à ceci, veuillez nous le faire savoir là.

Pourquoi je ne vois pas de popups en dehors des espaces de noms de contenu ?
Les popups apparaissent uniquement sur les liens vers les pages dans les espaces de noms de contenu. C’est une limitation de Popups; TextExtracts sont disponibles à partir d’autres espaces de noms. Vous pouvez contourner cela en ajoutant plus de namespaces dans.

Liens

 * Aperçu de la page help page et central feedback page sur MediaWiki.org
 * Aperçu des références help page et central feedback page sur MediaWiki.org
 * Aperçu des références page du projet principal sur Meta
 * Related research: Wikimedia Performance Team/Authoring Popups: Best Practices