Extension:MobileFrontend/MobileViewAPI

From mediawiki.org
This page is a translated version of the page Extension:MobileFrontend/MobileViewAPI and the translation is 100% complete.

Les APIs sont fournies par l'extension MobileFrontend, mais sont devenues obsolètes en faveur du Service de contenu mobile lui-même obsolète en faveur du Service de contenu de page. Utilisez ces APIs à vos propres risques. Elles seront bientôt marquées obsolètes et pourront disparaître (bien que nous vous fournirons assez d'informations en temps voulu) ! Si vous les utilisez, veuillez nous contacter sur la page de discussion si vous avez un quelconque problème.

Plan d'obsolescence

The noimages property was removed in 2019. Voir phab:T99009 .

API

Fournit du contenu optimisé pour les appareils mobiles, pour être utilisé par les applications pour mobile et l'affichage dynamique des sections. Presque comme une fonctionnalité restreinte action=parse, mais plus flexible, et qui retourne des sections séparées qui sont toujours obtenues à partir de l'analyse syntaxique d'une page complète.

Paramètres :


page Titre de la page à traiter.
sections ' pour lesquelles vous voulez le texte (ou all pour toutes les sections).
redirect Indique s'il faut suivre les redirections, yes (par défaut) ou no. Ce paramètre est volontairement rendu similaire à celui de index.php .
prop Quelle information récupérer :
  • text: HTML de la ou des section(s) sélectionnée(s)
  • sections: Information à propos de toutes les sections de la page
  • normalizedtitle: Le titre normalisé de la page sera retourné seulement s'il est différent du titre spécifié.
sectionprop ' définis par l'analyseur syntaxique. C'est la même chose que dans action=parse : toclevel, level, line, number, index, fromtitle, anchor. « byteoffset » est exclu car il n'a pas de sens pour cette action.
noheadings Retourne le HTML sans les titres.

Les informations de section qui sont retournées comprennent aussi le id de chaque section - c'est un numéro qui commence à zéro; et pour les sections qui contiennent des références ajoutées par Cite , il y a aussi un membre de données references .

Exemples :

Résultat
{
    "mobileview": {
        "sections": [
            {
                "id": 0,
                "text": "<p>Hi<sup id=\"cite_ref-1\" class=\"reference\"><a href=\"#cite_note-1\">[1]</a></sup></p>"
            },
            {
                "toclevel": 1,
                "line": "This is first section",
                "id": 1
            },
            {
                "toclevel": 2,
                "line": "This is nested section",
                "id": 2
            },
            {
                "toclevel": 1,
                "line": "References",
                "id": 3,
                "references": ""
            }
        ]
    }
}

Requête identique pour XML :


Résultat
<?xml version="1.0"?>
<api>
  <mobileview>
    <sections>
      <section id="0" xml:space="preserve">&lt;p&gt;Hi&lt;sup id=&quot;cite_ref-1&quot; class=&quot;reference&quot;&gt;&lt;a href=&quot;#cite_note-1&quot;&gt;[1]&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;</section>
      <section toclevel="1" line="This is first section" id="1" />
      <section toclevel="2" line="This is nested section" id="2" />
      <section toclevel="1" line="References" id="3" references="" />
    </sections>
  </mobileview>
</api>

api.php?action=mobileview&page=Extension:MobileFrontend/Example&sections=0&prop=text|sections&format=xml