Aide:Pywikipedia/manuelFR

Un article de Wikipédia, l'encyclopédie libre.

Traduction de la documentation de wikipedia.py obtenue au moyen de ce programme :

import wikipedia
import codecs

manuel = file("manuel.txt", "w")

for ligne in wikipedia.__doc__:
    manuel.write(ligne)

Librairie pour prendre et mettre des pages sur un MediaWiki.

Contenu de la librairie

Classes:
Page: Une page MediaWiki
    __init__              : Page(Site, Title) – la page avec le titre Title sur le wiki WikiMedia Site
    title                 : Le nom de la page, dans une forme compatible avec un lien interwiki
    urlname               : Le nom de la page, sous forme d'url
    titleWithoutNamespace : Le nom interwiki de la page, sans l'espace de nom précisé
    section               : La section de la page (la partie du nom apres '#')
    sectionFreeTitle      : Le nom sans la section
    aslink                : Le nom de la page sous la forme [[Titre]] ou [[lang:Titre]]
    site                  : Le wiki où se trouve la page
    encoding              : L'encodage de la page
    isAutoTitle           : Si le titre est générique, auto-traductible (Category, Special, ...)
    autoFormat            : Retourne (dictName, value), avec value qui peut etre une année, date, etc., et dictName qui peut etre 'YearBC', 'December', etc.
    isCategory            : Vrai si la page est une categorie, faux sinon
    isImage               : Vrai si la page est une image, faux sinon

    get (*)               : Le texte de la page
    exists (*)            : Vrai si la page existe actuelement, faux sinon
    isRedirectPage (*)    : Vrai si la page est une redirection, faux sinon
    isEmpty (*)           : Vrai si la page a un contenu de 4 caracteres ou moins, en excluant les interwikis et categories
    interwiki (*)         : Les interwikis de la page (liste de Pages)
    categories (*)        : Les categories de la page (liste de Pages)
    linkedPages (*)       : Les pages normales liées depuis la page (liste de Pages)
    imagelinks (*)        : Les images dans la page (liste de Pages)
    templates (*)         : Tous les modeles liées à la page (liste de chaines)
    getRedirectTarget (*) : La page vers laquelle redirige la page
    isDisambig (*)        : Vrai si la page est une page d'homonymie
    getReferences         : Liste de pages liées vers la page
    namespace             : L'espace de nom de la page
    permalink (*)         : L'url du lien permanent de la version actuelle
    move                  : Déplace la page vers un autre titre

    put(newtext)          : Sauvegarde la page
    delete                : Efface la page (nécessite d'etre connecté)

    (*) : Ceci charge la page si elle n'a pas été chargée avant; permalink peut meme la recharger si elle a été chargée avant

Site: un site MediaWiki
    messages              : There are new messages on the site (il y'a ?)
    forceLogin(): Ne pas continuer tant que l'usager s'est conecté au site
    getUrl(): Obtenir une URL depuis le site

    Pages speciales :
        Pages dynamiques :
            allpages(): Special:Allpages
            newpages(): Special:Newpages
            longpages(): Special:Longpages
            shortpages(): Special:Shortpages
            categories(): Special:Categories

        Pages en cache :
            deadendpages(): Special:Deadendpages
            ancientpages(): Special:Ancientpages
            lonelypages(): Special:Lonelypages
            uncategorizedcategories(): Special:Uncategorizedcategories
            uncategorizedpages(): Special:Uncategorizedpages
            unusedcategories(): Special:Unusuedcategories

Autres fonctions :
getall(): Charge les pages via Special:Export
setAction(text): Utilise 'text' au lieu de "Wikipedia python library" dans les champs résumé
argHandler(text): Vérifiesi text est un argument defini dans wikipedia.py (ce sont -family, -lang, -log et d'autres)
translate(xx, dict): dict est un dictionnaire, donnant le texte selon le langage, xx est un langage. Retourne le texte dans la forme la plus exploitable pour le xx: wiki

output(text): Affiche le texte 'text' dans l'encodage de la console de l'usager
input(text): Effectue une demande aupres de l'usager en affichant 'text' avant
showDiff(oldtext, newtext): Affiche à l'écran la différence entre oldtext et newtext

getLanguageLinks(text,xx): obtient tous les liens interlangue du texte wikicode 'text' sous la forme xx:nompage
removeLanguageLinks(text): donne le wiki-code 'text' sans aucun lien interlangue
replaceLanguageLinks(oldtext, new): in the wiki-code 'oldtext' remove the
    language links and replace them by the language links in new, a dictionary
    with the languages as keys and either Pages or titles as values (confus)
getCategoryLinks(text,xx): obtient tous les liens categories dans le texte 'text' (liens sous la forme xx:nompage)
removeCategoryLinks(text,xx): retire tous les liens categories dans 'text'
replaceCategoryLinks(oldtext,new): replace the category links in oldtext by
    those in new (new a list of category Pages) (fait du remplacement aussi)
stopme(): utiliser lorsque le bot n'a plus besoin de communiquer avec le wiki. Cela enlevera le bot de la liste des taches courantes, et ne ralentira plus les autres bots.