Manual:Pywikibot/Use on third-party wikis


 * If you need more help on setting up your pywikipediabot you can come for help on #pywikipediabot @ freenode server.

The pywikipedia bot may be used to do all kind of things that are important for the maintenance of a MediaWiki project. When this software is to be used outside of the Wikimedia projects, some configuration needs to be done.

Some non-Wikimedia projects, or families, are already supported; which is in the families folder in which you downloaded. Using the existing files as examples, it should be easy to adapt the bot to your own project. (Simply modify the existing files, or create a new file in a notebook.txt file, saving the file in the families folder, with a name such as )

Example: Mozilla wiki
The Mozilla Foundation's wiki, wiki.mozilla.org, is a very simple example because it is only available in one language.

This is the contents of families/mozilla_family.py. Hints for you to write your own family specification are underlined.

import family class Family(family.Family): def __init__(self): family.Family.__init__(self) self.name = 'mozilla' #Set the family name; this should be the same as in the filename. self.langs = { 'en': 'wiki.mozilla.org', #Put the hostname here. }        self.namespaces[4] = { '_default': u'MozillaWiki', #Specify the project namespace here. Other }                              #namespaces will be set to MediaWiki default. self.namespaces[5] = { '_default': u'MozillaWiki talk', }    def version(self, code): return "1.4.2" #The MediaWiki version used. Not very important in most cases. def path(self, code): return '/index.php' #The path of index.php
 * 1) -*- coding: utf-8  -*-
 * 1) The official Mozilla Wiki. #Put a short project description here.

Example: Memory Alpha
memoryalpha_family.py is the "family" definition of Memory Alpha, www.memory-alpha.org, a Star Trek wiki. This specification is a little bit more difficult because it has several languages.

import family class Family(family.Family): def __init__(self): family.Family.__init__(self) self.name = 'memoryalpha' self.langs = { All available languages are listed here. 'de': None, Because the hostname is the same for all languages, 'en': None, we don't specify it here, but below in the hostname 'nl': None, function. 'sv': None, }        # Most namespaces are inherited from family.Family. self.namespaces[4] = { '_default': u'Memory Alpha', All languages use the same project namespace name. }        self.namespaces[5] = { '_default': u'Memory Alpha talk', 'de': u'Memory Alpha Diskussion', 'nl': u'Overleg Memory Alpha', 'sv': u'Memory Alphadiskussion', }        # A few selected big languages for things that we do not want to loop over # all languages. This is only needed by the titletranslate.py module, so        # if you carefully avoid the options, you could get away without these # for another wiki family. self.biglangs = ['en', 'de'] Not very important def hostname(self,code): return 'www.memory-alpha.org' The same for all languages def path(self, code): return '/%s/index.php' % code The language code is included in the path def version(self, code): return "1.4"
 * 1) -*- coding: utf-8  -*-
 * 1) The Memory Alpha family, a set of StarTrek wikis.

Example: Uncyclopædia
The various Uncyclopædias are slightly more awkward as not all are hosted at the same domain or under the same name. Domain names and paths must be specified individually. Most are Wikia-hosted with the exception of fi: hu: ja: no: pt: sv: and zh-tw:. Some have their own registered domain names and the English-language Uncyclopedia also uses a number of custom namespaces.

The approaches which work for an Uncyclopædia or a Memory Alpha project typically can be adapted to other Wikia.

''Note: There have been subsequent updates and changes, see uncyclopedia:es:usuario:Chixpy/uncyclopedia_family.py for the current version of the Uncyclopedia interwiki bot configuration. There are also unresolved issues in which some interwiki languages are not available from all Uncyclopedia projects; proceed with caution.''

import family
 * 1) -*- coding: utf-8  -*-
 * 1) The Uncyclopaedia family, a satirical set of encyclopaedia wikis.
 * 2) Save this file to families/uncyclopedia_family.py in your pywikibot installation
 * 3) The pywikipediabot itself is available for free download from sourceforge.net
 * 1) The pywikipediabot itself is available for free download from sourceforge.net

class Family(family.Family): def __init__(self): family.Family.__init__(self) self.name = 'uncyclopedia' self.langs = { 'ar': 'beidipedia.wikia.com', 'ca': 'valenciclopedia.wikia.com', 'da': 'da.uncyclopedia.wikia.com', 'de': 'de.uncyclopedia.wikia.com', 'el': 'anegkyklopaideia.wikia.com', 'en': 'uncyclopedia.org', 'es': 'inciclopedia.wikia.com', 'fi': 'peelonet.zapto.org', 'fr': 'desencyclopedie.com', 'he': 'eincyclopedia.wikia.com', 'hu': 'hu.uncyclopedia.info', 'it': 'nonciclopedia.wikia.com', 'ja': 'ja.uncyclopedia.info', 'la': 'uncapaedia.wikia.com', 'no': 'ikkepedia.net', 'pl': 'nonsensopedia.wikia.com', 'pt': 'pt.uncyclopedia.info', 'ru': 'absurdopedia.wikia.com', 'sv': 'psyklopedin.hehu.se', 'zh': 'zh.uncyclopedia.wikia.com', 'zh-tw': 'zh.uncyclopedia.info', }       # Most namespaces are inherited from family.Family. self.namespaces[1] = { '_default': u'Talk', 'ar': u'نقاش', 'ca': u'Discussió', 'da': u'Diskussion', 'de': u'Diskussion', 'el': u'Συζήτηση', 'en': u'Talk', 'es': u'Discusión', 'fi': u'Keskustelu', 'fr': u'Discuter', 'he': u'שיחה', 'it': u'Discussione', 'la': u'Disputatio', 'no': u'Diskusjon', 'pl': u'Dyskusja', 'pt': u'Discussão', 'ru': u'Обсуждение', 'sv': u'Diskussion', 'zh-tw': u'討論', }

self.namespaces[2] = { '_default': u'User', 'ar': u'مستخدم', 'ca': u'Usuari', 'da': u'Bruger', 'de': u'Benutzer', 'el': u'Χρήστης', 'en': u'User', 'es': u'Usuario', 'fi': u'Käyttäjä', 'fr': u'Utilisateur', 'he': u'משתמש', 'it': u'Utente', 'la': u'Usor', 'no': u'Bruker', 'pl': u'Użytkownik', 'pt': u'Usuário', 'ru': u'Участник', 'sv': u'Användare', 'zh-tw': u'用戶', }

self.namespaces[3] = { '_default': u'User talk', 'ar': u'نقاش المستخدم', 'ca': u'Usuari Discussió', 'da': u'Bruger diskussion', 'de': u'Benutzer Diskussion', 'el': u'Συζήτηση χρήστη', 'en': u'User talk', 'es': u'Usuario Discusión', 'fi': u'Keskustelu käyttäjästä', 'fr': u'Discussion Utilisateur', 'he': u'שיחת משתמש', 'it': u'Discussioni utente', 'la': u'Disputatio Usoris', 'no': u'Brukerdiskusjon', 'pl': u'Dyskusja użytkownika', 'pt': u'Usuário Discussão', 'ru': u'Обсуждение участника', 'sv': u'Användardiskussion', 'zh-tw': u'用戶討論', }

self.namespaces[4] = { '_default': u'Uncyclopedia', 'ar': u'ويكيبيديا', 'ca': u'Valenciclopèdia', 'da': u'Spademanns Leksikon', 'de': u'Uncyclopedia', 'el': u'Ανεγκυκλοπαίδεια', 'en': u'Uncyclopedia', 'es': u'Inciclopedia', 'fi': u'Hikipedia', 'fr': u'Désencyclopédie', 'he': u'איןציקלופדיה', 'it': u'Nonciclopedia', 'la': u'Uncapaedia', 'no': u'Wikipedia', 'pl': u'Nonsensopedia', 'pt': u'Desciclopédia', 'ru': u'Абсурдопедия', 'sv': u'Psykelopedia', 'zh': u'伪基百科', 'zh-tw': u'偽基百科', }       self.namespaces[5] = { '_default': u'Uncyclopedia talk', 'ar': u'نقاش ويكيبيديا', 'ca': u'Valenciclopèdia Discussió', 'da': u'Spademanns Leksikon diskussion', 'de': u'Uncyclopedia Diskussion', 'el': u'Ανεγκυκλοπαίδεια συζήτηση', 'en': u'Uncyclopedia talk', 'es': u'Inciclopedia Discusión', 'fi': u'Keskustelu Hikipediasta', 'fr': u'Discussion Désencyclopédie', 'he': u'שיחת איןציקלופדיה', 'it': u'Discussioni Nonciclopedia', 'la': u'Disputatio Uncapaediae', 'no': u'Wikipedia-diskusjon', 'pl': u'Dyskusja Nonsensopedia', 'pt': u'Desciclopédia Discussão', 'ru': u'Обсуждение Абсурдопедии', 'sv': u'Psykelopediadiskussion', 'zh': u'伪基百科 talk', 'zh-tw': u'偽基百科討論', }

self.namespaces[6] = { '_default': u'Image', 'ar': u'صورة', 'ca': u'Imatge', 'da': u'Billede', 'de': u'Bild', 'el': u'Εικόνα', 'es': u'Imagen', 'fi': u'Kuva', 'he': u'תמונה', 'it': u'Immagine', 'la': u'Imago', 'no': u'Bilde', 'pl': u'Grafika', 'pt': u'Imagem', 'ru': u'Изображение', 'sv': u'Bild', 'zh-tw': u'圖像', }

self.namespaces[7] = { '_default': u'Image talk', 'ar': u'نقاش الصورة', 'ca': u'Imatge Discussió', 'da': u'Billede diskussion', 'de': u'Bild Diskussion', 'el': u'Συζήτηση εικόνας', 'es': u'Imagen Discusión', 'fi': u'Keskustelu kuvasta', 'fr': u'Discussion Image', 'he': u'שיחת תמונה', 'it': u'Discussioni immagine', 'la': u'Disputatio Imaginis', 'no': u'Bildediskusjon', 'pl': u'Dyskusja grafiki', 'pt': u'Imagem Discussão', 'ru': u'Обсуждение изображения', 'sv': u'Bilddiskussion', 'zh-tw': u'圖像討論', }

self.namespaces[8] = { '_default': u'MediaWiki', 'ar': u'ميدياويكي', 'he': u'מדיה ויקי', 'zh-tw': u'媒體維基', }

self.namespaces[9] = { '_default': u'MediaWiki talk', 'ar': u'نقاش ميدياويكي', 'ca': u'MediaWiki Discussió', 'da': u'MediaWiki diskussion', 'de': u'MediaWiki Diskussion', 'es': u'MediaWiki Discusión', 'fr': u'Discussion MediaWiki', 'he': u'שיחת מדיה ויקי', 'it': u'Discussioni MediaWiki', 'la': u'Disputatio MediaWiki', 'no': u'MediaWiki-diskusjon', 'pl': u'Dyskusja MediaWiki', 'pt': u'MediaWiki Discussão', 'ru': u'Обсуждение MediaWiki', 'sv': u'MediaWiki diskussion', 'zh-tw': u'媒體維基討論', }

#       # Custom namespace list for en: (and fi:) #       self.namespaces[100] = { '_default':u'Wilde', 'en':u'Wilde', 'fi':u'Hikiquote', 'pl':u'Cytaty', }       self.namespaces[101] = { '_default':u'Wilde talk', 'en':u'Wilde talk', 'fi':u'Hiktionary', 'pl':u'Dyskucja cytatów', }       self.namespaces[102] = { '_default':u'UnNews', 'en':u'UnNews', 'fi':u'Hikikirjasto', 'pl':u'NonNews', }       self.namespaces[103] = {'_default':u'UnNews talk'} self.namespaces[104] = {'_default':u'Undictionary'} self.namespaces[105] = {'_default':u'Undictionary talk'} self.namespaces[106] = {'_default':u'Game'} self.namespaces[107] = {'_default':u'Game talk'} self.namespaces[108] = {'_default':u'Babel'} self.namespaces[109] = {'_default':u'Babel talk'} self.namespaces[110] = {'_default':u'Forum'} self.namespaces[111] = {'_default':u'Forum talk'}

# A few selected big languages for things that we do not want to loop over # all languages. This is only needed by the titletranslate.py module, so       # if you carefully avoid the options, you could get away without these # for another wiki family. self.languages_by_size = ['en', 'pl', 'de', 'es', 'ru', 'fr']

def hostname(self,code): return self.langs[code]

def path(self, code): if code=='fi': return '/hikipedia/index.php' if code=='hu': return '/w/index.php' if code=='ja': return '/w/index.php' if code=='no': return '/index.php' if code=='pt': return '/w/index.php' if code=='sv': return '/w/index.php' if code=='zh-tw': return '/w/index.php' return '/wiki/index.php'

def version(self, code): return "1.7"

Language
For a single-language site, the language specified does not matter as long as it is consistent between the user-config.py and families/foo_family.py

Login failed. Wrong password?
Pywikipedia does not report anything more useful than success, failure, or host connection failure. If possible, try accessing the web server logs (apache uses access_log by default) and take a look at the URL strings.

Make sure your path is defined appropriately for your wiki in your families file:

def path(self, code): return '/wiki/index.php'

See the mozilla configuration for clues.

Mismatched interwiki configuration
In some projects (such as Uncyclopedia), each language operates as an independent wiki. This may mean that interwiki tables differ from one individual wiki to another within the same project. Interwiki.py is built on the assumption that, if outbound interlanguage links are available at all from a language, the list of available link-destination languages and the destination URL for each will match perfectly across all wikis in the project.

This leads to some potential pitfalls:
 * If one language is missing outbound language interwiki support entirely, one must avoid giving pywikipediabot an account on that wiki (in user-config.py) in order to ensure that interwiki.py leaves that one language wiki untouched.
 * If one language is using a valid but incomplete interwiki table, running interwiki.py on that language wiki will create broken links. Unlike the case where one language is missing project-wide, there is no clean and easy workaround.
 * If a language in a project has been forked (not just mirrored), the interwiki for each individual language pair will point to only one of the multiple forks. Verify the wiki your bot is looking at is the same one that is being linked from the wiki you're editing - otherwise the bot will delete some valid links as "page does not exist".

Customisation of namespaces
Some projects use non-standard extensions to provide Special:Interwiki and Special:Namespaces lists; where available, these lists should be checked against the configuration files to detect any additional namespace customisations.