API:Parsing wikitext
From MediaWiki.org
(Redirected from API:Expanding templates and rendering)
| This page is part of the MediaWiki API documentation. |
These API modules allow calling the parser for preprocessing and rendering.
Retrieving just the raw source wikitext can be done through prop=revisions.
Contents |
[edit] expandtemplates
| MediaWiki version: | 1.12 |
Returns preprocessed wikitext (comments stripped, templates expanded, etc.)
[edit] Parameters
text: Wikitext to preprocesstitle: Act like the wikitext is on this page (default:API)- This only really matters when parsing links to self (like this) or links to subpages.
[edit] Example
Expand wikitext {{Project:Sandbox}} |
api.php ? action=expandtemplates & text=%7B%7BProject:Sandbox%7D%7D
<?xml version="1.0" encoding="utf-8"?> <api> <expandtemplates> {| style="background-color: transparent; border:1px dotted #000000;padding:2px;margin:2px;" | ''Welcome to the '''Wikipedia Sandbox'''! This page allows you to carry out experiments. To edit, click <span class="plainlinks">'''[http://en.wikipedia.org/w/index.php?title=API&action=edit here]'''</span> or '''edit this page''' above (or the views section for obscure browsers), make your changes and click the '''Save page''' button when finished. Content will '''not''' stay permanently; this page is '''automatically cleaned''' every 12 hours, although it tends to be overwritten by other testing users much faster than that.'' ''Please do not place copyrighted, offensive, or libelous content in the sandbox(es). If you have any questions regarding [[Wikipedia]], please see [[Wikipedia:Questions]]. Thanks!'' :''This page is a virtual sandbox on Wikipedia. For uses of sandboxes, see the article [[sandbox]]. ''You may also use the templates'' <font style="font-size: 12px;"> [[Template:X1|X1]], [[Template:X2|X2]], [[Template:X3|X3]], [[Template:X4|X4]], [[Template:X5|X5]], [[Template:X6|X6]], [[Template:X7|X7]], [[Template:X8|X8]], and [[Template:X9|X9]]</font> for experimental purposes.<br /> ''Try other sandboxes:'' <font style="font-size: 12px;">[[Wikipedia:Sandbox|Main Sandbox]] | [[Wikipedia:Tutorial (Editing)/sandbox|Tutorial Sandbox 1]] | [[Wikipedia:Tutorial (Formatting)/sandbox|Tutorial Sandbox 2]] | [[Wikipedia:Tutorial (Wikipedia links)/sandbox|Tutorial Sandbox 3]] | [[Wikipedia:Tutorial (Related site links)/sandbox|Tutorial Sandbox 4]] | [[Wikipedia:Tutorial (External links)/sandbox|Tutorial Sandbox 5]]</font><br>''For a sandbox of your own, [[Wikipedia:User page#How do I create a user subpage?|create a user subpage]].'' | {| style="background-color: transparent;" |- |<table class="noprint Template-Shortcut" style="border:1px solid #999; background:#fff; margin: .3em .3em .3em 1em; padding:3px; float:right"><th class="noprint" align="center" valign="top"><small>[[Wikipedia:Shortcut|Shortcuts]]:<br />[[WP:SB]]<br />[[WP:SAND]]<br />[[WP:SANDBOX]]<br />[[WP:TEST]]</small></th></table> |- |<div style="border: 1px solid black; text-align: center; padding:5px; font-size: small; background: #eeeeee; white-space: nowrap;"> More info:<br> [[Wikipedia:Introduction|Introduction to Wikipedia]]<br> [[Wikipedia:About the Sandbox|About the Sandbox]]<br> [[Wikipedia:Tutorial|Editing tutorial]]</div> |} |} </sub> This is a test</expandtemplates> </api>
[edit] Possible errors
None.
[edit] parse
| MediaWiki version: | 1.12 |
Returns parsed wikitext
[edit] Parameters
text: Wikitext to parsetitle: Act like the wikitext is on this page (default:API)- This only really matters when parsing links to self (like this) or links to subpages.
page: Parse the content of this page. Cannot be used together withtextortitleprop: Which properties to get (all by default)text: The generated HTMLlanglinks: A list of language links in the wikitext fragmentcategories: A list of category links in the wikitext fragmentlinks: A list of internal links in the wikitext fragmenttemplates: A list of templates used in the wikitext fragmentimages: A list of images used in the wikitext fragmentexternallinks: A list of external links used in the wikitext fragmentsections: A list of sections present in the wikitext fragmentrevid: Ifpagewas used, specify the ID of the revision parsed
[edit] Example
| Parse wikitext [[foo]] [[API:Query|bar]] [http://www.example.com/ baz] |
<?xml version="1.0" encoding="utf-8"?> <api> <parse> <text><p><a href="/wiki/Foo" title="Foo">foo</a> <a href="/w/index.php?title=API:Query&amp;action=edit&amp;redlink=1" class="new" title="API:Query (page does not exist)">bar</a> <a href="http://www.example.com/" class="external text" title="http://www.example.com/" rel="nofollow">baz</a> </p></text> <langlinks /> <categories /> <links> <pl ns="0" exists="">Foo</pl> <pl ns="0">API:Query</pl> </links> <templates /> <images /> <externallinks> <el>http://www.example.com/</el> </externallinks> <sections /> </parse> </api>
[edit] Possible errors
- code: params
- info: The page parameter cannot be used together with the text and title parameters
- code: missingtitle
- info: The page you specified doesn't exist

