Extension:Popups/fr

L’extension Popups (appelée Aperçus dans Special:Version) affiche les aperçus de page et de référence lors du survol d’un lien vers un article ou respectivement vers une référence. Le premier consiste en des résumés du contenu d’un article, le second indique le contenu complet de la référence.

L’extension est une initiative de l’équipe Design, inspirée par le gadget Navigation popups. Actuellement, cette fonctionnalité est disponible sur toutes les Wikipédia par défaut pour les utilisateurs déconnectés. Une description du fonctionnement de l’extension et plus d’informations sur son utilisation sur les projets Wikimedia sont disponibles à Page Previews.

La fonction Aperçu de référence a finalement été ajoutée et vise à répondre à un souhait de la liste de souhaits technique de la communauté germanophone. Une description plus détaillée et plus d’informations sur son utilisation est disponible à.

Dépendances
Cette extension a une forte dépendance à et  lorsqu'elle est utilisée avec la passerelle par défaut. Il y a aussi des dépendances optionnelles sur (si vous voulez activer les aperçus de référence en version bêta), et  et  (pour l’instrumentation).

Installation

 * Installez les dependencies.


 * === Exemple de configuration de LocalSettings finale pour un site non expérimental (wiki régulier) ===

Options de configuration


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 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 [$[1|qui ajoute un moteur de recherche pour les références]].

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

Popups extension has been optimized 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.



Problèmes connus

 * Les utilisateurs de l’extension 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.
 * Small files may be in the "Рage information" (action=info), but not in the "Popups". Some requirements are set here - for a portrait image: exact (min) height 250 px & max width 203 px; for a landscape image: exact (min) width 320 px &  max height 200 px . To display, images must be able to become a thumbnail that is larger or equal to these "exact" sizes. (If you are cropping a large image to make a leading picture for an article, be sure that the picture you are creating is not smaller than the specified sizes.)

Extensibility
In MediaWiki 1.40, extensions and skins can extend the page previews functionality with their own custom preview types. It does this by registering a PluginModules attribute in its extension.json or skin.json file that points to a ResourceLoaderModule that can register a preview type. The plugin module should export information about when the preview should be displayed (via selector), and how the preview data should be retrieved (via gateway library). This feature is still in its infancy, has a few bugs (example) and feedback/bug reports via Phabricator are encouraged.

FAQ


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é.

Why is content removed from the summary?
Any HTML element marked with the class,  ,  ,  ,  ,   or   will be removed from the summary. If the text should be displayed in the summary, you should under no circumstances use these classes in any templates that are used within the beginning section of an article.



D’où proviennent les résumés ?
Ces données sont fournies par l'API REST (Wikimedia production wikis) ou l'API si votre wiki utilise la passerelle par défaut de.



Pourquoi les parenthèses sont-elles enlevées ?
Il y a une 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.



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 est disponible à partir d’autres espaces de noms. Vous pouvez contourner cela en ajoutant plus d'espace de nom 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
 * Recherche connexe : Wikimedia Performance Team/Authoring Popups: Best Practices