✨ NEW: General improvements

fixtures/blocks.break.md

@@ -0,0 +1,20 @@
+A simple block break:
+.
++++
+.
+<!-- Block Break -->
+.
+
+A block break with metadata:
+.
++++ {"meta": "data"}
+.
+<!-- Block Break -->
+.
+
+A block break with malformed metadata:
+.
++++ {"meta": data}
+.
+<!-- Block Break -->
+.

fixtures/blocks.comment.md

@@ -0,0 +1,28 @@
+A simple comment:
+.
+% A comment
+.
+<!-- A comment -->
+.
+
+A simple comment between two paragraphs:
+.
+Something
+% A comment
+Something else
+.
+<p>Something</p>
+<!-- A comment -->
+<p>Something else</p>
+.
+
+A should sanitize html
+.
+Something
+% A comment --> <script>
+Something else
+.
+<p>Something</p>
+<!-- A comment --&gt; &lt;script&gt; -->
+<p>Something else</p>
+.

fixtures/blocks.target.md

@@ -31,7 +31,7 @@ Reference to a non-existent ID:
 .
 <span id="ref-my_id"></span>
 <h1>My Header</h1>
-<p><span style="background-color:red;" title="No reference 'my_ID' found.">Not There</span></p>
+<p><span class="error" title="The reference 'my_ID' was not found.">Reference 'my_ID' not found.</span></p>
 .
 
 Header with ID and a markdown link:

fixtures/directives.admonitions.md

@@ -0,0 +1,193 @@
+Admonition:
+.
+```{admonition} This is a title
+An example of an admonition with a _title_.
+```
+.
+<aside class="callout note">
+<header>
+This is a title
+</header>
+<p>An example of an admonition with a <em>title</em>.</p>
+</aside>
+.
+
+Note:
+.
+```{note}
+An example of an admonition with a _title_.
+```
+.
+<aside class="callout note">
+<header>
+Note
+</header>
+<p>An example of an admonition with a <em>title</em>.</p>
+</aside>
+.
+
+Note on split lines:
+.
+```{note} An example
+of an admonition on two lines.
+```
+.
+<aside class="callout note">
+<header>
+Note
+</header>
+<p>An example of an admonition on two lines.</p>
+</aside>
+.
+
+[FIX] Note on a single line [See #154](https://github.com/executablebooks/MyST-Parser/issues/154)
+.
+```{danger} An example of an admonition on a single line.
+```
+.
+<aside class="callout danger">
+<header>
+Danger
+</header>
+</aside>
+.
+
+Admonition:
+.
+```{admonition} This is a title
+An example of a general `admonition` with a custom _title_.
+```
+.
+<aside class="callout note">
+<header>
+This is a title
+</header>
+<p>An example of a general <code>admonition</code> with a custom <em>title</em>.</p>
+</aside>
+.
+
+`attention` admonition:
+.
+```{attention}
+An example of a attention admonition.
+```
+.
+<aside class="callout attention">
+<header>
+Attention
+</header>
+<p>An example of a attention admonition.</p>
+</aside>
+.
+
+`caution` admonition:
+.
+```{caution}
+An example of a caution admonition.
+```
+.
+<aside class="callout caution">
+<header>
+Caution
+</header>
+<p>An example of a caution admonition.</p>
+</aside>
+.
+
+`danger` admonition:
+.
+```{danger}
+An example of a danger admonition.
+```
+.
+<aside class="callout danger">
+<header>
+Danger
+</header>
+<p>An example of a danger admonition.</p>
+</aside>
+.
+
+`error` admonition:
+.
+```{error}
+An example of an error admonition.
+```
+.
+<aside class="callout error">
+<header>
+Error
+</header>
+<p>An example of an error admonition.</p>
+</aside>
+.
+
+`hint` admonition:
+.
+```{hint}
+An example of a hint admonition.
+```
+.
+<aside class="callout hint">
+<header>
+Hint
+</header>
+<p>An example of a hint admonition.</p>
+</aside>
+.
+
+`important` admonition:
+.
+```{important}
+An example of an important admonition.
+```
+.
+<aside class="callout important">
+<header>
+Important
+</header>
+<p>An example of an important admonition.</p>
+</aside>
+.
+
+`note` admonition:
+.
+```{note}
+An example of a note admonition.
+```
+.
+<aside class="callout note">
+<header>
+Note
+</header>
+<p>An example of a note admonition.</p>
+</aside>
+.
+
+`tip` admonition:
+.
+```{tip}
+An example of a tip admonition.
+```
+.
+<aside class="callout tip">
+<header>
+Tip
+</header>
+<p>An example of a tip admonition.</p>
+</aside>
+.
+
+`warning` admonition:
+.
+```{warning}
+An example of a warning admonition.
+```
+.
+<aside class="callout warning">
+<header>
+Warning
+</header>
+<p>An example of a warning admonition.</p>
+</aside>
+.

fixtures/directives.figure.md

@@ -0,0 +1,45 @@
+Simple figure:
+.
+```{figure} https://jupyterbook.org/_static/logo.png
+The Jupyter Book Logo!
+```
+.
+<figure id="fig-1" class="numbered">
+<img src="https://jupyterbook.org/_static/logo.png">
+<figcaption number="1">
+<p>The Jupyter Book Logo!</p>
+</figcaption>
+</figure>
+.
+
+Named figure with a caption in a paragraph:
+.
+```{figure} https://jupyterbook.org/_static/logo.png
+:name: test1
+
+The Jupyter Book Logo!
+```
+.
+<figure id="fig-test1" class="numbered">
+<img src="https://jupyterbook.org/_static/logo.png">
+<figcaption number="1">
+
+<p>The Jupyter Book Logo!</p>
+</figcaption>
+</figure>
+.
+
+Named figure with a caption, no space between options:
+.
+```{figure} https://jupyterbook.org/_static/logo.png
+:name: test2
+The Jupyter Book Logo!
+```
+.
+<figure id="fig-test2" class="numbered">
+<img src="https://jupyterbook.org/_static/logo.png">
+<figcaption number="1">
+<p>The Jupyter Book Logo!</p>
+</figcaption>
+</figure>
+.