You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
prototyping-times/mediawiki-api-part-2.ipynb

10 KiB

MediaWiki API (part 2)

This notebook:

  • continues with exploring the connections between Hypertext & Dérive
  • uses the query & parse actions of the MediaWiki API, which we can use to work with wiki pages as (versioned and hypertextual) technotexts

Epicpedia

Reference: Epicpedia (2008), Annemieke van der Hoek \ (from: https://diversions.constantvzw.org/wiki/index.php?title=Eventual_Consistency#Towards_diffractive_technotexts)

In Epicpedia (2008), Annemieke van der Hoek creates a work that makes use of the underlying history that lies beneath the surface of each Wikipedia article.[20] Inspired by the work of Berthold Brecht and the notion of Epic Theater, Epicpedia presents Wikipedia articles as screenplays, where each edit becomes an utterance performed by a cast of characters (both major and minor) that takes place over a span of time, typically many years. The work uses the API of wikipedia to retrieve for a given article the sequence of revisions, their corresponding user handles, the summary message (that allows editors to describe the nature of their edit), and the timestamp to then produce a differential reading.

In [ ]:
import urllib
import json
from IPython.display import JSON # iPython JSON renderer

Query & Parse

We will work again with the Dérive page on the wiki: https://pzwiki.wdka.nl/mediadesign/D%C3%A9rive (i moved it here, to make the URL a bit simpler)

And use the API help page on the PZI wiki as our main reference: https://pzwiki.wdka.nl/mw-mediadesign/api.php

In [ ]:
# query the wiki page Dérive
request = 'https://pzwiki.wdka.nl/mw-mediadesign/api.php?action=query&titles=D%C3%A9rive&format=json'
response = urllib.request.urlopen(request).read()
data = json.loads(response)
In [ ]:
JSON(data)
In [ ]:
# parse the wiki page Dérive
request = 'https://pzwiki.wdka.nl/mw-mediadesign/api.php?action=parse&page=D%C3%A9rive&format=json'
response = urllib.request.urlopen(request).read()
data = json.loads(response)
In [ ]:
JSON(data)
In [ ]:
 

Links, contributors, edit history

We can ask the API for different kind of material/information about the page.

Such as:

  • a list of wiki links
  • a list of external links
  • a list of images
  • a list of edits
  • a list of contributors
  • page information
  • reverse links (What links here?)
  • ...

We can use the query action again, to ask for these things:

In [ ]:
# wiki links: prop=links
request = 'https://pzwiki.wdka.nl/mw-mediadesign/api.php?action=query&prop=links&titles=D%C3%A9rive&format=json'
response = urllib.request.urlopen(request).read()
data = json.loads(response)
JSON(data)
In [ ]:
# external links: prop=extlinks
request = 'https://pzwiki.wdka.nl/mw-mediadesign/api.php?action=query&prop=extlinks&titles=D%C3%A9rive&format=json'
response = urllib.request.urlopen(request).read()
data = json.loads(response)
JSON(data)
In [ ]:
# images: prop=images
request = 'https://pzwiki.wdka.nl/mw-mediadesign/api.php?action=query&prop=images&titles=D%C3%A9rive&format=json'
response = urllib.request.urlopen(request).read()
data = json.loads(response)
JSON(data)
In [ ]:
# edit history: prop=revisions
request = 'https://pzwiki.wdka.nl/mw-mediadesign/api.php?action=query&prop=revisions&titles=D%C3%A9rive&format=json'
response = urllib.request.urlopen(request).read()
data = json.loads(response)
JSON(data)
In [ ]:
# contributors: prop=contributors
request = 'https://pzwiki.wdka.nl/mw-mediadesign/api.php?action=query&prop=contributors&titles=D%C3%A9rive&format=json'
response = urllib.request.urlopen(request).read()
data = json.loads(response)
JSON(data)
In [ ]:
# page information: prop=info
request = 'https://pzwiki.wdka.nl/mw-mediadesign/api.php?action=query&prop=info&titles=D%C3%A9rive&format=json'
response = urllib.request.urlopen(request).read()
data = json.loads(response)
JSON(data)
In [ ]:
# reverse links (What links here?): prop=linkshere + lhlimit=25 (max. nr of results)
request = 'https://pzwiki.wdka.nl/mw-mediadesign/api.php?action=query&prop=linkshere&lhlimit=100&titles=Prototyping&format=json'
response = urllib.request.urlopen(request).read()
data = json.loads(response)
JSON(data)
In [ ]:
 

Use the data responses in Python (and save data in variables)

In [ ]:
# For example with the action=parse request
request = 'https://pzwiki.wdka.nl/mw-mediadesign/api.php?action=parse&page=D%C3%A9rive&format=json'
response = urllib.request.urlopen(request).read()
data = json.loads(response)
JSON(data)
In [ ]:
text = data['parse']['text']['*']
print(text)
In [ ]:
title = data['parse']['title']
print(title)
In [ ]:
images = data['parse']['images']
print(images)
In [ ]:
 

Use these variables to generate HTML pages

In [57]:
# open a HTML file to write to 
output = open('myfilename.html', 'w')
In [58]:
# write to this HTML file you just opened
output.write(text)
Out[58]:
2813
In [59]:
# close the file again (Jupyter needs this to actually write a file)
output.close()
In [ ]:
 
In [ ]:
 

Use these variables to generate HTML pages (using the template language Jinja)

Jinja (template language): https://jinja.palletsprojects.com/

In [ ]:
 
In [ ]: