MediaWiki Parsoid

https://github.com/wikimedia/mediawiki-services-parsoid
Admin
Parsoid is a bidirectional parser that converts between wikitext and HTML5, originally written in...
Tokens:128,363
Snippets:1,050
Trust Score:8.3
License:GPL-2.0
Update:1 year ago
Show doc for...
Tokens:
Raw
### Install Parsoid Node.js Dependencies

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/setup.md

After cloning the repository, execute this command from the main Parsoid directory to install all required Node.js packages and dependencies using npm.

```Shell
$ npm install
```

--------------------------------

### Install Parsoid Dependencies and Run Tests

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/README.md

Instructions to navigate to the project root, install Node.js dependencies, and execute the test suite for the Parsoid project.

```Shell
cd ..
 npm test
```

--------------------------------

### Run Parsoid API Server

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/setup.md

This command starts the Parsoid API server, which is primarily used by VisualEditor for backend operations. Users can customize settings by copying and modifying `config.example.yaml`.

```Shell
$ node bin/server
```

--------------------------------

### MediaWiki Parser Configuration Example

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/sectionWrappingParserTests.txt

An example of a JSON configuration setting, likely related to how sections are handled during parsing, indicating that sections should be wrapped.

```JSON
{
  "wrapSections": true
}
```

--------------------------------

### Test Case 2: Basic Content Rendering with Generic HTML

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/phpunit/Parsoid/ParserTests/data/basicTests.txt

This second test case illustrates the rendering of 'Hello 2' content, showing both the original wikitext input and its corresponding generic HTML output. It serves as a straightforward example of content transformation from wikitext to standard HTML.

```wikitext
Hello 2
```

```html
<p>Hello 2</p>
```

--------------------------------

### Clone Parsoid Git Repository

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/setup.md

This command clones the Parsoid source code repository from Gerrit, making the project files available locally for setup and development.

```Shell
$ git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid
```

--------------------------------

### Launch Parsoid HTTP API

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/devsetup.md

Starts Parsoid's HTTP API server, allowing developers to verify appropriate responses directly in a web browser. This is useful for interactive testing of the API's behavior.

```Bash
npm start
```

--------------------------------

### Wikitext Test Setup: Template and Article Definition

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/separatorTests.txt

This section defines a simple template `Template:1x` that expands its first parameter, and an `article` block that uses this template. This setup is foundational for subsequent tests demonstrating separator handling.

```Wikitext
Template:1x
!! text
{{{1}}}
```

--------------------------------

### Convert Inline Dummyanno Tags

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test verifies the conversion of inline 'dummyanno' tags in wikitext to HTML, ensuring the correct placement of start and end meta tags for the annotation.

```wikitext
Some text <dummyanno>with some annotated content</dummyanno> inline.
```

```html/parsoid
<p>Some text <meta typeof="mw:Annotation/dummyanno" data-mw='{"rangeId":"mwa0","extendedRange":false,"wtOffsets":[10,21]}' />with some annotated content<meta typeof="mw:Annotation/dummyanno/End" data-mw='{"wtOffsets":[48,60]}'/> inline.</p>
```

--------------------------------

### Example: Get Parsoid Daemon Version using cURL

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/apiuse.md

Demonstrates how to use the `curl` command-line tool to query the `/_version` endpoint and retrieve the Parsoid daemon's version information. The expected response is a JSON object containing `name`, `version`, and `sha`.

```Shell
curl http://localhost:8000/_version
```

--------------------------------

### Running Parsoid API Server for Testing

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/devsetup.md

Instructions for testing the Parsoid API server by running `npm start` and verifying its response by loading a specific page, such as French Wikipedia's page on Obama, to ensure accurate and semantically consistent output.

```Shell
npm start
```

--------------------------------

### Handling Multiple Spaces at Start-of-Line

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/indentPre.txt

Examines how multiple leading spaces at the start of a line in wikitext are interpreted, distinguishing between preformatted text, HTML tags, and table syntax.

```Wikitext
    <p> foo </p>\n    foo\n\t{|\n|foo\n|}
```

```HTML
    <p> foo </p>\n<pre>   foo\n</pre>\n<table>\n<tbody><tr>\n<td>foo\n</td></tr></tbody></table>
```

--------------------------------

### GNU GPL Interactive Program Startup Notice

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/COPYING.txt

A sample short notice to be displayed by interactive programs when they start. This message informs users about the program's warranty status and directs them to commands for more details on redistribution conditions under the GNU GPL.

```plaintext
Gnomovision version 69, Copyright (C) year name of author
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
```

--------------------------------

### Parsoid Test Configuration for Annotation Fostering

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

Configuration options for the Parsoid test, specifying the modes for conversion (wikitext to HTML, selective serialization, wikitext to wikitext) and enabling annotations.

```JSON
parsoid={
  "modes": ["wt2html", "selser","wt2wt"]
}
annotations=1
```

--------------------------------

### Install Dumpgrepper Utility Globally

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/README.md

Command to install the `dumpgrepper` utility globally using npm. This utility is designed for efficiently searching large XML dumps with JavaScript regular expressions.

```Shell
npm install -g dumpgrepper
```

--------------------------------

### Serializing Indent Pre at Start-of-Line

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/indentPre.txt

Tests the serialization of preformatted text blocks that start at the beginning of a line in wikitext, and their corresponding HTML output.

```Wikitext
 hi
```

```Parsoid HTML
<pre>hi</pre>
```

```PHP HTML
<pre>hi\n</pre>
```

--------------------------------

### Converting a Simple Wikitext Table to HTML

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/tables.txt

This example illustrates the basic conversion of a two-row, two-column MediaWiki wikitext table into its standard HTML representation, showing how rows and cells are structured.

```wikitext
{|
|1||2
|-
|3||4
|}
```

```html
<table>
<tbody><tr>
<td>1</td>
<td>2
</td></tr>
<tr>
<td>3</td>
<td>4
</td></tr></tbody></table>
```

--------------------------------

### Submitting Code Changes with Git and Gerrit

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/devsetup.md

A sequence of Git commands (`git add`, `git commit`, `git review`) used to stage, commit, and submit code changes to the Parsoid project for review via Gerrit, assuming `git-review` is installed and configured.

```Shell
$ git add <files> # any files you changed
$ git commit # enter a commit summary
$ git review # send it for review
```

--------------------------------

### Wikitext Template '1x' Content

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This snippet shows the Wikitext content for a MediaWiki template named '1x'. When this template is used (transcluded) on a page, it will display the value passed as its first unnamed parameter.

```Wikitext
{{{1}}}
```

--------------------------------

### Test Case 1: Basic Content Rendering Across Formats

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/phpunit/Parsoid/ParserTests/data/basicTests.txt

This test case demonstrates the rendering of simple 'Hello' content across different output formats. It includes the original wikitext input, its corresponding HTML generated by a PHP process, and HTML specifically generated by Parsoid, highlighting potential differences in output.

```wikitext
Hello
```

```html/php
<p>Hello legacy</p>
```

```html/parsoid
<p>Hello parsoid</p>
```

--------------------------------

### Wikitext Redirect Syntax Not at Start of Line

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/redirects.txt

Confirms that `#redirect` syntax is only recognized as a page redirect if it appears at the very beginning of the wikitext content. If preceded by other text, it's rendered as a regular list item, not a redirect.

```Wikitext
some text

#redirect [[Main Page]]
```

```HTML
<p>some text</p>

<ol data-parsoid='{}'><li data-parsoid='{}'>redirect <a rel="mw:WikiLink" href="./Main_Page" title="Main Page" data-parsoid='{"stx":"simple","a":{"href":"./Main_Page"},"sa":{"href":"Main Page"}}'>Main Page</a></li></ol>
```

--------------------------------

### Indentation: Missing first level

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/definitionLists.txt

Tests indentation starting from the second level, verifying that the parser correctly creates the necessary parent `<dl><dd>` structures.

```Wikitext
::i2
:::i3
```

```HTML
<dl><dd><dl><dd>i2
<dl><dd>i3</dd></dl></dd></dl></dd></dl>
```

--------------------------------

### Basic dummyanno Annotation Parsing

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

Illustrates the fundamental parsing of a `dummyanno` tag, showing how it generates a `meta` tag for the annotation and how subsequent text is rendered in a paragraph. The `data-parsoid` and `data-mw` attributes contain range and offset information.

```Wikitext
Let's have some text.</dummyanno>
plop

Let's have some text.
```

```HTML
<meta typeof="mw:Annotation/dummyanno" data-parsoid='{\"dsr\":[0,11,null,null]}' data-mw='{\"rangeId\":\"mwa0\",\"extendedRange\":false,\"wtOffsets\":[0,11]}'/><p data-parsoid='{\"dsr\":[11,15,0,0]}'>plop</p>

<p data-parsoid='{\"dsr\":[17,38,0,0]}'>Let's have some text.</p><meta typeof="mw:Annotation/dummyanno/End" data-parsoid='{\"dsr\":[38,50,null,null]}' data-mw='{\"wtOffsets\":[38,50]}'/>
```

--------------------------------

### Parsoid Test Configuration and Article Setup

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/interwikiLinks.txt

Defines initial options for Parsoid parser tests and sets up standard articles ('Main Page', 'Foo', 'Template:Foo') that are assumed to exist for the subsequent tests. The 'parsoid-compatible' option is relevant when running parser tests in integrated mode with Parsoid.

```Configuration
parsoid-compatible=wt2html,wt2wt
version=2
```

```Wikitext (Article Definition)
Main Page
!! text
blah blah
```

```Wikitext (Article Definition)
Foo
!!text
FOO
```

```Wikitext (Article Definition)
Template:Foo
!!text
FOO
```

--------------------------------

### Generic Wikitext to HTML Conversion Test

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/phpunit/Parsoid/ParserTests/data/testsWithKnownFailures.txt

This snippet provides a second example of wikitext to HTML conversion, using 'Hello 2' as input. It illustrates a general HTML output, useful for verifying basic rendering functionality and consistency across different conversion scenarios.

```wikitext
Hello 2
```

```html
<p>Hello 2</p>
```

--------------------------------

### Timing Metrics for HTML to Wikitext Conversion in Parsoid

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/metrics.md

Documents performance metrics for converting edited HTML back to wikitext, including initialization, selser setup, preprocessing, DOM diff computation, and total serialization time.

```APIDOC
Metric: html2wt.init
Description: Covers time to parse edited HTML and original HTML, including pagebundles.
Location: Rest/Handler/ParsoidHandler.php

Metric: html2wt.setup
Description: Covers time to set up selser (selective serialization).
Location: Wikitext/ContentHandler.php

Metric: html2wt.preprocess
Description: Covers time to run any extension preprocessors (currently none as of March 2022).
Location: Wikitext/ContentHandler.php

Metric: html2wt.selser.domDiff
Description: Covers time to compute DOM diff between original and edited DOMs.
Location: Html2Wt/SelectiveSerializer.php

Metric: html2wt.selser.serialize
Description: Covers total time to convert HTML to wikitext after selser setup, including html2wt.selser.domDiff.
Location: Html2Wt/SelectiveSerializer.php

Metric: html2wt.total
Description: Covers the total request time within Parsoid, including all html2wt components.
Location: Rest/Handler/ParsoidHandler.php
```

--------------------------------

### Demonstrate f3_uc Parser Function for Uppercase Conversion

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/pFragmentHandlerTests.txt

This snippet shows the basic usage of the `#f3_uc` parser function to convert input text to uppercase. It includes examples with simple strings and nested parser functions.

```MediaWiki Wikitext
{{#f3_uc:lower UPPER}}

{{#f3_uc:{{1x|foo}}}}
```

```HTML
<p><span about="#mwt1" typeof="mw:Transclusion mw:ParserFunction/f3_uc" data-mw='{"parts":[{"parserfunction":{"target":{"wt":"#f3_uc","key":"f3_uc"},"params":{"1":{"wt":"lower UPPER"}},"i":0}}]}'>LOWER UPPER</span></p>
<p><span about="#mwt2" typeof="mw:Transclusion mw:ParserFunction/f3_uc" data-mw='{"parts":[{"parserfunction":{"target":{"wt":"#f3_uc","key":"f3_uc"},"params":{"1":{"wt":"{{1x|foo}}"}},"i":0}}]}'>FOO</span></p>
```

--------------------------------

### Parsoid Wikitext to HTML Conversion Test: Hello

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/phpunit/Parsoid/ParserTests/data/testNoEndTag.txt

This test case demonstrates the conversion of the wikitext 'test 1' into its corresponding HTML output '<p>test 1</p>'. It serves as a basic example of Parsoid's rendering capabilities for simple text.

```wikitext
test 1
```

```html
<p>test 1</p>
```

--------------------------------

### Indent-Pre started by table-line syntax

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/indentPre.txt

This test explores how a preformatted block is initiated when a line of text is followed by lines that resemble table-line syntax but are indented, showing the different interpretations by PHP and Parsoid HTML renderers.

```wikitext
a
 | b
 | c
```

```html/php
<p>a
</p>
<pre>| b
| c
</pre>
```

```html/parsoid
<p>a</p>
<pre>
| b
| c</pre>
```

--------------------------------

### Extend dummyanno Range to Nested Italic Tag Start

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

Demonstrates how a `dummyanno` tag starting at the beginning of a paragraph and ending inside an italicized section (`<i>`) extends its range to cover the entire italicized content, rather than the whole paragraph. Parsoid options include `wt2html`, `selser`, and `wt2wt` modes with annotations enabled.

```Wikitext
<dummyanno>This should ''fail</dummyanno> miserably'' ... let's fix it
```

```HTML
<p><span typeof="mw:ExtendedAnnRange" data-parsoid='{\"autoInsertedStart\":true,\"autoInsertedEnd\":true}'><meta typeof="mw:Annotation/dummyanno" data-mw='{\"rangeId\":\"mwa0\",\"extendedRange\":true,\"wtOffsets\":[0,11]}'/>This should <i>fail miserably</i><meta typeof="mw:Annotation/dummyanno/End" data-mw='{\"wtOffsets\":[29,41]}'/></span> ... let's fix it</p>
```

--------------------------------

### Get Full Page Name: {{FULLPAGENAME}}

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/magicWords.txt

Demonstrates the {{FULLPAGENAME}} magic word, which returns the full name of the current page, including its namespace. This example uses a page title with special characters to show its unencoded output.

```Wikitext
{{FULLPAGENAME}}
```

```HTML/PHP
<p>User:Ævar Arnfjörð Bjarmason
</p>
```

```HTML/Parsoid
<p><span about="#mwt1" typeof="mw:Transclusion" data-mw='{\"parts\":[{\"template\":{\"target\":{\"wt\":\"FULLPAGENAME\",\"function\":\"fullpagename\"},\"params\":{},\"i\":0}}]}'>User:Ævar Arnfjörð Bjarmason</span></p>
```

--------------------------------

### Selser: Insert lists before dummyanno tags, ensuring correct newlines

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test checks the Selser's ability to insert a new list *before* `dummyanno` tags, ensuring that the wikitext output includes the appropriate number of newlines for list formatting.

```JSON
{
        "modes": ["selser"],
        "changes": [
                ["meta", "before", "<ul><li>plop</li></ul>"]
        ]
}
```

```Wikitext
==title==
some paragraph

<dummyanno>
hello
</dummyanno>

some other paragraph
```

```Wikitext
==title==
some paragraph

* plop

<dummyanno>
hello

* plop
</dummyanno>

some other paragraph
```

--------------------------------

### Selser: Insert lists after dummyanno tags, ensuring correct newlines

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test verifies how the Selser handles the insertion of a new list *after* `dummyanno` tags, specifically checking for the correct newlines to maintain proper wikitext list formatting.

```JSON
{
        "modes": ["selser"],
        "changes": [
                ["meta", "after", "<ul><li>plop</li></ul>"]
        ]
}
```

```Wikitext
==title==
some paragraph

<dummyanno>
hello
</dummyanno>

some other paragraph
```

```Wikitext
==title==
some paragraph

<dummyanno>
* plop

hello
</dummyanno>

* plop

some other paragraph
```

--------------------------------

### Handle Template Inside Dummyanno Tag

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test confirms that the presence of a template ('{{1x|...}}') inside a 'dummyanno' tag does not interfere with the annotation's conversion to HTML, ensuring proper nesting and 'rangeId' generation.

```wikitext
<dummyanno>{{1x|
== Title ==
}}

Let's have some text.
</dummyanno>
```

```html/parsoid
<meta typeof="mw:Annotation/dummyanno" data-mw='{"rangeId":"mwa0","extendedRange":false,"wtOffsets":[0,11]}'/><span about="#mwt1" typeof="mw:Transclusion" data-parsoid='{"pi":[[{"k":"1"}]]}' data-mw='{"parts":[{"template":{"target":{"wt":"1x","href":"./Template:1x"},"params":{"1":{"wt":"\n== Title ==\n"}},"i":0}}]}'>
</span><h2 about="#mwt1" id="Title">Title</h2><span about="#mwt1">
</span>

<p>Let's have some text.</p>
<meta typeof="mw:Annotation/dummyanno/End" data-mw='{"wtOffsets":[55,67]}'/>
```

--------------------------------

### External Links: No Preceding Word Characters Allowed (T67278)

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/extLinks.txt

This test case illustrates the rule that free external links are only recognized if they are preceded by non-word characters or start a new line. It shows examples where a URL is not linked if immediately preceded by letters or numbers, but is linked if preceded by punctuation.

```wikitext
NOPEhttp://example.com
N0http://example.com
ok:http://example.com
ok-http://example.com
```

--------------------------------

### Parsoid Wikitext to HTML Conversion Test: Hello 2

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/phpunit/Parsoid/ParserTests/data/testNoEndTag.txt

This test case illustrates the conversion of the wikitext 'test 2' into its corresponding HTML output '<p>test 2</p>'. It provides another simple example of how Parsoid processes wikitext into HTML.

```wikitext
test 2
```

```html
<p>test 2</p>
```

--------------------------------

### Selser: Insert content before and after dummyanno tags, preserving paragraphs

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test confirms that the Selser can insert new paragraph content both before and after `dummyanno` tags, maintaining proper paragraph structure and annotation integrity in the edited wikitext.

```JSON
{
	"modes": ["selser"],
	"changes": [
		["meta", "before", "<p>plop</p>"],
		["meta", "after", "<p>plop2</p>"]
	]
}
```

```Wikitext
<dummyanno>
hello
</dummyanno>
```

```Wikitext
plop

<dummyanno>
plop2

hello

plop
</dummyanno>

plop2
```

--------------------------------

### Run Parsoid Roundtrip Tests

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/devsetup.md

Initiates roundtrip tests on two representative pages to ensure that wikitext can be converted to HTML and back without loss of information. This helps verify the integrity of the parsing and serialization process.

```Bash
npm run roundtrip
```

--------------------------------

### Extend dummyanno Range to Nested Italic Tag End

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

Illustrates how a `dummyanno` tag starting within an italicized section (`<i>`) and ending at the paragraph's conclusion extends its range to encompass the entire italicized content, not the whole paragraph. Parsoid options include `wt2html`, `selser`, and `wt2wt` modes with annotations enabled.

```Wikitext
This should ''fail <dummyanno>miserably'' ... let's fix it</dummyanno>
```

```HTML
<p>This should <span typeof="mw:ExtendedAnnRange" data-parsoid='{\"autoInsertedStart\":true,\"autoInsertedEnd\":true}'><meta typeof="mw:Annotation/dummyanno" data-mw='{\"rangeId\":\"mwa0\",\"extendedRange\":true,\"wtOffsets\":[19,30]}'/><i>fail miserably</i> ... let's fix it<meta typeof="mw:Annotation/dummyanno/End" data-mw='{\"wtOffsets\":[58,70]}'/></span></p>
```

--------------------------------

### Selser: Insert headings before dummyanno tags, ensuring correct newlines

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test verifies the Selser's behavior when inserting a new heading *before* `dummyanno` tags, focusing on the correct generation of newlines for proper wikitext structure.

```JSON
{
        "modes": ["selser","wt2wt"],
        "changes": [
                ["meta", "before", "<h2>plop</h2>"]
        ]
}
```

```Wikitext
==title==
some paragraph

<dummyanno>
hello
</dummyanno>

some other paragraph
```

```Wikitext
==title==
some paragraph

== plop ==

<dummyanno>
hello

== plop ==
</dummyanno>

some other paragraph
```

--------------------------------

### Selser: Insert content before dummyanno tags, preserving paragraphs

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test verifies the Selser's ability to insert new paragraph content *before* `dummyanno` tags, ensuring the original annotation and surrounding paragraphs are correctly handled in the edited wikitext.

```JSON
{
        "modes": ["selser"],
        "changes": [
                ["meta", "before", "<p>plop</p>"]
        ]
}
```

```Wikitext
<dummyanno>
hello
</dummyanno>
```

```Wikitext
plop

<dummyanno>
hello

plop
</dummyanno>
```

--------------------------------

### Handle Poorly Nested Annotation Range with Code Tag (T325575)

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

Demonstrates Parsoid's ability to correctly parse and convert wikitext with poorly nested annotation ranges, specifically when a `<code>` tag is involved. The test ensures that Parsoid automatically inserts start and end tags to create a valid HTML structure while preserving the content and annotation metadata.

```wikitext
<dummyanno><ann2><code>hello</ann2></dummyanno></code>
```

```html/parsoid
<p><span typeof="mw:ExtendedAnnRange" data-parsoid='{"autoInsertedStart":true,"autoInsertedEnd":true}'><meta typeof="mw:Annotation/dummyanno" data-mw='{"rangeId":"mwa0","extendedRange":true,"wtOffsets":[0,11]}'/><span typeof="mw:ExtendedAnnRange" data-parsoid='{"autoInsertedStart":true,"autoInsertedEnd":true}'><meta typeof="mw:Annotation/ann2" data-mw='{"rangeId":"mwa1","extendedRange":true,"wtOffsets":[11,17]}'/><code data-parsoid='{"stx":"html"}'>hello</code><meta typeof="mw:Annotation/ann2/End" data-parsoid='{"wasMoved":true}' data-mw='{"wtOffsets":[28,35]}'/></span><meta typeof="mw:Annotation/dummyanno/End" data-parsoid='{"wasMoved":true}' data-mw='{"wtOffsets":[35,47]}'/></span></p>
```

--------------------------------

### Selser: Insert content after dummyanno tags, preserving paragraphs

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test checks if the Selser correctly inserts new paragraph content *after* `dummyanno` tags, maintaining the integrity of the annotation and surrounding paragraphs in the edited wikitext.

```JSON
{
        "modes": ["selser"],
        "changes": [
                ["meta", "after", "<p>plop2</p>"]
        ]
}
```

```Wikitext
<dummyanno>
hello
</dummyanno>
```

```Wikitext
<dummyanno>
plop2

hello
</dummyanno>

plop2
```

--------------------------------

### Run Parsoid Unit and Parser Tests

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/devsetup.md

Executes the main test suite for Parsoid, which includes parserTests.js, unit tests with Mocha, and various code style checkers. This is a comprehensive test to verify changes.

```Bash
npm test
```

--------------------------------

### Wikitext to HTML Conversion: Definition List with Bracketed URL

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/definitionLists.txt

Shows the conversion of a wikitext definition list term containing a bracketed external URL with custom text (`[http://www.example.com/ Example]`) into an HTML link (`<a>`). This verifies the parsing of explicit external links.

```Wikitext
;[http://www.example.com/ Example]:Something about it
```

```HTML
<dl><dt><a rel="nofollow" class="external text" href="http://www.example.com/">Example</a></dt>
<dd>Something about it</dd></dl>
```

--------------------------------

### Display Parser Test Options

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/devsetup.md

Shows all available command-line options for the parser test suite. This is helpful for understanding and customizing test execution, including different parsing modes like `--wt2html` or `--html2wt`.

```Bash
node bin/parserTests --help
```

--------------------------------

### Wikitext Template Expanded Content Wrapping (1c)

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/indentPre.txt

Illustrates that preformatting wrapping is based on the *expanded* content of a template. A line starting with a space in the expanded content becomes preformatted, while subsequent lines without a leading space become paragraphs.

```wikitext
 {{1x|a
b}}
```

```html
<pre>a
</pre>
<p>b
</p>
```

--------------------------------

### Selser: T295330 - DSR computation with dummyanno and category

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test case, related to task T295330, ensures that the DSR (Document Structure Representation) computation correctly handles `dummyanno` annotations and categories, allowing for proper Selser operations. It demonstrates the HTML output generated by Parsoid.

```JSON
{
  "annotations": 1
}
```

```Wikitext
<dummyanno>
<!--T:1-->
'''The quick brown fox jumps over the lazy dog.'''
</dummyanno>

[[Category:Foo]]
```

```HTML
<meta typeof="mw:Annotation/dummyanno" data-mw='{"rangeId":"mwa0","extendedRange":false,"wtOffsets":[0,11]}'/>
<!--T:1-->
<p><b>The quick brown fox jumps over the lazy dog.</b></p>
<meta typeof="mw:Annotation/dummyanno/End" data-mw='{"wtOffsets":[74,86]}'/>

<link rel="mw:PageProp/Category" href="./Category:Foo" data-parsoid='{"stx":"simple","a":{"href":"./Category:Foo"},"sa":{"href":"Category:Foo"}}'/>
```

--------------------------------

### Selser: Insert headings after dummyanno tags, ensuring correct newlines

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test examines how the Selser handles the insertion of a new heading *after* `dummyanno` tags, specifically checking for the correct number of newlines to maintain proper wikitext formatting.

```JSON
{
        "modes": ["selser"],
        "changes": [
                ["meta", "after", "<h2>plop</h2>"]
        ]
}
```

```Wikitext
==title==
some paragraph

<dummyanno>
hello
</dummyanno>

some other paragraph
```

```Wikitext
==title==
some paragraph

<dummyanno>
== plop ==
hello
</dummyanno>

== plop ==

some other paragraph
```

--------------------------------

### Indent-Pre and Table-Line Syntax (Preformatted block)

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/indentPre.txt

This test demonstrates how lines starting with a space, followed by what looks like table-line syntax (| b, | c), are interpreted as part of a preformatted block in PHP HTML output, rather than table content.

```wikitext
 a
 | b
 | c
```

```html/php
<pre>a
| b
| c
</pre>
```

--------------------------------

### MediaWiki Wikitext Input for Template Continuity Test

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

The MediaWiki wikitext input demonstrating a template `{{1x|...}}` containing text, a table, and a `dummyanno` annotation. This wikitext is designed to test how annotations interact with transcluded table content.

```Wikitext
{{1x|Some text!
<table>
<p>first fostered</p>
<tr>
<td>table</td></tr>}}
<dummyanno><tr>
<td>stuff</td>
</tr></dummyanno><p>last fostered</p>
</table>
```

--------------------------------

### ISBN Magic Link Rendering Example

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/magicLinks.txt

An example of an ISBN magic link rendered by Parsoid, showing the `data-parsoid` attribute for structural information and `mw:Entity` for preserving spaces.

```html
<p><a href="./Special:BookSources/9780123456" rel="mw:WikiLink" data-parsoid='{"stx":"magiclink"}'>ISBN 978-0-1234-56</a><span typeof="mw:Entity" data-parsoid='{"src":"&#x20;","srcContent":" "}'> </span>789</p>
```

--------------------------------

### Test Parsoid Parse Tool with Wikitext Input

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/devsetup.md

Demonstrates how to use the `parse.js` tool to test parser and serializer features by piping a sample wikitext string as input. This command exercises a reasonable number of features, though not as comprehensively as the full parser test suite.

```Bash
echo "''Non'''-trivial'' wikitext''' [[with links]] {{echo|and templates}} | node bin/parse --wt2wt
```

--------------------------------

### Execute Parsoid Parser Tests Directly

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/devsetup.md

Runs the parser tests (parserTests.js) directly using Node.js. This command can be noisy, but provides detailed output on test failures. Options like `--quiet` can reduce verbosity.

```Bash
node bin/parserTests
```

--------------------------------

### Example Free External Link with Percent-Encoded Ampersand

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/extLinks.txt

An initial example demonstrating the HTML output for a free external link where the URL contains a percent-encoded ampersand (%26). This shows the basic rendering of such a link by Parsoid.

```html/parsoid
<p><a rel="mw:ExtLink" href="http://www.example.com/?title=AT%26T" class="external free">http://www.example.com/?title=AT%26T</a></p>
```

--------------------------------

### Table with Empty Line After Start Tag

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/tables.txt

Illustrates Parsoid's parsing of tables that include an empty line directly after the table start tag ({|) but before the first row definition. This tests whitespace handling at the table's beginning.

```wikitext
{|

|-
|foo
|}
```

```html/*
<table>


<tbody><tr>
<td>foo
</td></tr></tbody></table>
```

--------------------------------

### MediaWiki Template: tbl-start

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/tables.txt

Defines a MediaWiki template 'tbl-start' that outputs the Wikitext syntax for initiating a table.

```Wikitext
{|
```

--------------------------------

### GNU GPL License Notice for Source Files

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/COPYING.txt

A template for the license notice that should be attached to the beginning of each source file of a program released under the GNU General Public License. It specifies copyright details, redistribution rights, and disclaims all warranties.

```plaintext
<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year>  <name of author>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
```

--------------------------------

### T265737: 1. Relax section start requirements to reduce unnecessary conflicts between template and section boundaries

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/sectionWrappingParserTests.txt

This test examines how section wrapping interacts with templates, specifically when a section starts immediately after a template. It compares the HTML output from the PHP parser and Parsoid, with 'wrapSections' enabled.

```Wikitext
= x =
{{Foobar1}}
y
```

```HTML/PHP
<div class="mw-heading mw-heading1"><h1 id="x">x</h1><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=Parser_test&amp;action=edit&amp;section=1" title="Edit section: x">edit</a><span class="mw-editsection-bracket">]</span></span></div>
<div class="mw-heading mw-heading2"><h2 id="bar">bar</h2><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=Template:Foobar1&amp;action=edit&amp;section=T-1" title="Edit section: bar">edit</a><span class="mw-editsection-bracket">]</span></span></div>
<p>baz
y
</p>
```

```HTML/Parsoid
<section data-mw-section-id="0"></section><section data-mw-section-id="1"><h1 id="x">x</h1>
<section data-mw-section-id="-1"><span about="#mwt1" typeof="mw:Transclusion" data-parsoid='{"pi":[[]]}' data-mw='{"parts":[{"template":{"target":{"wt":"Foobar1","href":"./Template:Foobar1"},"params":{},"i":0}},"\ny"]}'>

</span><h2 about="#mwt1" id="bar">bar</h2><span about="#mwt1">
</span><p about="#mwt1">baz
y</p></section></section>
```

--------------------------------

### Example Wikitext for Table Conversion Template

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/design.md

This wikitext example demonstrates a 'convert' template used within a table, which can cause issues when the construct is split across top-level content and templates. This specific pattern affects pages like enwiki:List_of_largest_container_ships and requires generalization of the 'TableFixups.php' code.

```Wikitext
{|\n|{{convert| 400|m|ft|disp=table|sortable=on}}\n|}
```

--------------------------------

### Convert Whole Content Wrapped by Dummyanno Tags

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test checks how Parsoid converts wikitext with a 'dummyanno' tag wrapping an entire section (including a heading and a paragraph) into HTML, ensuring correct meta tag placement and 'rangeId' generation.

```wikitext
<dummyanno>
==Title==

Let's have some text.
</dummyanno>
```

```html/parsoid
<meta typeof="mw:Annotation/dummyanno" data-mw='{"rangeId":"mwa0","extendedRange":false,"wtOffsets":[0,11]}'/>
<h2 id="Title" data-parsoid='{"dsr":[12,23,2,2,1,1]}'>Title</h2>

<p data-parsoid='{"dsr":[25,46,0,0]}'>Let's have some text.</p>
<meta typeof="mw:Annotation/dummyanno/End" data-mw='{"wtOffsets":[45,57]}'/>
```

--------------------------------

### Table Test: Stray Table End Tags on Start Line

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/tables.txt

Examines how Parsoid and PHP handle tables with stray `|}` (table end) tags on the same line as the table start tag (`{|`), and with or without additional attributes like `id`. This test covers multiple variations of this syntax.

```Wikitext
{|style="color: red;"|}

{|style
```

--------------------------------

### RFC 2373 IPv6 Address Type URL Examples

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/extLinks.txt

Illustrates different types of IPv6 addresses (unicast, multicast, loopback, unspecified, and IPv4-compatible) when used as literals in URLs, based on RFC 2373, section 2.2. These examples highlight the specific syntax for each address type.

```URL Syntax
http://[1080::8:800:200C:417A]/unicast
```

```URL Syntax
http://[FF01::101]/multicast
```

```URL Syntax
http://[::1]/loopback
```

```URL Syntax
http://[::]/unspecified
```

```URL Syntax
http://[::13.1.68.3]/ipv4compat
```

```URL Syntax
http://[::FFFF:129.144.52.38]/ipv4compat
```

--------------------------------

### Handling Ready Asynchronous Content with f6_async_return

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/pFragmentHandlerTests.txt

This test demonstrates the `f6_async_return` parser function when the content is immediately available ('ready' case). It shows how the function processes the 'ready' state and outputs the specified content without any fallback.

```wikitext
Content is ready: {{#f6_async_return:ready|Ready!}}
```

```html
<p>Content is ready: <span about="#mwt1" typeof="mw:Transclusion mw:ParserFunction/f6_async_return" data-mw='{"parts":[{"parserfunction":{"target":{"wt":"#f6_async_return","key":"f6_async_return"},"params":{"1":{"wt":"ready"},"2":{"wt":"Ready!"}},"i":0}}]}'>Ready!</span></p>
```

--------------------------------

### T265737: 2. Relax section start requirements to reduce unnecessary conflicts between template and section boundaries

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/sectionWrappingParserTests.txt

This test further explores section wrapping and template interactions, specifically when a section starts after a template that includes comments and page properties. It compares the HTML output from the PHP parser and Parsoid, with 'wrapSections' enabled.

```Wikitext
= x =
{{Foobar2}}
y
```

```HTML/PHP
<div class="mw-heading mw-heading1"><h1 id="x">x</h1><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=Parser_test&amp;action=edit&amp;section=1" title="Edit section: x">edit</a><span class="mw-editsection-bracket">]</span></span></div>
<p><br />
</p>
<div class="mw-heading mw-heading2"><h2 id="bar">bar</h2><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=Template:Foobar2&amp;action=edit&amp;section=T-1" title="Edit section: bar">edit</a><span class="mw-editsection-bracket">]</span></span></div>
<p>baz
y
</p>
```

```HTML/Parsoid
<section data-mw-section-id="0"></section><section data-mw-section-id="1"><h1 id="x">x</h1>
<section data-mw-section-id="-1"><span about="#mwt1" typeof="mw:Transclusion" data-parsoid='{"pi":[[]]}' data-mw='{"parts":[{"template":{"target":{"wt":"Foobar2","href":"./Template:Foobar2"},"params":{},"i":0}},"\ny"]}'><!--Some comment--></span><span about="#mwt1">
</span><span about="#mwt1"><!--Some comment--></span><span about="#mwt1">

</span><link rel="mw:PageProp/Category" href="./Category:BadTemplate" about="#mwt1"/><span about="#mwt1">
</span><meta property="mw:PageProp/notoc" about="#mwt1"/><span about="#mwt1">

</span><h2 about="#mwt1" id="bar">bar</h2><span about="#mwt1">
</span><p about="#mwt1">baz
y</p></section></section>
```

--------------------------------

### Configure Git Remote for Gerrit

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/devsetup.md

This command adds a Gerrit remote to your local Git repository, enabling you to submit patches to the Parsoid project. Replace <YOUR-USERNAME> with your actual Gerrit username.

```Bash
git remote add gerrit ssh://<YOUR-USERNAME>@gerrit.wikimedia.org:29418/mediawiki/services/parsoid
```

--------------------------------

### Convert Wikitext to HTML using Parsoid Parse Tool

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/setup.md

This command demonstrates using the `parse.js` script to convert a simple wikitext string into HTML. The tool supports various conversion options like `--wt2wt`, `--html2wt`, and `--html2html`, and `--normalize=parsoid` for cleaner output.

```Shell
$ echo "some harmless [[wikitext]]" | node tests/parse
```

--------------------------------

### RFC 2732 IPv6 Address URL Syntax Examples

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/extLinks.txt

Demonstrates various forms of IPv6 literal addresses within URLs, including full, compressed, and IPv4-mapped addresses, as defined in RFC 2732, section 2. These examples show how to correctly format IPv6 addresses when used as hostnames in URLs.

```URL Syntax
http://[FEDC:BA98:7654:3210:FEDC:BA98:7654:3210]:80/index.html
```

```URL Syntax
http://[1080:0:0:0:8:800:200C:417A]/index.html
```

```URL Syntax
http://[3ffe:2a00:100:7031::1]
```

```URL Syntax
http://[1080::8:800:200C:417A]/foo
```

```URL Syntax
http://[::192.9.5.5]/ipng
```

```URL Syntax
http://[::FFFF:129.144.52.38]:80/index.html
```

```URL Syntax
http://[2010:836B:4179::836B:4179]
```

--------------------------------

### MediaWiki Template: 1x

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/tables.txt

Defines a simple MediaWiki template '1x' that takes one unnamed parameter and outputs its value.

```Wikitext
{{{1}}}
```

--------------------------------

### GNU GPL Copyright Disclaimer Sample

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/COPYING.txt

A template for a copyright disclaimer that an employer or school might sign to relinquish their copyright interest in a program written by an employee or student, thereby allowing the program to be released under the GNU GPL.

```plaintext
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
`Gnomovision' (which makes passes at compilers) written by James Hacker.

<signature of Ty Coon>, 1 April 1989
Ty Coon, President of Vice
```

--------------------------------

### Handling Not Ready Asynchronous Content with f6_async_return

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/pFragmentHandlerTests.txt

This snippet illustrates the `f6_async_return` parser function's behavior when content is not immediately ready ('not ready' case). It demonstrates both the default fallback mechanism and the use of a custom fallback message provided as an argument.

```wikitext
Default fallback content: {{#f6_async_return:not ready}}

Specified fallback content: {{#f6_async_return:not ready|My own fallback}}
```

```html
<p>Default fallback content: <span class="mw-async-not-ready" typeof="mw:Transclusion mw:ParserFunction/f6_async_return" data-mw='{"parts":[{"parserfunction":{"target":{"wt":"#f6_async_return","key":"f6_async_return"},"params":{"1":{"wt":"not ready"}},"i":0}}]}'><span typeof="mw:I18n" data-mw-i18n='{"/":{"lang":"x-page","key":"parsoid-async-not-ready-fallback"}}'></span></span></p>
<p>Specified fallback content: <span about="#mwt2" typeof="mw:Transclusion mw:ParserFunction/f6_async_return" data-mw='{"parts":[{"parserfunction":{"target":{"wt":"#f6_async_return","key":"f6_async_return"},"params":{"1":{"wt":"not ready"},"2":{"wt":"My own fallback"}},"i":0}}]}'>My own fallback</span></p>
```

--------------------------------

### Get Talk Namespace Name: {{TALKSPACE}} in Main Namespace

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/magicWords.txt

Illustrates the behavior of {{TALKSPACE}} when the current page is in the main (article) namespace. In this scenario, it returns 'Talk', which is the default talk namespace.

```Wikitext
{{TALKSPACE}}
```

```HTML/PHP
<p>Talk
</p>
```

```HTML/Parsoid
<p><span about="#mwt1" typeof="mw:Transclusion" data-mw='{\"parts\":[{\"template\":{\"target\":{\"wt\":\"TALKSPACE\",\"function\":\"talkspace\"},\"params\":{},\"i\":0}}]}'>Talk</span></p>
```

--------------------------------

### Display ParserTests Command-Line Options

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/README.md

Command to view the available command-line options and help information for the `parserTests.js` utility.

```Shell
node bin/parserTests.js --help
```

--------------------------------

### Simple Key-Value Return with f7_kv Parser Function

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/pFragmentHandlerTests.txt

This test case verifies the basic functionality of the `f7_kv` parser function. It demonstrates its ability to process and return key-value pair arguments in a straightforward manner, showing the direct output of the function.

```wikitext
{{#f7_kv:foo=bar|bat=baz}}
```

```html
<p><span typeof="mw:Transclusion mw:ParserFunction/f7_kv" data-mw='{"parts":[{"parserfunction":{"target":{"wt":"#f7_kv","key":"f7_kv"},"params":{"bat":{"wt":"baz"},"2":null,"1":{"wt":"foo=bar"}},"i":0}}]}'>(arguments)</span></p>
```

--------------------------------

### Run Parsoid Parser Tests

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/README.md

Command to execute the `parserTests.js` script, which requires MediaWiki's `parserTests.txt` file. This script is used for running parser-specific tests.

```Shell
node bin/parserTests.js
```

--------------------------------

### MediaWiki Test Environment Configuration

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/pFragmentHandlerTests.txt

Sets up the necessary MediaWiki environment for Parsoid tests, including global options, a simple template, and two articles (one with a redirect) to be used as test data.

```MediaWiki Options
parsoid-compatible=wt2html
version=2
```

```MediaWiki Template
Template:1x
!! text
{{{1}}}
```

```MediaWiki Article
Foo
!! text
Define [[Foo]] to avoid a red link
```

```MediaWiki Redirect
FOO
!! text
#REDIRECT [[Foo]]
```

--------------------------------

### Converting Multi-line Wikitext Table Captions to HTML

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/tables.txt

This example demonstrates how multi-line captions in MediaWiki wikitext tables are rendered in HTML, preserving the line breaks within the caption element.

```wikitext
{|
|+line 1 of caption
line 2 of caption
|data
|}
```

```html
<table>
<caption>line 1 of caption
line 2 of caption
</caption>
<tbody><tr>
<td>data
</td></tr></tbody></table>
```

--------------------------------

### Render Simple Thumbnailed Video

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/timedMediaHandlerParserTests.txt

Illustrates the rendering of a video with the `|thumb` option in wikitext, showing how it generates a `<figure>` element with a smaller video player and a thumbnail image.

```Wikitext
[[File:Video.ogv|thumb]]
```

```HTML/PHP
<figure class="mw-default-size" typeof="mw:File/Thumb"><span><video id="mwe_player_1" poster="http://example.com/images/thumb/0/00/Video.ogv/180px--Video.ogv.jpg" controls="" preload="none" data-mw-tmh="" class="mw-file-element" width="180" height="135" data-durationhint="5" data-mwtitle="Video.ogv" data-mwprovider="local" resource="/wiki/File:Video.ogv"><source src="http://example.com/images/0/00/Video.ogv" type="video/ogg; codecs=&quot;theora&quot;" data-width="320" data-height="240" /></video></span><figcaption></figcaption></figure>
```

```HTML/Parsoid
<figure class="mw-default-size" typeof="mw:File/Thumb"><span><video poster="http://example.com/images/thumb/0/00/Video.ogv/180px--Video.ogv.jpg" controls="" preload="none" data-mw-tmh="" height="135" width="180" resource="./File:Video.ogv" data-durationhint="5" class="mw-file-element"><source src="http://example.com/images/0/00/Video.ogv" type='video/ogg; codecs="theora"' data-file-width="320" data-file-height="240"/></video></span><figcaption></figcaption></figure>
```

--------------------------------

### Parsoid HTML Attributes for Page Reading

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/data.md

HTML attributes are used for information essential for reading the page, including client-side JavaScript uses like styling. Examples include `typeof` and `about` for template identification.

```APIDOC
HTML Attributes:
  typeof: string
    Purpose: Identifies the type of an HTML element, often used for template identification.
    Usage: <div typeof="mw:Transclusion">...</div>
  about: string
    Purpose: Links an HTML element to a resource, often used in conjunction with typeof for template identification.
    Usage: <div about="#mwt1">...</div>
```

--------------------------------

### Parse Row-syntax Table Cells

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/tables.txt

Tests the parsing of table cells where the row starts with a table cell, specifically demonstrating how newlines and '||' delimiters are handled within a single row.

```Wikitext
{|
|a
b||c
|}
```

```HTML
<table>
<tbody><tr>
<td>a
<p>b||c
</p>
</td></tr></tbody></table>
```

--------------------------------

### Get Talk Namespace Name: {{TALKSPACE}} in User Talk Namespace

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/magicWords.txt

Demonstrates {{TALKSPACE}} when the current page is already in a talk namespace (e.g., 'User talk:'). It correctly returns the name of that same talk namespace.

```Wikitext
{{TALKSPACE}}
```

```HTML/PHP
<p>User talk
</p>
```

```HTML/Parsoid
<p><span about="#mwt1" typeof="mw:Transclusion" data-mw='{\"parts\":[{\"template\":{\"target\":{\"wt\":\"TALKSPACE\",\"function\":\"talkspace\"},\"params\":{},\"i\":0}}]}'>User talk</span></p>
```

--------------------------------

### Timing Metrics for Language Conversion in Parsoid

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/metrics.md

Documents performance metrics for the language converter, including initialization times (general and variant-specific) and total conversion times.

```APIDOC
Metric: langconv.init
Description: Covers initialization time for the language converter.
Location: LanguageConverter.php

Metric: langconv.$HTMLVARIANT.init
Description: Covers initialization time, split by HTML variants.
Location: LanguageConverter.php

Metric: langconv.total
Description: Covers time to convert to the requested HTML variant.
Location: LanguageConverter.php

Metric: langconv.$HTMLVARIANT.total
Description: Covers time to convert to the requested HTML variant, split by variants.
Location: LanguageConverter.php

Metric: langconv.totalWithInit
Description: Includes both langconv.init and langconv.total.
Location: LanguageConverter.php
```

--------------------------------

### Parsoid HTML Output for Section Parsing

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/sectionWrappingParserTests.txt

Displays the HTML structure generated by Parsoid for the wikitext examples. This output includes Parsoid-specific metadata attributes like `data-parsoid` and `data-mw-section-id`, which are used for round-tripping and semantic preservation.

```HTML
<section data-mw-section-id="0"><meta property="mw:PageProp/toc" data-mw='{"autoGenerated":true}'/></section><section data-mw-section-id="1"><h2 id="PHP_section=1" data-parsoid="{}"><span id="PHP_section.3D1" typeof="mw:FallbackId"></span>PHP section=1</h2>
<p><span about="#mwt1" typeof="mw:Transclusion" data-parsoid='{"pi":[[{"k":"1"},{"k":"2"}]]}' data-mw='{"parts":[{"template":{"target":{"wt":"1x","href":"./Template:1x"},"params":{"1":{"wt":"Not a section"},"2":{"wt":"\n== This is counted as if it were section 2 ==\n"}},"i":0}}]}'>Not a section</span></p>
</section><section data-mw-section-id="3"><h2 id="PHP_section=3" data-parsoid="{}"><span id="PHP_section.3D3" typeof="mw:FallbackId"></span>PHP section=3</h2>
```

--------------------------------

### Wikitext to HTML Conversion: Simple Definition List

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/definitionLists.txt

Demonstrates the conversion of a basic wikitext definition list (`:name :Definition`) into its corresponding HTML `<dl><dt><dd>` structure, showing standard parsing behavior.

```Wikitext
;name :Definition
```

```HTML
<dl><dt>name</dt>
<dd>Definition</dd></dl>
```

--------------------------------

### Applying __NOGALLERY__ Magic Word and Flag Setting

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/magicWords.txt

This example illustrates how the __NOGALLERY__ magic word in wikitext is processed by Parsoid, resulting in an HTML <meta> property and the setting of the 'mw-NoGallery' flag in the page's metadata.

```Wikitext
__NOGALLERY__
```

```HTML
<meta property="mw:PageProp/nogallery" data-parsoid='{\"src\":\"__NOGALLERY__\",\"magicSrc\":\"__NOGALLERY__\"}'/>
```

```APIDOC
flags=mw-NoGallery
```

--------------------------------

### Parsoid Wikitext to HTML Transformation Test

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/phpunit/Parsoid/ParserTests/data/twoVersionsDecl.txt

This is a test test. Demonstrates the transformation of 'Hello' wikitext into HTML by both legacy PHP and Parsoid parsers, verifying consistent output.

```Wikitext
Hello
```

```HTML/PHP
<p>Hello legacy</p>
```

```HTML/Parsoid
<p>Hello parsoid</p>
```

--------------------------------

### Basic Wikitext to HTML Conversion Test (Parsoid)

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/phpunit/Parsoid/ParserTests/data/testsWithKnownFailures.txt

This test case demonstrates the conversion of a simple 'Hello' wikitext input into HTML. It shows the output from both a legacy PHP rendering engine and the Parsoid service, highlighting potential differences in HTML structure and rendering.

```wikitext
Hello
```

```html/php
<p>Hello legacy</p>
```

```html/parsoid
<p>Hello parsoid</p>
```

--------------------------------

### Get Encoded Talk Namespace Name: {{TALKSPACEE}}

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/magicWords.txt

Shows the {{TALKSPACEE}} magic word, which returns the URL-encoded name of the talk namespace corresponding to the current page's namespace. For a 'User:' page, it returns 'User_talk'.

```Wikitext
{{TALKSPACEE}}
```

```HTML/PHP
<p>User_talk
</p>
```

```HTML/Parsoid
<p><span about="#mwt1" typeof="mw:Transclusion" data-mw='{\"parts\":[{\"template\":{\"target\":{\"wt\":\"TALKSPACEE\",\"function\":\"talkspacee\"},\"params\":{},\"i\":0}}]}'>User_talk</span></p>
```

--------------------------------

### Wikitext Preformatting with Inline Content

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/indentPre.txt

Demonstrates how preformatted text interacts with inline formatting. The example shows that inline formatting like italics (`''b''`) is correctly preserved and rendered within the `<pre>` block.

```wikitext
 a
 ''b''
```

```html
<pre>a
<i>b</i>
</pre>
```

--------------------------------

### MediaWiki Article: Main Page

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/tables.txt

Defines the standard 'Main Page' article content assumed to exist for testing purposes.

```Wikitext
blah blah
```

--------------------------------

### CSS for Resetting MediaWiki Reference Back-link Counter

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tools/cite_css/generated.parsoid.cite.css.output.txt

Defines the CSS rule to reset the 'mw-ref-linkback' counter for elements that serve as containers for reference back-links. This ensures that the numbering or lettering for back-links starts correctly.

```CSS
span[ rel="mw:referencedBy" ] {
	counter-reset: mw-ref-linkback 0;
}
```

--------------------------------

### Resetting MediaWiki Reference Linkback Counter

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tools/cite_css/generated.parsoid.cite.css.output.txt

This CSS rule initializes the 'mw-ref-linkback' counter to 0 for elements that serve as containers for referenced content. This ensures that reference numbering starts correctly within each context.

```CSS
span[ rel="mw:referencedBy" ] {
	counter-reset: mw-ref-linkback 0;
}
```

--------------------------------

### Parsoid Test Configuration Options

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/definitionLists.txt

Defines the parsoid-compatible modes and version for integrated parser tests, specifying how wikitext should be converted to HTML and back, and the version of the test suite.

```Configuration
parsoid-compatible=wt2html,wt2wt
version=2
```

--------------------------------

### Render Simple Video Element

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/timedMediaHandlerParserTests.txt

Demonstrates how a basic `[[File:Video.ogv]]` wikitext link is rendered into HTML by both MediaWiki's PHP parser and Parsoid, producing a standard HTML5 `<video>` tag.

```Wikitext
[[File:Video.ogv]]
```

```HTML/PHP
<p><span class="mw-default-size" typeof="mw:File"><span><video id="mwe_player_1" poster="http://example.com/images/thumb/0/00/Video.ogv/320px--Video.ogv.jpg" controls="" preload="none" data-mw-tmh="" class="mw-file-element" width="320" height="240" data-durationhint="5" data-mwtitle="Video.ogv" data-mwprovider="local"><source src="http://example.com/images/0/00/Video.ogv" type="video/ogg; codecs=&quot;theora&quot;" data-width="320" data-height="240" /></video></span></span>
</p>
```

```HTML/Parsoid
<p><span class="mw-default-size" typeof="mw:File"><span><video poster="http://example.com/images/thumb/0/00/Video.ogv/320px--Video.ogv.jpg" controls="" preload="none" data-mw-tmh="" height="240" width="320" resource="./File:Video.ogv" data-durationhint="5" class="mw-file-element"><source src="http://example.com/images/0/00/Video.ogv" type='video/ogg; codecs="theora"' data-file-width="320" data-file-height="240"/></video></span></span></p>
```

--------------------------------

### Retrieve Parsoid Daemon Version Information (GET)

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/apiuse.md

This endpoint provides information about the running Parsoid daemon, including its name, version from `package.json`, and the Git SHA of the HEAD commit if running from a repository. It returns a JSON object.

```APIDOC
Endpoint: /_version/
Method: GET
Description: Returns a JSON object with daemon name, version, and Git SHA (if applicable).
Response Body (JSON):
  - name: string (e.g., "mediawiki-parsoid")
  - version: string (e.g., "0.0.1")
  - sha: string (optional, Git commit SHA, e.g., "63a778a1ffc1e9bd0dbb3a7571fe40bfb0a6d699")
```

--------------------------------

### Render Basic Audio Element

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/timedMediaHandlerParserTests.txt

Illustrates the default HTML output for an audio file in MediaWiki, comparing the rendering by the PHP parser and Parsoid.

```Wikitext
[[File:Audio.oga]]
```

```HTML (PHP Parser)
<p><span class="mw-default-size" typeof="mw:File"><span><audio id="mwe_player_1" controls="" preload="none" data-mw-tmh="" class="mw-file-element" width="180" style="width:180px;" data-durationhint="1" data-mwtitle="Audio.oga" data-mwprovider="local"><source src="http://example.com/images/4/41/Audio.oga" type="audio/ogg; codecs=&quot;vorbis&quot;" data-width="0" data-height="0" /></audio></span></span>
</p>
```

```HTML (Parsoid)
<p><span class="mw-default-size mw-default-audio-height" typeof="mw:File"><span><audio controls="" preload="none" data-mw-tmh="" height="32" width="180" style="width: 180px;" resource="./File:Audio.oga" data-durationhint="1" class="mw-file-element"><source src="http://example.com/images/4/41/Audio.oga" type='audio/ogg; codecs="vorbis"'/></audio></span></span></p>
```

--------------------------------

### Controlling New Section Links with Magic Words

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/magicWords.txt

This example illustrates how __NEWSECTIONLINK__ and __NONEWSECTIONLINK__ magic words control the 'add new section' functionality. Both are converted to HTML <meta> properties and influence the 'mw-NewSection' and 'mw-HideNewSection' flags respectively.

```Wikitext
__NEWSECTIONLINK__ __NONEWSECTIONLINK__
```

```HTML
<section data-mw-section-id="0"><meta property="mw:PageProp/newsectionlink" data-parsoid='{\"src\":\"__NEWSECTIONLINK__\",\"magicSrc\":\"__NEWSECTIONLINK__\",\"dsr\":[0,18,null,null]}'/> <meta property="mw:PageProp/nonewsectionlink" data-parsoid='{\"src\":\"__NONEWSECTIONLINK__\",\"magicSrc\":\"__NONEWSECTIONLINK__\"}'/></section>
```

```APIDOC
flags=mw-HideNewSection, mw-NewSection
```

--------------------------------

### Wikitext Table Construction Using Template Pipe Syntax

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/tables.txt

Demonstrates building a Wikitext table using `{{!}}` to represent pipe characters, which is common when tables are generated via templates. Shows how attributes are applied to rows and cells.

```wikitext
{{{!}} class="wikitable"
!header
!second header
{{!}}- style="color:red;"
{{!}}data{{!}}{{!}} style="color:red;" {{!}}second data
{{!}}}
```

```html
<table class="wikitable">
<tbody><tr>
<th>header
</th>
<th>second header
</th></tr>
<tr style="color:red;">
<td>data</td>
<td style="color:red;">second data
</td></tr></tbody></table>
```

--------------------------------

### Prevent Meta Tag Merging with Annotations and Templates

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

Shows that when a `dummyanno` wraps a template transclusion (`{{1x|stuff}}`), the `meta` tags for the annotation and the `span` for the transclusion remain separate, preventing unintended merging. Annotations are enabled.

```Wikitext
<dummyanno>{{1x|stuff}}</dummyanno>
```

```HTML
<p><meta typeof="mw:Annotation/dummyanno" data-mw='{\"rangeId\":\"mwa0\",\"extendedRange\":false,\"wtOffsets\":[0,11]}'/><span about="#mwt1" typeof="mw:Transclusion" data-parsoid='{\"pi\":[[{\"k\":\"1\"}]]}' data-mw='{\"parts\":[{\"template\":{\"target\":{\"wt\":\"1x\",\"href\":\"./Template:1x\"},\"params\":{\"1\":{\"wt\":\"stuff\"}},\"i\":0}}]}'>stuff</span><meta typeof="mw:Annotation/dummyanno/End" data-mw='{\"wtOffsets\":[23,35]}'/></p>
```

--------------------------------

### Ensure Annotations Are Not Hoisted Out of Headers

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test verifies that annotations embedded within header elements remain inside the header in the generated HTML, preventing incorrect structural changes. It specifically checks the `annotations=1` option.

```Wikitext
==<dummyanno><!--T:19--> Organizational and Planning Projects</dummyanno>==
```

```HTML
<h2 id="Organizational_and_Planning_Projects"><meta typeof="mw:Annotation/dummyanno" data-mw='{\"rangeId\":\"mwa0\",\"extendedRange\":false,\"wtOffsets\":[2,13]}'/><!--T:19--> Organizational and Planning Projects<meta typeof="mw:Annotation/dummyanno/End" data-mw='{\"wtOffsets\":[61,73]}'/></h2>
```

```Configuration
annotations=1
```

--------------------------------

### Basic Parser Function Test with f1_wt

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/pFragmentHandlerTests.txt

Demonstrates the basic usage of the `f1_wt` parser function with plain text and italicized arguments, showing both Wikitext input and Parsoid HTML output.

```Wikitext
{{#f1_wt:foo|bar}}

{{#f1_wt:foo|''bar''}}
```

```HTML
<p><span about="#mwt1" typeof="mw:Transclusion mw:ParserFunction/f1_wt" data-mw='{\"parts\":[{\"parserfunction\":{\"target\":{\"wt\":\"#f1_wt\",\"key\":\"f1_wt\"},\"params\":{\"1\":{\"wt\":\"foo\"},\"2\":{\"wt\":\"bar\"}},\"i\":0}}}]}' >foo bar</span></p>
<p><span about="#mwt2" typeof="mw:Transclusion mw:ParserFunction/f1_wt" data-mw='{\"parts\":[{\"parserfunction\":{\"target\":{\"wt\":\"#f1_wt\",\"key\":\"f1_wt\"},\"params\":{\"1\":{\"wt\":\"foo\"},\"2\":{\"wt\":\"&apos;&apos;bar&apos;&apos;\"}},\"i\":0}}}]}' >foo </span><i about="#mwt2">bar</i></p>
```

--------------------------------

### Global Parsoid Test Configuration Options

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/headings.txt

Defines global configuration options for Parsoid tests, specifying the version and compatible parsing modes (wikitext to HTML and wikitext to wikitext).

```Configuration
version=2
parsoid-compatible=wt2html,wt2wt
```

--------------------------------

### MediaWiki Template Definition: 1x

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/pWrapping.txt

Defines a simple MediaWiki template named '1x'. This template takes a single parameter and outputs its content directly. It is used in subsequent tests to demonstrate transclusion behavior.

```wikitext
Template:1x
!! text
{{{1}}}
```

--------------------------------

### Get Talk Namespace Name: {{TALKSPACE}} in User Namespace

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/magicWords.txt

Shows the {{TALKSPACE}} magic word, which returns the name of the talk namespace corresponding to the current page's namespace. In this case, for a 'User:' page, it returns 'User talk'.

```Wikitext
{{TALKSPACE}}
```

```HTML/PHP
<p>User talk
</p>
```

```HTML/Parsoid
<p><span about="#mwt1" typeof="mw:Transclusion" data-mw='{\"parts\":[{\"template\":{\"target\":{\"wt\":\"TALKSPACE\",\"function\":\"talkspace\"},\"params\":{},\"i\":0}}]}'>User talk</span></p>
```

--------------------------------

### Wikitext Template Expanded Content Wrapping (1d)

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/indentPre.txt

Further demonstrates how preformatting wrapping is based on expanded template content. This test shows alternating `<pre>` and `<p>` blocks depending on the presence of leading spaces in the expanded output across multiple lines.

```wikitext
 {{1x|a
b
c
 d
e
}}
```

```html
<pre>a
</pre>
<p>b
c
</p>
<pre>d
</pre>
<p>e
</p>
```

--------------------------------

### Get Encoded Full Page Name: {{FULLPAGENAMEE}}

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/magicWords.txt

Illustrates the {{FULLPAGENAMEE}} magic word, which returns the URL-encoded full name of the current page, including its namespace. This is useful for creating links or URLs where special characters need to be escaped.

```Wikitext
{{FULLPAGENAMEE}}
```

```HTML/PHP
<p>User:%C3%86var_Arnfj%C3%B6r%C3%B0_Bjarmason
</p>
```

```HTML/Parsoid
<p><span about="#mwt1" typeof="mw:Transclusion" data-mw='{\"parts\":[{\"template\":{\"target\":{\"wt\":\"FULLPAGENAMEE\",\"function\":\"fullpagenamee\"},\"params\":{},\"i\":0}}]}'>User:%C3%86var_Arnfj%C3%B6r%C3%B0_Bjarmason</span></p>
```

--------------------------------

### Timing Metrics for Wikitext to HTML Conversion in Parsoid

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/docs/metrics.md

Documents the performance metrics associated with converting wikitext to various HTML formats, including initialization, parsing, and total transformation time. These metrics apply to all /wikitext/to/$FORMAT endpoints.

```APIDOC
Metric: wt2html.$TYPE.init
Description: Tracks initialization time (object construction before transformation).
Location: Rest/Handler/ParsoidHandler.php
$TYPE: 'wt' (wikitext posted) or 'pageWithOldId' (wikitext fetched).

Metric: wt2html.$TYPE.parse
Description: Tracks transformation time.
Location: Rest/Handler/ParsoidHandler.php
$TYPE: 'wt' (wikitext posted) or 'pageWithOldId' (wikitext fetched).

Metric: wt2html.total
Description: Covers total time to convert wikitext to HTML (pagebundle or otherwise).
Location: Rest/Handler/ParsoidHandler.php
```

--------------------------------

### HTML Embedding of IPv6 URL

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/extLinks.txt

An example of an IPv6 literal address embedded within an HTML anchor tag. This demonstrates how such URLs might appear in web content, potentially processed by tools like Parsoid.

```HTML
<a rel="mw:ExtLink" href="http://[2404:130:0:1000::187:2]/index.php" class="external free">http://[2404:130:0:1000::187:2]/index.php</a>
```

--------------------------------

### Process Nested Annotations with Attributes

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

Shows a scenario with nested annotations (<dummyanno> and <ann2>) and how attributes (like name="myvar") are preserved and rendered in the HTML output as part of the data-mw attribute.

```Wikitext
<dummyanno>Some text
```

--------------------------------

### HTML to Wikitext Conversion for New Redirects

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/redirects.txt

Demonstrates Parsoid's `html2wt` conversion, showing how an HTML `<p>Foo<link rel="mw:PageProp/redirect" href="./Foo"/></p>` element is transformed back into a wikitext `#REDIRECT` statement, potentially with additional text from the HTML.

```HTML
<p>Foo<link rel="mw:PageProp/redirect" href="./Foo"/></p>
```

```Wikitext
#REDIRECT [[Foo]]
Foo
```

--------------------------------

### Generate Unique RangeIds for Two Inline Dummyanno Tags

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/annotationParserTests.txt

This test verifies that multiple inline 'dummyanno' tags within the same wikitext generate distinct 'rangeId' attributes in the resulting HTML, ensuring unique identification for each annotation.

```wikitext
Some inline <dummyanno>text</dummyanno> followed by <dummyanno>some more text</dummyanno> inline
```

```html/parsoid
<p>Some inline <meta typeof="mw:Annotation/dummyanno" data-mw='{"rangeId":"mwa0","extendedRange":false,"wtOffsets":[12,23]}'/>text<meta typeof="mw:Annotation/dummyanno/End" data-mw='{"wtOffsets":[27,39]}'/> followed by <meta typeof="mw:Annotation/dummyanno" data-mw='{"rangeId":"mwa1","extendedRange":false,"wtOffsets":[52,63]}'/>some more text<meta typeof="mw:Annotation/dummyanno/End" data-mw='{"wtOffsets":[77,89]}'/> inline</p>
```

--------------------------------

### Wikitext to HTML Conversion: Indented Definition List

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/definitionLists.txt

Illustrates how wikitext indentation (`:Indented text`) is rendered as an HTML definition list item (`<dl><dd>`), indicating that simple colons at the start of a line create definition list entries.

```Wikitext
:Indented text
```

```HTML
<dl><dd>Indented text</dd></dl>
```

--------------------------------

### Parsoid Redirect: File Page (Image:)

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/redirects.txt

Tests a redirect to an image/file page using the deprecated `Image:` namespace, confirming Parsoid correctly maps it to the `File:` namespace in the HTML output and includes relevant data attributes.

```wikitext
#REDIRECT [[Image:Wiki.png]]
```

```html/parsoid
<link rel="mw:PageProp/redirect" href="./File:Wiki.png"  data-parsoid='{"src":"#REDIRECT ","a":{"href":"./File:Wiki.png"},"sa":{"href":"Image:Wiki.png"}}'/>
```

--------------------------------

### MediaWiki Template Definition: 1x

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/preprocessor.txt

Defines a MediaWiki template named '1x' that accepts a single parameter and outputs its raw value. This template is used in various precedence tests.

```MediaWiki Wikitext
!! article
Template:1x
!! text
{{{1}}}
!! endarticle
```

--------------------------------

### Embed Video with Multiple Transcoded Sources

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/timedMediaHandlerParserTests.txt

Illustrates how MediaWiki handles video transcoding, providing multiple `<source>` elements for different formats and resolutions, as seen in the Parsoid HTML output.

```Wikitext
[[File:Transcode.webm|thumb|Hello]]
```

```HTML
<figure class="mw-default-size"
```

--------------------------------

### Convert internal RFC magic link from Wikitext to HTML

Source: https://github.com/wikimedia/mediawiki-services-parsoid/blob/master/tests/parser/magicLinks.txt

Demonstrates the conversion of an internal RFC link (e.g., [[RFC 123]]) in wikitext to its corresponding HTML representation. This specific example shows a redlink, indicating the target page does not exist.

```Wikitext
[[RFC 123]]
```

```HTML/PHP
<p><a href="/index.php?title=RFC_123&amp;action=edit&amp;redlink=1" class="new" title="RFC 123 (page does not exist)">RFC 123</a>
</p>
```

```HTML/Parsoid
<p><a rel="mw:WikiLink" href="./RFC_123?action=edit&amp;redlink=1" title="RFC 123" class="new" typeof="mw:LocalizedAttrs" data-parsoid='{"stx":"simple","a":{"href":"./RFC_123"},"sa":{"href":"RFC 123"}}' data-mw-i18n='{"title":{"lang":"x-page","key":"red-link-title","params":["RFC 123"]}}'>RFC 123</a></p>
```
Tokens:
Raw