Use sphinx-prompt

Author: chdemko

.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_codeblock_include/)
 
 - repo: https://github.com/psf/black
-  rev: 24.4.2
+  rev: 24.8.0
   hooks:
   - id: black-jupyter
     args: [--config=pyproject.toml, pandoc_codeblock_include/, tests]
@@ -58,17 +58,17 @@ 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.0
+  rev: v1.11.1
   hooks:
   - id: mypy
     language: system
     exclude: ^(?!pandoc_codeblock_include/)
 
 - repo: https://github.com/pycqa/flake8
-  rev: 7.1.0
+  rev: 7.1.1
   hooks:
   - id: flake8
     language: system

README.md

@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 #
 # Configuration file for the Sphinx documentation builder.
 #
@@ -46,7 +45,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/conf.py

@@ -3,8 +3,8 @@ Usage
 
 To apply the filter, use the following option with pandoc:
 
-~~~shell
-$ pandoc --filter pandoc-codeblock-include
+~~~{prompt} bash
+pandoc --filter pandoc-codeblock-include
 ~~~
 
 Explanation