View source for Parsoid

<languages/>
<onlyinclude>{{Wikimedia engineering project information
| name = Parsoid
| logo = Parsoid word logo.svg
| description = <translate><!--T:1--> A bidirectional runtime wikitext parser.</translate> <translate><!--T:2--> Converts back and forth between wikitext and HTML/XML DOM with RDFa.</translate>
| start = 2011-10
| group = [[Content Transform Team]]
| lead = [[User:cscott|C.Scott Ananian]]
| team = [[User:ABreault (WMF)|Arlo Breault]], [[User:cscott|C.Scott Ananian]], [[User:IHurbainPalatin (WMF)|Isabelle Hurbain-Palatin]], [[User:MSantos (WMF)|Mateus Santos]], [[User:OSleger-WMF|Otto Šleger]], [[User:SSastry (WMF)|Subramanya Sastry]], [[User:JGiannelos (WMF)|Yiannis Giannelos]]
| EPM = [[User:SLopes-WMF|Sérgio Lopes]]
| projectpage = Parsoid
| Phabricator = parsoid
| updates = {{ll|Parsoid/Releases}}
| progress = {{ll|Parsoid/Deployments}}
}}</onlyinclude>
[[File:Parsoid HTML-RDFa content model.svg|framed|<translate><!--T:3--> A diagram of the Parsoid HTML5 + RDFa wiki runtime</translate>]]
{{hatnote|<translate><!--T:153--> For the historic version of Parsoid written in JavaScript (Node.js) until 2020, see <tvar name=1>{{ll|Parsoid/JS}}</tvar>.</translate>}}

<translate><!--T:4--> '''Parsoid''' is a PHP library that is used for converting back and forth between [[<tvar name=1>Special:MyLanguage/Wikitext</tvar>|wikitext]] and HTML.</translate>
<translate><!--T:155--> It has been under development since 2012, originally written in JavaScript and built to support the <tvar name=1>{{ll|VisualEditor|nsp=0}}</tvar>.</translate>
<translate><!--T:179--> It has been bundled with MediaWiki since version 1.35.</translate>
<translate><!--T:178--> In MediaWiki 1.47, Parsoid is planned to become MediaWiki's default parser, replacing the current {{<tvar name=1>ll|Manual:Parser</tvar>|native parser}}, in a project known as {{<tvar name=2>ll|Parsoid/Parser Unification</tvar>|parser unification}}.</translate>

<translate>
==Technical details== <!--T:8-->

<!--T:24-->
Parsoid is an application which can translate back and forth between MediaWiki's [[<tvar name="1">Special:MyLanguage/Wikitext</tvar>|wikitext]] syntax and an equivalent HTML/RDFa document model with enhanced support for automated processing and rich editing.
</translate>

<translate><!--T:25--> It has been under development by a team at the Wikimedia Foundation since 2012.</translate>
<translate><!--T:26--> It is currently used extensively by <tvar name="1">{{ll|VisualEditor}}</tvar>, <tvar name="3">{{ll|Content translation}}</tvar> and [[<tvar name="4">Special:MyLanguage/Parsoid/Users</tvar>|other applications]].</translate>

<translate><!--T:27--> Parsoid is intended to provide flawless back-and-forth conversion, i.e. to avoid information loss and also prevent "dirty diffs".</translate>

<translate><!--T:28--> On Wikimedia wikis, for several applications, Parsoid is currently proxied behind <tvar name="1">{{ll|RESTBase}}</tvar>, which stores the HTML translated by Parsoid.</translate>
<translate><!--T:29--> It is expected that RESTBase [[<tvar name="1">phab:T250500</tvar>|will eventually be replaced]] with a cache more tightly integrated with MediaWiki.</translate>

<translate><!--T:30--> For more on the overall project, see [<tvar name=url>https://blog.wikimedia.org/2013/03/04/parsoid-how-wikipedia-catches-up-with-the-web/</tvar> this blog post] from March 2013.</translate>
<translate><!--T:31--> To read about the HTML model being used, see [[<tvar name="1">Special:MyLanguage/Parsoid/MediaWiki DOM spec</tvar>|MediaWiki DOM spec]].</translate>

<translate><!--T:32--> Parsoid was originally structured as a web service and written in JavaScript, making use of <tvar name="1"><code>Node.js</code></tvar>.</translate>
<translate><!--T:33--> A [<tvar name=url>https://www.youtube.com/watch?v=lQGfuLP9MqA</tvar> tech talk from February 2019] ([[<tvar name=1>:File:The Long And Winding Road To Making Parsoid The Default MediaWiki Parser.pdf</tvar>|slides]]) and [[<tvar name=2>phab:phame/post/view/189/parsoid_in_php_or_there_and_back_again/</tvar>|blog post]] describes the process of [[<tvar name=3>Special:MyLanguage/Parsoid/PHP</tvar>|porting it to PHP]].</translate>
<translate><!--T:34--> The Parsoid extension API is currently under active development; a [[<tvar name="1">Wikimedia Technical Talks#Episode 6: Retargeting extensions to work with Parsoid</tvar>|tech talk from August 2020]] describes this work.</translate>

'''<translate><!--T:94--> GitHub Repository:</translate>''' https://github.com/wikimedia/parsoid

<translate>
== Usage == <!--T:9-->
</translate>
* {{ll|Parsoid/Releases}} – <translate><!--T:35--> List of releases made for Parsoid</translate>
* {{ll|Parsoid/API}} – <translate><!--T:36--> for the web API</translate>
* {{ll|Specs/HTML|MediaWiki DOM spec}} – <translate><!--T:37--> to make sense of the HTML that you get from the API, designed to be useful as a future storage format</translate>
* {{ll|Parsoid/LanguageConverter}} – <translate><!--T:38--> notes on Parsoid's implementation of <tvar name="1">{{ll|LanguageConverter}}</tvar></translate>
* {{ll|Parsoid/Known differences with Core Parser output}}

<translate>
== Installation == <!--T:10-->
</translate>
{{bundled|1.35}}
<translate><!--T:152--> Parsoid has been included in MediaWiki since version 1.35.</translate>
<translate><!--T:40--> No configuration is necessary to enable it.</translate>

<translate><!--T:147--> Parsoid exports an internal REST API which was historically used by RESTBase and not accessible outside the WMF internal cluster.</translate>
<translate><!--T:148--> This is no longer required for Visual Editor or core read views, and the internal API is being deprecated and is planned for removal in MW 1.43.</translate>

<translate><!--T:149--> Parsoid is nominally a composer library used by mediawiki core.</translate>
<translate><!--T:150--> If you still require the internal API for some reason, you can explicitly load Parsoid "as an extension" by adding the following to <tvar name=1><code>LocalSettings.php</code></tvar>:</translate>

<syntaxhighlight lang=php>
wfLoadExtension( 'Parsoid', "$IP/vendor/wikimedia/parsoid/extension.json" );
</syntaxhighlight>

<translate>
<!--T:151-->
Any remaining third-party users of the internal Parsoid API are strongly encouraged to migrate to the core REST HTML page endpoint which provides equivalent functionality.

== Development == <!--T:11-->
</translate>
<translate><!--T:44--> Development happens in the <tvar name="1">[[git:mediawiki/services/parsoid|Parsoid Git repository]]</tvar>.</translate>
<translate><!--T:45--> Code review happens in [[<tvar name="1">gerrit:q/project:mediawiki/services/parsoid</tvar>|Gerrit]].</translate>
<translate><!--T:46--> See [[<tvar name="1">Special:MyLanguage/Gerrit/Getting started</tvar>|Gerrit/Getting started]] to set up an account for yourself.</translate>

<translate><!--T:47--> If you use the <tvar name="1">{{ll|MediaWiki-Vagrant}}</tvar> development environment using a virtual machine, you can simply add the role <tvar name="2"><code>visualeditor</code></tvar> to it and it will set up a working Parsoid along with <tvar name="3">{{ll|Extension:VisualEditor}}</tvar>.</translate>

<translate><!--T:50--> The instructions below are for MediaWiki 1.35 or later.</translate>
<translate><!--T:51--> Check <tvar name="1">{{ll|Parsoid/JS}}</tvar> if you are running the old version of Parsoid written in JavaScript, and used for MW 1.34 and earlier.</translate>

<translate>
=== Linking a developer checkout of Parsoid === <!--T:12-->

<!--T:52-->
In a standard MediaWiki installation, Parsoid is included from MediaWiki as a composer library, <tvar name="1"><code>wikimedia/parsoid</code></tvar>.
</translate>

<translate><!--T:55--> For development purposes you usually want to use a git checkout of Parsoid, and not the version bundled in MediaWiki core as a composer library.</translate>
<translate><!--T:56--> The following lines added to <tvar name="1">{{ll|Manual:LocalSettings.php|LocalSettings.php}}</tvar> allow use of a git checkout of Parsoid (optionally), load the Parsoid REST API with <tvar name="2">{{ll|Manual:Extension_registration|wfLoadExtension}}</tvar> (rather than using the version bundled in VisualEditor) and manually do the Parsoid configuration which is usually done by VisualEditor:</translate>

<syntaxhighlight lang="php">$parsoidInstallDir = 'vendor/wikimedia/parsoid'; # <translate nowrap><!--T:95--> bundled copy</translate>
#$parsoidInstallDir = '/my/path/to/git/checkout/of/Parsoid';

// <translate nowrap><!--T:96--> For developers: ensure Parsoid is executed from <tvar name=1>$parsoidInstallDir</tvar>,</translate>
// <translate nowrap><!--T:97--> (not the version included in mediawiki-core by default)</translate>
// <translate nowrap><!--T:98--> Must occur *before* <tvar name=1>wfLoadExtension()</tvar></translate>
if ( $parsoidInstallDir !== 'vendor/wikimedia/parsoid' ) {
    function wfInterceptParsoidLoading( $className ) {
        // <translate nowrap><!--T:158--> Only intercept Parsoid namespace classes</translate>
        if ( preg_match( '/(MW|Wikimedia\\\\)Parsoid\\\\/', $className ) ) {
           $fileName = Autoloader::find( $className );
           if ( $fileName !== null ) {
               require $fileName;
           }
        }
    }
    spl_autoload_register( 'wfInterceptParsoidLoading', true, true );
    // <translate nowrap><!--T:99--> <tvar name=1>AutoLoader::registerNamespaces</tvar> was added in MW 1.39</translate>
    AutoLoader::registerNamespaces( [
        // <translate nowrap><!--T:100--> Keep this in sync with the "autoload" clause in</translate>
        // $parsoidInstallDir/composer.json
        'Wikimedia\\Parsoid\\' => "$parsoidInstallDir/src/",
    ] );
}

wfLoadExtension( 'Parsoid', "$parsoidInstallDir/extension.json" );
unset( $parsoidInstallDir );</syntaxhighlight>

<translate>
<!--T:57-->
These lines are not necessary for most users of VisualEditor, who can use VisualEditor's auto-configuration and the bundled Parsoid code included in MediaWiki, but they will be required for most developers.

<!--T:58-->
If you're serving MediaWiki with Nginx, you'll need to also add something like this in your server block (Assuming your MediaWiki setup has its files residing in <tvar name="1"><code>/w/</code></tvar>):
</translate>

<syntaxhighlight lang="nginx">
location /w/rest.php/ {
    try_files $uri $uri/ /w/rest.php?$query_string;
}
</syntaxhighlight>

<translate><!--T:157--> If you are running Mediawiki using Docker, and linking your local Parsoid repository to Mediawiki, you need to map additional volume to the docker container in <tvar name=1>docker-compose.override.yml</tvar> file in media wiki project.</translate>
<translate><!--T:159--> To do so, the simplest way is to create <tvar name=1>docker-compose.override.yml</tvar> in mediawiki project and put code bellow inside (with path modification).</translate>
<translate><!--T:160--> If you already have <tvar name=1>docker-compose.override.yml</tvar> file, modify it accordingly.</translate>  

<syntaxhighlight lang="yaml">
services:
  mediawiki:
    volumes:
      - ./:/var/www/html/w:cached
      - /my/path/to/git/checkout/of/Parsoid:/my/path/to/git/checkout/of/Parsoid

</syntaxhighlight>

<translate><!--T:59--> To test proper configuration, visit <tvar name="1"><code>{$wgScriptPath}/rest.php/{$domain}/v3/page/html/Main%20Page</code></tvar> where <tvar name="2">{{phpi|$domain}}</tvar> is the hostname in your <tvar name="3">{{phpi|$wgCanonicalServer}}</tvar>.</translate>
<translate><!--T:60--> (Note that production WMF servers do not expose the Parsoid REST API to the external network.)</translate>

<translate>
== Running the tests == <!--T:13-->

<!--T:61-->
To run all parser tests and mocha tests:
</translate>

<syntaxhighlight lang="shell-session">
$ composer test
</syntaxhighlight>

<translate>
<!--T:62-->
The parser tests have quite a few options now which can be listed using <tvar name="1"><code>php bin/parserTests.php --help</code></tvar>.

<!--T:63-->
If you have the environment variable <tvar name="1"><code>MW_INSTALL_DIR</code></tvar> pointing to a configured MediaWiki installation, you can run some additional tests with:
</translate>

<syntaxhighlight lang="shell-session">
$ composer phan-integrated
</syntaxhighlight>

<translate>
=== Converting simple wikitext === <!--T:14-->

<!--T:64-->
You can convert simple wikitext snippets from the command line using the <tvar name="1"><code>parse.php</code></tvar> script in the <tvar name="2"><code>bin/</code></tvar> directory:
</translate>

<syntaxhighlight lang="shell-session">
$ echo '[[Foo]]' | php bin/parse.php
</syntaxhighlight>

<translate><!--T:65--> The parse script has a lot of options.</translate>
<translate><!--T:66--> <tvar name="1"><kbd><code>php bin/parse.php --help</code></kbd></tvar> gives you information about this.</translate>

<translate>
===Debugging Parsoid (for developers)=== <!--T:15-->

<!--T:67-->
See <tvar name="1">{{ll|Parsoid/Debugging}}</tvar> for debugging tips.

== Continuous Integration == <!--T:68-->
</translate>

<translate><!--T:70--> Parsoid is always available as a library since it is a composer dependency of MediaWiki core. But two pieces are not enabled:</translate>

* <translate><!--T:71--> Parsoid ServiceWiring</translate>
* <translate><!--T:72--> Parsoid's external REST api</translate>

<translate><!--T:73--> The test runner [[Quibble]] would enable it if it detects <tvar name="1"><code>mediawiki/services/parsoid.git</code></tvar> has been cloned as part of the build.</translate>
<translate><!--T:74--> In which case it:</translate>

* <translate><!--T:75--> points the autoloader for <tvar name="1"><code>Wikimedia\Parsoid</code></tvar> to the cloned code (effectively replacing the version installed by composer)</translate>
* <translate><!--T:76--> Load the extension <tvar name="1"><code>wfLoadExtension( 'Parsoid', '/path/to/cloned/repo' );</code></tvar></translate>

<translate><!--T:77--> The ServiceWiring should be enabled in MediaWiki starting with 1.38.</translate>

<translate><!--T:78--> The REST API would theorically never get merged in MediaWiki: a) it has never been exposed to the public in production, it is an internal API used by RESTBase which is going away; b) it never has been security audited and c) it is redundant with the enterprise MediaWiki API.</translate>
<translate><!--T:79--> The solution will be for VisualEditor to invoke Parsoid directly via the VisualEditor Action API which would save a round trip through the REST API.</translate>

<translate>
<!--T:80-->
Loading the extension is thus a hack which enables using interfaces subject to change and which we don't really want people to use yet.

<!--T:81-->
For most purposes, parsoid should thus not be added as a CI dependency, the only exception as of October 2021 is the Disambiguator MediaWiki extension.

<!--T:82-->
Loading parsoid as an extension let us run MediaWiki integration test jobs against <tvar name="1"><code>mediawiki/services/parsoid.git</code></tvar> (such as Quibble, apitesting) and ensure Parsoid and MediaWiki work together.
</translate>

<translate><!--T:83--> An extension may be able to write tests with Parsoid even when the repository has not been cloned.</translate>
<translate><!--T:84--> Since it is a composer dependency of MediaWiki core the <tvar name="1"><code>MediaWiki\Parsoid</code></tvar> namespace is available, but the service wiring part is not (it is <tvar name="2"><code>extension/src</code></tvar> in the Parsoid repository and exposed as the <tvar name="3"><code>\MWParsoid</code></tvar> namespace).</translate>
<translate><!--T:85--> The <tvar name="1"><code>ParsoidTestFileSuite.php</code></tvar> code would only run the parser tests if Parsoid has been loaded (which should be the default with MediaWiki 1.38).</translate>

<translate><!--T:86--> For CI, Parsoid is tested against the tip of MediaWiki, whereas MediaWiki is tested with the Composer dependency.</translate>
<translate><!--T:87--> In case of a breaking change, the Parsoid change get merged first (which breaks its CI but not MediaWiki one) and MediaWiki get adjusted when Parsoid is updated.</translate>
<translate><!--T:88--> It is thus a one way change.</translate>

<translate>
== Release build == <!--T:89-->
</translate>
<translate><!--T:90--> For MediaWiki release builds, we have an integration of Parsoid ServiceWiring into VisualEditor in order to have VisualEditor work without further configuration (beside a <tvar name="1"><code>wfLoadExtension( 'VisualEditor' )</code></tvar>).</translate>
<translate><!--T:91--> The release build also enables the REST API and hook everything us so that parsoid works out of the box.</translate>
<translate><!--T:92--> This is done by copying a bit of Parsoid code into VisualEditor which is not in the master branch of VisualEditor since that would be obsolete as soon as Parsoid is updated.</translate>
<translate><!--T:93--> Instead the code is maintained in two places.</translate>

<translate>
== Technical documents == <!--T:16-->
</translate>
* {{ll|Parsoid/Internals}} – <translate><!--T:107--> documentation about Parsoid internals with links to other details.</translate>
* <translate><!--T:108--> [[<tvar name=1>Special:MyLanguage/Parsing/Notes/Moving Parsoid Into Core/Porting</tvar>|PHP Porting notes]] and [[<tvar name=2>Special:MyLanguage/Parsoid/PHP/Help wanted</tvar>|help-wanted tasks]]</translate>
* <translate><!--T:109--> [[<tvar name=1>Special:MyLanguage/Parsoid/Deployments</tvar>|Parsoid deployment agenda on Wikimedia cluster]] (code normally deployed every Monday and Wednesday between 1pm - 1:30pm PST)</translate>
* {{ll|Parsoid/Round-trip testing}} – <translate><!--T:110--> The round-trip testing setup we are using to test the wikitext -> HTML DOM -> wikitext round-trip on actual Wikipedia content.</translate>
* {{ll|Parsoid/Visual Diffs Testing}} – <translate><!--T:111--> Info about visual diff testing for comparing Parsoid's html rendering with php parser's html rendering + a testreduce setup for doing mass visual diff tests.</translate>
* {{ll|Parsoid/limitations}} – <translate><!--T:112--> Limitations in Parsoid, mainly contrived templating (ab)uses that don't matter in practice.</translate> <translate><!--T:113--> Could be extended to be similar to [[<tvar name=1>meta:Special:MyLanguage/MNPP</tvar>|the preprocessor upgrade notes]] ('''Might need updating''')</translate>
* {{ll|Parsoid/Bibliography}} – <translate><!--T:114--> Bibliography of related literature</translate>

<translate>
=== Links for Parsoid developers === <!--T:17-->
</translate>
* <translate><!--T:115--> See <tvar name=1>{{ll|Parsoid/Debugging}}</tvar> for debugging tips.</translate>
* <translate><!--T:116--> [[<tvar name=1>Special:MyLanguage/Parsoid/Upgrade packages</tvar>|Upgrading or adding packages]] to Parsoid</translate>
* <translate><!--T:117--> [<tvar name=url>https://github.com/wikimedia/parsoid/blob/39ea4e49783b1f88326d6ebddd14e08bb39cb649/tools/sync-parserTests.js#L5-L34</tvar> See these instructions] for syncing Parsoid's copy of parser tests to/from core</translate>
* <translate><!--T:118--> Parsoid has a limited [[<tvar name=2>wmdoc:Parsoid/master/#!/api/Parsoid</tvar>|library interface]] for invoking it programatically.</translate>
* <translate><!--T:119--> [<tvar name=1>https://www.youtube.com/watch?v=lS1xPkERWCM</tvar> Tech Talk about Retargeting extensions to work with Parsoid]</translate>
* [[Parsoid/So you want your extension to work with Parsoid|<translate><!--T:120--> So you want your extension to work with Parsoid</translate>]]
* [[Parsoid/Parsoid HTML Specification Versioning|<translate><!--T:121--> Parsoid HTML Specification Versioning</translate>]]
* [[Parsoid/So you are going to change Parsoid output|<translate><!--T:122--> So you are going to change Parsoid output</translate>]]

<translate>
=== Links for Parsoid deployers (to the Wikimedia cluster) === <!--T:18-->
</translate>
* [[Parsoid/Deployments]]
* <translate><!--T:123--> [<tvar name=url>http://parsoid-rt-tests.wikimedia.org/commits</tvar> RT testing commits] (useful to check regressions and fixes)</translate>
* <translate><!--T:124--> [[<tvar name=1>labsconsole:Parsoid#Deploying_changes</tvar>|Deployment instructions for Parsoid]]</translate>
* [https://logstash.wikimedia.org/app/kibana#/dashboard/parsoid <translate><!--T:125--> Kibana dashboard</translate>]
* [https://grafana.wikimedia.org/d/TCWoeymIk/parsoid-timing-wt2html-entry <translate><!--T:126--> Grafana dashboard for wt2html metrics</translate>]
* [https://grafana.wikimedia.org/d/jmaNtVMIz/parsoid-timing-html2wt-entry <translate><!--T:127--> Grafana dashboard for html2wt metrics</translate>]
* [https://grafana.wikimedia.org/d/000000607/cluster-overview?orgId=1&from=now-24h&to=now&var-datasource=eqiad%20prometheus%2Fops&var-cluster=parsoid&var-instance=All&var-site=eqiad <translate><!--T:129--> Prometheus breakdown for the Parsoid cluster on eqiad</translate>]
* [https://grafana.wikimedia.org/d/000000607/cluster-overview?orgId=1&from=now-24h&to=now&var-datasource=codfw%20prometheus%2Fops&var-cluster=parsoid&var-instance=All&var-site=codfw <translate><!--T:130--> Prometheus breakdown for the Parsoid cluster on codfw</translate>]
* <translate><!--T:131--> [[<tvar name=1>CI/JJB</tvar>|Jenkins Job Builder docs]] for updating jenkins jobs</translate>

<translate>
== History == <!--T:154-->
</translate>
<translate><!--T:5--> The original application was written in JavaScript (using <tvar name=1>Node.js</tvar>) and started running on the Wikimedia cluster in December 2012.</translate>
<translate><!--T:6--> In 2019, Parsoid was ported to PHP, and the PHP version replaced the JS version on the Wikimedia cluster in December 2019.</translate>
<translate><!--T:7--> Parsoid [[<tvar name=1>Special:MyLanguage/Parsing/Parser Unification</tvar>|is being integrated into core MediaWiki]], with the goal of eventually replacing MediaWiki's current native parser.</translate>
<translate><!--T:161--> In early 2024, Parsoid began to be used on some production wikis of the Wikimedia Foundation as the default parser for read views.</translate>
<translate><!--T:162--> You can see them [<tvar name=1>https://noc.wikimedia.org/conf/highlight.php?file=dblists/parsoidrendered.dblist</tvar> in the production config list].</translate>

<translate><!--T:22--> Parsoid (the PHP version) has been [[<tvar name="1">Special:MyLanguage/Parsoid/PHP</tvar>|natively bundled]] with MediaWiki since version 1.35, released in September 2020.</translate>
<translate><!--T:23--> For non-Wikimedia installations, Parsoid/JS was supported until the end-of-life of MediaWiki 1.31 (LTS) in [[<tvar name="1">Special:MyLanguage/Version lifecycle</tvar>|September 2021]].</translate>

<translate>
== FAQ == <!--T:163-->
</translate>
* <translate><!--T:164--> How do I see if a page was rendered with Parsoid?</translate>
** <translate><!--T:165--> The footer will say "Page was rendered with Parsoid".</translate>
* <translate><!--T:166--> How do I set a page to temporarily render with Parsoid?</translate>
** <translate><!--T:167--> Install <tvar name=1>{{ll|Extension:ParserMigration}}</tvar></translate>
** <translate><!--T:168--> Add <tvar name=1><code>?useparsoid=1</code></tvar> to the URL</translate>
* <translate><!--T:169--> How do I get an entire wiki to render with Parsoid?</translate>
** <translate><!--T:170--> Install <tvar name=1>{{ll|Extension:ParserMigration}}</tvar></translate>
** <translate><!--T:171--> Set <tvar name=1><code>$wgParserMigrationEnableParsoidArticlePages = true;</code></tvar></translate>
** <translate><!--T:172--> Set <tvar name=1><code>$wgParserMigrationEnableParsoidDiscussionTools = true;</code></tvar></translate>
* <translate><!--T:173--> Which Wikimedia wikis render with Parsoid?</translate>
** <translate><!--T:174--> The list is at <tvar name=1>[[gerrit:plugins/gitiles/operations/mediawiki-config/+/refs/heads/master/dblists/parsoidrendered.dblist|parsoidrendered.dblist]]</tvar>.</translate> <translate><!--T:175--> As of August 2025, it is approximately 250 of the 1000 wikis.</translate> <translate><!--T:176--> Rollout will continue until all wikis are using Parsoid.</translate>

<translate>
== See also == <!--T:19-->
</translate>
* <translate><!--T:144--> [[w:en:API|API]]</translate>
* [[Special:MyLanguage/RESTBase|RESTBase]] – <translate><!--T:132--> a caching / storing API proxy for page HTML translated by Parsoid</translate>
* [[Parser 2011/Parser plan]] – <translate><!--T:134--> Early (now relatively old) design ideas and issues from 2011</translate>
* [[Special:PrefixIndex/Parsoid/]] – <translate><!--T:135--> Parsoid-related pages on this wiki</translate>
* [[Extension:ParsoidBatchAPI]] <translate><!--T:136--> (archived)</translate>
* <translate><!--T:137--> [<tvar name=url>https://github.com/wikimedia/parsoid-jsapi</tvar> parsoid-jsapi] – a high-level interface for extraction and transformation of wikitext, similar to the [<tvar name=url2>https://github.com/earwig/mwparserfromhell</tvar> mwparserfromhell] API.</translate>
* [[Special:MyLanguage/Alternative parsers|<translate><!--T:145--> Alternative parsers</translate>]]
* [[Parsoid/Parser Unification]]

<translate>
== External links == <!--T:20-->
</translate>
* <translate><!--T:138--> [[<tvar name=url1>git:mediawiki/services/parsoid/</tvar>|Source code]] ([<tvar name=url2>https://github.com/wikimedia/parsoid/</tvar> GitHub mirror])</translate>
* <translate><!--T:139--> [[<tvar name=1>wmdoc:Parsoid/master/</tvar>|JS Documentation]] (old version of Parsoid)</translate>
* [[wmdoc:Parsoid-PHP/master/|<translate><!--T:140--> PHP Documentation</translate>]]
* <translate><!--T:141--> [[<tvar name=1>commons:Category:Parsoid</tvar>|''Parsoid'' on the Wikimedia Commons]]</translate>

<translate>
== Contact == <!--T:21-->
</translate>
<translate><!--T:142--> If you need help or have questions/feedback, you can contact us in <tvar name=1>{{irc|mediawiki-parsoid}}</tvar> or [<tvar name=url>https://lists.wikimedia.org/mailman/listinfo/wikitext-l</tvar> '''the wikitext-l mailing list'''].</translate>
<translate><!--T:143--> If all that fails, you can also contact us by email at <code>content-transform-team</code> at the <tvar name=1><code>wikimedia.org</code></tvar> domain.</translate>

{{feedback
| thing = Parsoid
| author = [[Special:MyLanguage/Content Transform Team|Content Transform Team]]
| irc = mediawiki-parsoid
| ml2 =
| phab = parsoid
| ml = wikitext-l
}}

[[Category:MediaWiki development{{#translation:}}]]
[[Category:Parser{{#translation:}}]]
[[Category:Parsoid{{#translation:}}| ]]
[[Category:Wikitext{{#translation:}}]]
[[Category:Development notes{{#translation:}}]]
[[Category:Used on Wikimedia{{#translation:}}]]
[[Category:VisualEditor{{#translation:}}]]
[[Category:Libraries{{#translation:}}]]