Mediawiki API - Revision history

Manetta at 11:13, 20 September 2024

2024-09-20T11:13:22Z

← Older revision		Revision as of 13:13, 20 September 2024
Line 89:		Line 89:

	=References=		=References=

			[[Category:MediaWiki]]

Michael Murtaugh at 16:49, 24 September 2019

2019-09-24T16:49:00Z

← Older revision		Revision as of 18:49, 24 September 2019
Line 1:		Line 1:
			= Using python + mwclient =

			<source lang="python">
			from mwclient import Site

			site = Site("en.wikipedia.org", path="/w/")

			cat = site.pages["Category:Computer scientists"]
			for page in cat.members():
			print (page.name)
			</source>


	= Mediawiki API: semantic search and download =		= Mediawiki API: semantic search and download =

Andre Castro: /* Script */

2017-11-20T12:03:50Z

Script

← Older revision		Revision as of 14:03, 20 November 2017
Line 73:		Line 73:


	Production method can be Hand-written OR Typewriter: '''<nowiki>python wiki-download.py --download imgs --ask [[Production_Method::Hand-written]]OR[[Production_Method::Typewriter]]'''		Production method can be Hand-written OR Typewriter: '''<nowiki>python wiki-download.py --download imgs --ask [[Production_Method::Hand-written]]OR[[Production_Method::Typewriter]]</nowiki>'''

	=References=		=References=

Andre Castro: /* Script */

2017-11-20T12:03:21Z

Script

← Older revision		Revision as of 14:03, 20 November 2017
Line 71:		Line 71:

	'''<nowiki>python wiki-download.py --download imgs --ask [[Production_Method::+]][[Document_Type::Flyer]] </nowiki>'''		'''<nowiki>python wiki-download.py --download imgs --ask [[Production_Method::+]][[Document_Type::Flyer]] </nowiki>'''


			Production method can be Hand-written OR Typewriter: '''<nowiki>python wiki-download.py --download imgs --ask [[Production_Method::Hand-written]]OR[[Production_Method::Typewriter]]'''

	=References=		=References=

Andre Castro: /* Api */

2017-11-20T11:25:17Z

Api

← Older revision		Revision as of 13:25, 20 November 2017
Line 50:		Line 50:
	Using: '''<nowiki>/api.php?action=ask&query=</nowiki>'''		Using: '''<nowiki>/api.php?action=ask&query=</nowiki>'''

	https://aa.xpub.nl/api.php?action=ask&query=[[Production_Method::%2B]]&format=jsonfm		<nowiki>https://aa.xpub.nl/api.php?action=ask&query=[[Production_Method::%2B]]&format=jsonfm</nowiki>

	https://aa.xpub.nl/api.php?action=ask&query=[[Actor::Poortgebouw]]&format=jsonfm		<nowiki>https://aa.xpub.nl/api.php?action=ask&query=[[Actor::Poortgebouw]]&format=jsonfm</nowiki>

	https://aa.xpub.nl/api.php?action=ask&query=[[Actor::Poortgebouw]][[Production_Method::Typewriter]]&format=jsonfm		<nowiki>https://aa.xpub.nl/api.php?action=ask&query=[[Actor::Poortgebouw]][[Production_Method::Typewriter]]&format=jsonfm</nowiki>

	Note that:		Note that:

Andre Castro at 09:28, 20 November 2017

2017-11-20T09:28:06Z

← Older revision		Revision as of 11:28, 20 November 2017
Line 1:		Line 1:
	= download ~~/ API / ask~~ =		= Mediawiki API: semantic search and download =

	Script interfaces with the ~~mw api~~ to download files according to ask requests		Script wiki-download.py from [https://git.xpub.nl/scan-utils/log.html scan-utils],
			interfaces with the mediawiki API in order to download files according to ask requests.

	=API what is the API?=		=API what is the API?=
	~~{{:~~Wiki_publishing}}		More on the basics of MW API in [[Wiki_publishing#API]]


	=Semantic queries: ASK =		=Semantic queries: ASK =

Andre Castro: /* Semantic queries: ASK */

2017-11-19T19:00:14Z

Semantic queries: ASK

← Older revision		Revision as of 21:00, 19 November 2017
Line 15:		Line 15:
	===Selecting pages===		===Selecting pages===
	Wiki pages		Wiki pages
	* select all pages under the File: namespace (all files) <~~code~~>[[File:+]]</~~code~~>		* select all pages under the File: namespace (all files) <nowiki>[[File:+]]</nowiki>
	* select all pages under the User: namespace (all users) <~~code~~>[[User:+]]</~~code~~>		* select all pages under the User: namespace (all users) '''<nowiki>[[User:+]]</nowiki>'''

	Semantic properties and values		Semantic properties and values
	* all pages/items with property Actor <~~code~~>[[Actor::+]] </~~code~~>		* all pages/items with property Actor '''<nowiki>[[Actor::+]] </nowiki>'''
	* all pages/items with property <nowiki>Actor::Eetcafe</nowiki> <~~code~~>[[Actor::Eetcafe]]</~~code~~>		* all pages/items with property <nowiki>Actor::Eetcafe</nowiki> '''<nowiki>[[Actor::Eetcafe]]</nowiki>'''

	Combining more than one query string		Combining more than one query string
	* all File: pages/items with property Production_Method::Typewriter <~~code~~>[[Files:+]][[Production_Method::Typewriter]]</~~code~~>		* all File: pages/items with property Production_Method::Typewriter '''<nowiki>[[Files:+]][[Production_Method::Typewriter]]</nowiki>'''
	* all File: pages/items		* all File: pages/items

	===Notes on selecting pages===		===Notes on selecting pages===
	'''Difference between Wiki pages and Semantic property and values:'''		'''Difference between Wiki pages and Semantic property and values:'''
	* 1 <~~code~~>:</~~code~~> wiki pages <~~code~~>[[User:Zalán_Szakács]]</~~code~~>[[User:Zalán_Szakács]]		* 1 '''<nowiki>:</nowiki>''' wiki pages '''<nowiki>[[User:Zalán_Szakács]]</nowiki>'''[[User:Zalán_Szakács]]
	* 2 <~~code~~>::</~~code~~> semantic property values <~~code~~>[[Production_Method::Typewriter]]</~~code~~>		* 2 '''<nowiki>::</nowiki>''' semantic property values '''<nowiki>[[Production_Method::Typewriter]]</nowiki>'''


	Displaying information on a property can be done by include in the		Displaying information on a property can be done by include in the
	<~~code~~>?Property</~~code~~> to the ''Additional data to display'' window.		'''<nowiki>?Property</nowiki>''' to the ''Additional data to display'' window.
	* <~~code~~>?Production Method</~~code~~> display the Production_Method values of the page		* '''<nowiki>?Production Method</nowiki>''' display the Production_Method values of the page
	* <~~code~~>?Actor\|?Origin</~~code~~> display the Actor and Origin values of the page		* '''<nowiki>?Actor\|?Origin</nowiki>''' display the Actor and Origin values of the page

	Finding existing properties and their use:		Finding existing properties and their use:
Line 46:		Line 46:
	The same Ask requests, which we have been making the wiki Ask interface, can be made using the mediawiki API, through the ASK module<ref>https://www.semantic-mediawiki.org/wiki/Help:API:ask</ref>		The same Ask requests, which we have been making the wiki Ask interface, can be made using the mediawiki API, through the ASK module<ref>https://www.semantic-mediawiki.org/wiki/Help:API:ask</ref>

	Using: <~~code~~>/api.php?action=ask&query=</~~code~~>		Using: '''<nowiki>/api.php?action=ask&query=</nowiki>'''

	https://aa.xpub.nl/api.php?action=ask&query=[[Production_Method::%2B]]&format=jsonfm		https://aa.xpub.nl/api.php?action=ask&query=[[Production_Method::%2B]]&format=jsonfm

	https://aa.xpub.nl/api.php?action=ask&query=[[Actor::Poortgebouw]]&format=jsonfm		https://aa.xpub.nl/api.php?action=ask&query=[[Actor::Poortgebouw]]&format=jsonfm

	https://aa.xpub.nl/api.php?action=ask&query=[[Actor::Poortgebouw]][[Production_Method::Typewriter]]&format=jsonfm		https://aa.xpub.nl/api.php?action=ask&query=[[Actor::Poortgebouw]][[Production_Method::Typewriter]]&format=jsonfm

	Note that:		Note that:
	* we start using the <~~code~~>[[ ]]</~~code~~>, which we were in the wiki ask interface		* we start using the '''<nowiki>[[ ]]</nowiki>''', which we were in the wiki ask interface
	* the <~~code~~>+</~~code~~> sign is encoded with [https://en.wikipedia.org/wiki/Percent-encoding URL percent encoding], becoming %2B		* the '''<nowiki>+</nowiki>''' sign is encoded with [https://en.wikipedia.org/wiki/Percent-encoding URL percent encoding], becoming %2B
	* we are declaring the format <~~code~~>format=jsonfm</~~code~~>, <~~code~~>format=xml</~~code~~> are possible		* we are declaring the format '''<nowiki>format=jsonfm</nowiki>''', '''<nowiki>format=xml</nowiki>''' are possible

	===Script===		===Script===
Line 64:		Line 64:

	Usage:		Usage:
	<~~code~~>python wiki-download.py --help</~~code~~> ask for help		'''<nowiki>python wiki-download.py --help</nowiki>''' ask for help

	<~~code~~>python wiki-download.py --download imgs --ask [[Production_Method::Typewriter]] </~~code~~>		'''<nowiki>python wiki-download.py --download imgs --ask [[Production_Method::Typewriter]] </nowiki>'''

	<~~code~~>python wiki-download.py --download imgs --ask [[Production_Method::+]][[Document_Type::Flyer]] </~~code~~>		'''<nowiki>python wiki-download.py --download imgs --ask [[Production_Method::+]][[Document_Type::Flyer]] </nowiki>'''

	=References=		=References=

Andre Castro: /* Semantic queries: ASK */

2017-11-19T18:57:47Z

Semantic queries: ASK

← Older revision		Revision as of 20:57, 19 November 2017
Line 44:		Line 44:

	===Api===		===Api===
	The same Ask requests, which we have been making the wiki ~~ask~~ interface, can be made using the mediawiki API, through the ASK module<ref>https://www.semantic-mediawiki.org/wiki/Help:API:ask</ref>		The same Ask requests, which we have been making the wiki Ask interface, can be made using the mediawiki API, through the ASK module<ref>https://www.semantic-mediawiki.org/wiki/Help:API:ask</ref>

	Using: <code>/api.php?action=ask&query=</code>		Using: <code>/api.php?action=ask&query=</code>

			https://aa.xpub.nl/api.php?action=ask&query=[[Production_Method::%2B]]&format=jsonfm

			https://aa.xpub.nl/api.php?action=ask&query=[[Actor::Poortgebouw]]&format=jsonfm

			https://aa.xpub.nl/api.php?action=ask&query=[[Actor::Poortgebouw]][[Production_Method::Typewriter]]&format=jsonfm

			Note that:
			* we start using the <code>[[ ]]</code>, which we were in the wiki ask interface
			* the <code>+</code> sign is encoded with [https://en.wikipedia.org/wiki/Percent-encoding URL percent encoding], becoming %2B
			* we are declaring the format <code>format=jsonfm</code>, <code>format=xml</code> are possible

	===Script===		===Script===
			With the wiki-download.py script from https://git.xpub.nl/scan-utils/
			we can perform the same semantic queries, and dowload the resulting items, if they happen to be a file

			Usage:
			<code>python wiki-download.py --help</code> ask for help

			<code>python wiki-download.py --download imgs --ask [[Production_Method::Typewriter]] </code>

			<code>python wiki-download.py --download imgs --ask [[Production_Method::+]][[Document_Type::Flyer]] </code>

	=References=		=References=

Andre Castro at 18:22, 19 November 2017

2017-11-19T18:22:39Z

← Older revision		Revision as of 20:22, 19 November 2017
Line 1:		Line 1:
	= download / API / ask =		= download / API / ask =

	Script interfaces with the mw api to download files according to ask requests ~~## API what is the API?~~		Script interfaces with the mw api to download files according to ask requests

	~~Examples~~		=API what is the API?=
			{{:Wiki_publishing}}

	== ~~ask ==~~		=Semantic queries: ASK =
			Semantic MediaWiki includes a simple query language for Semantic search, so that users can directly request certain information from the wiki.<ref>https://www.semantic-mediawiki.org/wiki/Help:Inline_queries</ref>.

	~~What is~~		Inside a wiki, with SMW extension installed,the page <nowiki>[[Special:Ask]]</nowiki> provides a interface for query the wiki. See Autonomous Archive's [https://aa.xpub.nl/index.php?title=Special:Ask Special:Ask]

			Although there are many parameters possible to include, let's keep it simple and focus on syntax for '''Selecting pages'''

	Wiki pages ~~according to namespaces~~: [[File:+]] ~~categories user file~~		===Selecting pages===
			Wiki pages
			* select all pages under the File: namespace (all files) <code>[[File:+]]</code>
			* select all pages under the User: namespace (all users) <code>[[User:+]]</code>

	Semantic property ~~value~~ [[~~Property~~::~~value~~]]		Semantic properties and values
			* all pages/items with property Actor <code>[[Actor::+]] </code>
			* all pages/items with property <nowiki>Actor::Eetcafe</nowiki> <code>[[Actor::Eetcafe]]</code>

	~~Meta-characters~~: + ~~(wildcards?~~ File:*.pdf??)		Combining more than one query string
			* all File: pages/items with property Production_Method::Typewriter <code>[[Files:+]][[Production_Method::Typewriter]]</code>
			* all File: pages/items

	=== ~~same ask string in 3 different interfaces~~ ===		===Notes on selecting pages===
			'''Difference between Wiki pages and Semantic property and values:'''
			* 1 <code>:</code> wiki pages <code>[[User:Zalán_Szakács]]</code>[[User:Zalán_Szakács]]
			* 2 <code>::</code> semantic property values <code>[[Production_Method::Typewriter]]</code>

	~~Semantic query page~~

	~~Api~~		Displaying information on a property can be done by include in the
			<code>?Property</code> to the ''Additional data to display'' window.
			* <code>?Production Method</code> display the Production_Method values of the page
			* <code>?Actor\|?Origin</code> display the Actor and Origin values of the page

	Script		Finding existing properties and their use:
			* Visit the [https://aa.xpub.nl/index.php?title=Special:Properties Special:Properties] page
			* Visit the [https://aa.xpub.nl/index.php?title=Special%3ASearchByProperty Special:3ASearchByProperty] page

			=== Ask 2 more interfaces ===

			===Api===
			The same Ask requests, which we have been making the wiki ask interface, can be made using the mediawiki API, through the ASK module<ref>https://www.semantic-mediawiki.org/wiki/Help:API:ask</ref>

			Using: <code>/api.php?action=ask&query=</code>




			===Script===



			=References=

Andre Castro: Created page with "= download / API / ask = Script interfaces with the mw api to download files according to ask requests ## API what is the API? Examples == ask == What is Wiki pages accor..."

2017-11-17T17:16:44Z

Created page with "= download / API / ask = Script interfaces with the mw api to download files according to ask requests ## API what is the API? Examples == ask == What is Wiki pages accor..."

New page

= download / API / ask =

Script interfaces with the mw api to download files according to ask requests ## API what is the API?

Examples

== ask ==

What is

Wiki pages according to namespaces: [[File:+]] categories user file

Semantic property value [[Property::value]]

Meta-characters: + (wildcards? File:*.pdf??)

=== same ask string in 3 different interfaces ===

Semantic query page

Api

Script