do not rely on rst parser only

.github/workflows/ci.yml

@@ -33,6 +33,7 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements.txt
+        pip install -r test/unit/requirements.txt
         pip install .
 
     - name: Build Test
@@ -66,6 +67,7 @@ jobs:
         git add . -N && git diff --exit-code
 
     - name: Push Unit Changes
+      if: failure()
       uses: stefanzweifel/git-auto-commit-action@v4
       with:
         branch: ${{ github.head_ref || github.ref_name }}.changes

test/unit/conf.py

@@ -4,14 +4,14 @@
 
 extensions = [
     'sphinxcontrib.phpdomain',
+    'myst_parser',
 ]
 
-source_suffix = '.rst'
+myst_enable_extensions = ['colon_fence']
 
+source_suffix = '.rst'
 master_doc = 'index'
 
 exclude_patterns = ['_build']
 
-pygments_style = 'sphinx'
-
 html_theme = 'default'

test/unit/index.rst → test/unit/index.md

@@ -1,7 +1,9 @@
+```{eval-rst}
 Test: Build all files
 =====================
 
 .. toctree::
    :glob:
 
    **
+```

test/unit/method.rst → test/unit/method.md

@@ -1,5 +1,7 @@
+```{eval-rst}
 .. php:method:: Foo::simplify()
 
     Simplify expression.
 
     :param array $args: Associative array
+```

test/unit/ns.rst → test/unit/ns.md

@@ -1,3 +1,4 @@
+```{eval-rst}
 Simple NS
 =========
 
@@ -61,3 +62,4 @@ Cross linking::
 
 - :php:meth:`X2::simplify`
 - :php:meth:`A2::simplify`
+```

test/unit/requirements.txt

@@ -0,0 +1,2 @@
+sphinx
+myst-parser