Use sphinx-prompt

.pre-commit-config.yaml

@@ -42,14 +42,14 @@ repos:
   - id: teyit
 
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.5.5
+  rev: v0.5.7
   hooks:
   - id: ruff
     language: system
     exclude: ^(?!pandoc_latex_admonition/)
 
 - repo: https://github.com/psf/black
-  rev: 24.4.2
+  rev: 24.8.0
   hooks:
   - id: black-jupyter
     args: [--config=pyproject.toml, pandoc_latex_admonition/, tests]
@@ -58,7 +58,7 @@ repos:
   rev: v1.1.1
   hooks:
   - id: doc8
-    args: [docs, README.md, -e, .rst, -e, .md]
+    files: \.(rst|md)$
 
 - repo: https://github.com/pre-commit/mirrors-mypy
   rev: v1.11.1
@@ -68,7 +68,7 @@ repos:
     exclude: ^(?!pandoc_latex_admonition/)
 
 - repo: https://github.com/pycqa/flake8
-  rev: 7.1.0
+  rev: 7.1.1
   hooks:
   - id: flake8
     language: system

docs/conf.py

@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 #
 # Configuration file for the Sphinx documentation builder.
 #
@@ -44,7 +43,7 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ["myst_parser"]
+extensions = ["myst_parser", "sphinx_prompt", "sphinx_copybutton"]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = []

docs/usage.rst

@@ -3,9 +3,9 @@ Usage
 
 To apply the filter, use the following option with pandoc:
 
-.. code-block:: shell
+.. prompt:: bash
 
-    $ pandoc --filter pandoc-latex-admonition
+    pandoc --filter pandoc-latex-admonition
 
 Explanation
 -----------