markdown-exec 1.12.2__tar.gz → 1.12.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (145) hide show
  1. markdown_exec-1.12.4/AI_POLICY.md +15 -0
  2. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/CHANGELOG.md +27 -0
  3. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/CONTRIBUTING.md +6 -16
  4. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/LICENSE +1 -1
  5. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/PKG-INFO +19 -15
  6. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/README.md +14 -11
  7. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/config/git-changelog.toml +1 -1
  8. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/config/ruff.toml +9 -24
  9. markdown_exec-1.12.4/config/ty.toml +6 -0
  10. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/config/vscode/launch.json +1 -2
  11. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/config/vscode/settings.json +1 -3
  12. markdown_exec-1.12.4/config/zed/debug.json +44 -0
  13. markdown_exec-1.12.4/config/zed/settings.json +43 -0
  14. markdown_exec-1.12.4/config/zed/tasks.json +72 -0
  15. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/.overrides/partials/comments.html +1 -1
  16. markdown_exec-1.12.4/docs/css/apidocs.css +21 -0
  17. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/gallery.md +18 -18
  18. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/matplotlib.py +6 -4
  19. markdown_exec-1.12.4/docs/snippets/gallery/pydeps.py +19 -0
  20. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/usage/index.md +16 -26
  21. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/usage/pyodide.md +15 -35
  22. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/usage/shell.md +2 -2
  23. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/usage/tree.md +8 -0
  24. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/duties.py +85 -46
  25. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/pyproject.toml +11 -16
  26. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/scripts/gen_credits.py +34 -23
  27. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/scripts/get_version.py +18 -0
  28. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/scripts/make.py +36 -10
  29. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/__init__.py +18 -0
  30. markdown_exec-1.12.4/src/markdown_exec/_internal/__init__.py +17 -0
  31. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/debug.py +19 -1
  32. markdown_exec-1.12.4/src/markdown_exec/_internal/formatters/__init__.py +19 -0
  33. markdown_exec-1.12.4/src/markdown_exec/_internal/formatters/_exec_python.py +26 -0
  34. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/formatters/base.py +22 -3
  35. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/formatters/bash.py +18 -0
  36. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/formatters/console.py +18 -0
  37. markdown_exec-1.12.4/src/markdown_exec/_internal/formatters/markdown.py +29 -0
  38. markdown_exec-1.12.4/src/markdown_exec/_internal/formatters/pycon.py +44 -0
  39. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/formatters/pyodide.py +21 -3
  40. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/formatters/python.py +20 -2
  41. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/formatters/sh.py +18 -0
  42. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/formatters/tree.py +30 -4
  43. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/logger.py +22 -1
  44. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/main.py +19 -1
  45. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/mkdocs_plugin.py +20 -2
  46. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/processors.py +20 -2
  47. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/_internal/rendering.py +43 -20
  48. markdown_exec-1.12.4/src/markdown_exec/formatters/__init__.py +35 -0
  49. markdown_exec-1.12.4/src/markdown_exec/formatters/base.py +35 -0
  50. markdown_exec-1.12.4/src/markdown_exec/formatters/bash.py +35 -0
  51. markdown_exec-1.12.4/src/markdown_exec/formatters/console.py +35 -0
  52. markdown_exec-1.12.4/src/markdown_exec/formatters/markdown.py +35 -0
  53. markdown_exec-1.12.4/src/markdown_exec/formatters/pycon.py +35 -0
  54. markdown_exec-1.12.4/src/markdown_exec/formatters/pyodide.py +35 -0
  55. markdown_exec-1.12.4/src/markdown_exec/formatters/python.py +35 -0
  56. markdown_exec-1.12.4/src/markdown_exec/formatters/sh.py +35 -0
  57. markdown_exec-1.12.4/src/markdown_exec/formatters/tree.py +35 -0
  58. markdown_exec-1.12.4/src/markdown_exec/logger.py +35 -0
  59. markdown_exec-1.12.4/src/markdown_exec/mkdocs_plugin.py +35 -0
  60. markdown_exec-1.12.4/src/markdown_exec/processors.py +35 -0
  61. markdown_exec-1.12.4/src/markdown_exec/rendering.py +35 -0
  62. markdown_exec-1.12.4/tests/__init__.py +25 -0
  63. markdown_exec-1.12.4/tests/conftest.py +46 -0
  64. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/tests/test_api.py +26 -7
  65. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/tests/test_base_formatter.py +18 -0
  66. markdown_exec-1.12.4/tests/test_converter.py +128 -0
  67. markdown_exec-1.12.4/tests/test_headings.py +48 -0
  68. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/tests/test_python.py +18 -0
  69. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/tests/test_shell.py +18 -0
  70. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/tests/test_toc.py +24 -6
  71. markdown_exec-1.12.4/tests/test_tree.py +43 -0
  72. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/tests/test_validator.py +18 -0
  73. markdown_exec-1.12.4/zensical.toml +199 -0
  74. markdown_exec-1.12.2/config/mypy.ini +0 -9
  75. markdown_exec-1.12.2/docs/.overrides/partials/path-item.html +0 -22
  76. markdown_exec-1.12.2/docs/css/material.css +0 -4
  77. markdown_exec-1.12.2/docs/css/mkdocstrings.css +0 -72
  78. markdown_exec-1.12.2/docs/snippets/gallery/pydeps.py +0 -43
  79. markdown_exec-1.12.2/mkdocs.yml +0 -187
  80. markdown_exec-1.12.2/src/markdown_exec/_internal/__init__.py +0 -0
  81. markdown_exec-1.12.2/src/markdown_exec/_internal/formatters/__init__.py +0 -1
  82. markdown_exec-1.12.2/src/markdown_exec/_internal/formatters/_exec_python.py +0 -8
  83. markdown_exec-1.12.2/src/markdown_exec/_internal/formatters/markdown.py +0 -11
  84. markdown_exec-1.12.2/src/markdown_exec/_internal/formatters/pycon.py +0 -26
  85. markdown_exec-1.12.2/src/markdown_exec/formatters/__init__.py +0 -17
  86. markdown_exec-1.12.2/src/markdown_exec/formatters/base.py +0 -17
  87. markdown_exec-1.12.2/src/markdown_exec/formatters/bash.py +0 -17
  88. markdown_exec-1.12.2/src/markdown_exec/formatters/console.py +0 -17
  89. markdown_exec-1.12.2/src/markdown_exec/formatters/markdown.py +0 -17
  90. markdown_exec-1.12.2/src/markdown_exec/formatters/pycon.py +0 -17
  91. markdown_exec-1.12.2/src/markdown_exec/formatters/pyodide.py +0 -17
  92. markdown_exec-1.12.2/src/markdown_exec/formatters/python.py +0 -17
  93. markdown_exec-1.12.2/src/markdown_exec/formatters/sh.py +0 -17
  94. markdown_exec-1.12.2/src/markdown_exec/formatters/tree.py +0 -17
  95. markdown_exec-1.12.2/src/markdown_exec/logger.py +0 -17
  96. markdown_exec-1.12.2/src/markdown_exec/mkdocs_plugin.py +0 -17
  97. markdown_exec-1.12.2/src/markdown_exec/processors.py +0 -17
  98. markdown_exec-1.12.2/src/markdown_exec/rendering.py +0 -17
  99. markdown_exec-1.12.2/tests/__init__.py +0 -7
  100. markdown_exec-1.12.2/tests/conftest.py +0 -28
  101. markdown_exec-1.12.2/tests/test_converter.py +0 -76
  102. markdown_exec-1.12.2/tests/test_headings.py +0 -30
  103. markdown_exec-1.12.2/tests/test_tree.py +0 -25
  104. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/CODE_OF_CONDUCT.md +0 -0
  105. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/config/coverage.ini +0 -0
  106. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/config/pytest.ini +0 -0
  107. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/config/vscode/tasks.json +0 -0
  108. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/.overrides/main.html +0 -0
  109. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/changelog.md +0 -0
  110. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/code_of_conduct.md +0 -0
  111. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/contributing.md +0 -0
  112. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/credits.md +0 -0
  113. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/index.md +0 -0
  114. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/js/feedback.js +0 -0
  115. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/license.md +0 -0
  116. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/reference/api.md +0 -0
  117. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/schema.json +0 -0
  118. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/ansi.sh +0 -0
  119. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/argparse.py +0 -0
  120. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/argparse_format.py +0 -0
  121. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/chalk.py +0 -0
  122. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/d2.py +0 -0
  123. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/diagrams.py +0 -0
  124. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/drawsvg.py +0 -0
  125. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/expandable_filetree.py +0 -0
  126. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/hyperbolic.py +0 -0
  127. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/plotly.py +0 -0
  128. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/qrcode.py +0 -0
  129. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/rich.py +0 -0
  130. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/rich_terminal.py +0 -0
  131. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/runpy.py +0 -0
  132. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/gallery/textual.py +0 -0
  133. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/usage/boolean_matrix.py +0 -0
  134. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/usage/hide.py +0 -0
  135. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/usage/multiple.pycon +0 -0
  136. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/usage/platform_html.py +0 -0
  137. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/usage/platform_md.py +0 -0
  138. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/usage/source.py +0 -0
  139. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/snippets/usage/source.pycon +0 -0
  140. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/docs/usage/python.md +0 -0
  141. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/scripts/make +0 -0
  142. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/assets/ansi.css +0 -0
  143. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/assets/pyodide.css +0 -0
  144. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/assets/pyodide.js +0 -0
  145. {markdown_exec-1.12.2 → markdown_exec-1.12.4}/src/markdown_exec/py.typed +0 -0
@@ -0,0 +1,15 @@
1
+ # AI Contribution Policy
2
+
3
+ We accept AI-*assisted* contributions, both for code and documentation, with the following expectations:
4
+
5
+ - AI-assisted contributions must disclaim their use of AI.
6
+ - Contributors must fully understand the proposed changes and be able to explain why they are the correct approach.
7
+ - Issues must be created before creating pull requests (unless there is already a relevant issue).
8
+ - Issue and pull request templates must be followed.
9
+ - Comments (including bodies) in issues and pull requests must be written by humans. If you use LLMs to translate from one language to another, please include your original comment and the translated one.
10
+ - Git commits must be authored by humans, not AI/bot accounts or identities.
11
+ - Git commit messages must be written by humans, in English. If you cannot write English, please state so in the pull request body and we will write the commit messages ourselves.
12
+
13
+ Failure to comply with any of these requirements will result in issues or pull requests being closed immediately without comment. Repeated violations of this policy will result in a ban of the offending accounts/identities from contributing to this project and any related project from the same author/organization.
14
+
15
+ We do not accept AI-generated content in community spaces we maintain or moderate, such as GitHub discussions or Matrix rooms.
@@ -5,6 +5,33 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
5
5
  and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  <!-- insertion marker -->
8
+ ## [1.12.4](https://github.com/pawamoy/markdown-exec/releases/tag/1.12.4) - 2026-10-06
9
+
10
+ <small>[Compare with 1.12.3](https://github.com/pawamoy/markdown-exec/compare/1.12.3...1.12.4)</small>
11
+
12
+ ### Build
13
+
14
+ - Drop support for Python 3.10 ([9bfb0c7](https://github.com/pawamoy/markdown-exec/commit/9bfb0c74c5b704fdd88e9ad9a4d1dc316c2ea963) by Timothée Mazzucotelli).
15
+
16
+ ### Bug Fixes
17
+
18
+ - Don't propagate Zensical's preview extension, which requires its zrelpath processor ([c2f3e0b](https://github.com/pawamoy/markdown-exec/commit/c2f3e0b6070d19ffca96f9c2d3992a9f18e00001) by Timothée Mazzucotelli).
19
+ - Declare markupsafe as a dependency ([a8f4330](https://github.com/pawamoy/markdown-exec/commit/a8f43303f3bf2c63d337091d36b1e1e53f88b3fc) by Kayvan Zahiri). [Issue-94](https://github.com/pawamoy/markdown-exec/issues/94), [PR-102](https://github.com/pawamoy/markdown-exec/pull/102)
20
+ - Prevent mutating original registered extensions list ([3866f5e](https://github.com/pawamoy/markdown-exec/commit/3866f5e242de5e285219440a10ed58ac7eb996cd) by Timothée Mazzucotelli).
21
+
22
+ ## [1.12.3](https://github.com/pawamoy/markdown-exec/releases/tag/1.12.3) - 2026-07-07
23
+
24
+ <small>[Compare with 1.12.2](https://github.com/pawamoy/markdown-exec/compare/1.12.2...1.12.3)</small>
25
+
26
+ ### Bug Fixes
27
+
28
+ - Provide Pyodide options to Zensical ([abcb044](https://github.com/pawamoy/markdown-exec/commit/abcb0443751d4871968d20bddf66b0b4a9d45620) by Timothée Mazzucotelli). [Issue-100](https://github.com/pawamoy/markdown-exec/issues/100)
29
+
30
+ ### Code Refactoring
31
+
32
+ - Rename material-block source display option to block ([2cefa97](https://github.com/pawamoy/markdown-exec/commit/2cefa97a3ee918cf009afda0fa881286c92626b9) by Timothée Mazzucotelli).
33
+ - Update Pyodide hardcoded version to 314.0.2 ([eef2661](https://github.com/pawamoy/markdown-exec/commit/eef2661d878f9e13cbd3d923edba21037e478c41) by Timothée Mazzucotelli).
34
+
8
35
  ## [1.12.2](https://github.com/pawamoy/markdown-exec/releases/tag/1.12.2) - 2026-07-05
9
36
 
10
37
  <small>[Compare with 1.12.1](https://github.com/pawamoy/markdown-exec/compare/1.12.1...1.12.2)</small>
@@ -1,36 +1,26 @@
1
1
  # Contributing
2
2
 
3
- Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.
3
+ Contributions are welcome, and they are greatly appreciated. Every little bit helps, and credit will always be given.
4
4
 
5
- ## Environment setup
5
+ **Please always create an issue before working on a new feature or a bug fix, so that we can discuss the implementation and make sure that your work will be merged.**
6
6
 
7
- Nothing easier!
7
+ ## Environment setup
8
8
 
9
- Fork and clone the repository, then:
9
+ Install [uv](https://github.com/astral-sh/uv) and [direnv](https://direnv.net/), fork and clone the repository, then:
10
10
 
11
11
  ```bash
12
12
  cd markdown-exec
13
+ direnv allow
13
14
  make setup
14
15
  ```
15
16
 
16
- > NOTE: If it fails for some reason, you'll need to install [uv](https://github.com/astral-sh/uv) manually.
17
- >
18
- > You can install it with:
19
- >
20
- > ```bash
21
- > curl -LsSf https://astral.sh/uv/install.sh | sh
22
- > ```
23
- >
24
- > Now you can try running `make setup` again, or simply `uv sync`.
25
-
26
17
  You now have the dependencies installed.
27
18
 
28
19
  Run `make help` to see all the available actions!
29
20
 
30
21
  ## Tasks
31
22
 
32
- The entry-point to run commands and tasks is the `make` Python script, located in the `scripts` directory. Try running `make` to show the available commands and tasks. The *commands* do not need the Python dependencies to be installed,
33
- while the *tasks* do. The cross-platform tasks are written in Python, thanks to [duty](https://github.com/pawamoy/duty).
23
+ The entry-point to run commands and tasks is the `make` Python script, located in the `scripts` directory. Try running `make` to show the available commands and tasks. The *commands* do not need the Python dependencies to be installed, while the *tasks* do. The cross-platform tasks are written in Python, thanks to [duty](https://github.com/pawamoy/duty).
34
24
 
35
25
  If you work in VSCode, we provide [an action to configure VSCode](https://pawamoy.github.io/copier-uv/work/#vscode-setup) for the project.
36
26
 
@@ -1,6 +1,6 @@
1
1
  ISC License
2
2
 
3
- Copyright (c) 2022, Timothée Mazzucotelli
3
+ Copyright (c) 2022, Timothée Mazzucotelli and contributors
4
4
 
5
5
  Permission to use, copy, modify, and/or distribute this software for any
6
6
  purpose with or without fee is hereby granted, provided that the above
@@ -1,9 +1,9 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: markdown-exec
3
- Version: 1.12.2
3
+ Version: 1.12.4
4
4
  Summary: Utilities to execute code blocks in Markdown files.
5
5
  Keywords: markdown,python,exec,shell,bash,mkdocs
6
- Author-Email: =?utf-8?q?Timoth=C3=A9e_Mazzucotelli?= <dev@pawamoy.fr>
6
+ Author-Email: Timothée Mazzucotelli <dev@pawamoy.fr>
7
7
  License-Expression: ISC
8
8
  License-File: LICENSE
9
9
  Classifier: Development Status :: 4 - Beta
@@ -11,11 +11,11 @@ Classifier: Intended Audience :: Developers
11
11
  Classifier: Programming Language :: Python
12
12
  Classifier: Programming Language :: Python :: 3
13
13
  Classifier: Programming Language :: Python :: 3 :: Only
14
- Classifier: Programming Language :: Python :: 3.10
15
14
  Classifier: Programming Language :: Python :: 3.11
16
15
  Classifier: Programming Language :: Python :: 3.12
17
16
  Classifier: Programming Language :: Python :: 3.13
18
17
  Classifier: Programming Language :: Python :: 3.14
18
+ Classifier: Programming Language :: Python :: 3.15
19
19
  Classifier: Topic :: Documentation
20
20
  Classifier: Topic :: Software Development
21
21
  Classifier: Topic :: Utilities
@@ -28,7 +28,8 @@ Project-URL: Issues, https://github.com/pawamoy/markdown-exec/issues
28
28
  Project-URL: Discussions, https://github.com/pawamoy/markdown-exec/discussions
29
29
  Project-URL: Gitter, https://gitter.im/markdown-exec/community
30
30
  Project-URL: Funding, https://github.com/sponsors/pawamoy
31
- Requires-Python: >=3.10
31
+ Requires-Python: >=3.11
32
+ Requires-Dist: markupsafe>=2
32
33
  Requires-Dist: pymdown-extensions>=9
33
34
  Provides-Extra: ansi
34
35
  Requires-Dist: pygments-ansi-color>=0.3; extra == "ansi"
@@ -37,15 +38,14 @@ Description-Content-Type: text/markdown
37
38
  # Markdown Exec
38
39
 
39
40
  [![ci](https://github.com/pawamoy/markdown-exec/workflows/ci/badge.svg)](https://github.com/pawamoy/markdown-exec/actions?query=workflow%3Aci)
40
- [![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/markdown-exec/)
41
+ [![documentation](https://img.shields.io/badge/docs-zensical-FF9100.svg?style=flat)](https://pawamoy.github.io/markdown-exec/)
41
42
  [![pypi version](https://img.shields.io/pypi/v/markdown-exec.svg)](https://pypi.org/project/markdown-exec/)
42
43
  [![gitter](https://img.shields.io/badge/matrix-chat-4DB798.svg?style=flat)](https://app.gitter.im/#/room/#markdown-exec:gitter.im)
43
44
  [![radicle](https://img.shields.io/badge/rad-clone-6666FF.svg?style=flat)](https://app.radicle.at/nodes/seed.radicle.at/rad:z77aiLJkzYXtuNpZuvizfGkDuZbQ)
44
45
 
45
46
  Utilities to execute code blocks in Markdown files.
46
47
 
47
- For example, you write a Python code block that computes some HTML,
48
- and this HTML is injected in place of the code block.
48
+ For example, you write a Python code block that computes some HTML, and this HTML is injected in place of the code block.
49
49
 
50
50
  ## Installation
51
51
 
@@ -118,13 +118,19 @@ markdown_extensions:
118
118
  - pymdownx.superfences
119
119
  ```
120
120
 
121
+ ...or in Zensical configuration file, as a legacy plugin:
122
+
123
+ ```toml
124
+ [project.plugins.markdown-exec]
125
+ ```
126
+
121
127
  TIP: We recommend enabling Markdown Exec with the MkDocs plugin
122
- if you are using MkDocs: it will take care of adding relevant
128
+ if you are using MkDocs/Zensical: it will take care of adding relevant
123
129
  assets (CSS/JS) to the final site when needed.
124
130
 
125
- WARNING: **Limitation of configuration through Markdown/PyMDown.**
126
- Configuration through `pymdownx.superfences` directly is not well supported for fences that require assets inclusion, like `pyodide`.
127
- For these you will have to include the assets manually. In the future we will provide ways to include them automatically.
131
+ WARNING: **Limitation of configuration through Markdown/PyMDown for MkDocs.**
132
+ Configuration through `pymdownx.superfences` directly is not well supported within MkDocs for fences that require assets inclusion, like `pyodide`.
133
+ For these you will have to include the assets manually. In the future we will provide ways to include them automatically. In Zensical these assets are provided natively.
128
134
 
129
135
  ## Usage
130
136
 
@@ -180,7 +186,7 @@ and the [gallery](https://pawamoy.github.io/markdown-exec/gallery/) for more exa
180
186
  <a href="https://github.com/BenHammersley"><img alt="BenHammersley" src="https://avatars.githubusercontent.com/u/99436?u=4499a7b507541045222ee28ae122dbe3c8d08ab5&v=4" style="height: 32px; border-radius: 100%;"></a>
181
187
  <a href="https://github.com/trevorWieland"><img alt="trevorWieland" src="https://avatars.githubusercontent.com/u/28811461?u=74cc0e3756c1d4e3d66b5c396e1d131ea8a10472&v=4" style="height: 32px; border-radius: 100%;"></a>
182
188
  <a href="https://github.com/MarcoGorelli"><img alt="MarcoGorelli" src="https://avatars.githubusercontent.com/u/33491632?u=7de3a749cac76a60baca9777baf71d043a4f884d&v=4" style="height: 32px; border-radius: 100%;"></a>
183
- <a href="https://github.com/analog-cbarber"><img alt="analog-cbarber" src="https://avatars.githubusercontent.com/u/7408243?u=642fc2bdcc9904089c62fe5aec4e03ace32da67d&v=4" style="height: 32px; border-radius: 100%;"></a>
189
+ <a href="https://github.com/analog-cbarber"><img alt="analog-cbarber" src="https://avatars.githubusercontent.com/u/7408243?u=fe0e7bf2882d1c9c901a341c2502e1518466527a&v=4" style="height: 32px; border-radius: 100%;"></a>
184
190
  <a href="https://github.com/OdinManiac"><img alt="OdinManiac" src="https://avatars.githubusercontent.com/u/22727172?u=36ab20970f7f52ae8e7eb67b7fcf491fee01ac22&v=4" style="height: 32px; border-radius: 100%;"></a>
185
191
  <a href="https://github.com/rstudio-sponsorship"><img alt="rstudio-sponsorship" src="https://avatars.githubusercontent.com/u/58949051?u=0c471515dd18111be30dfb7669ed5e778970959b&v=4" style="height: 32px; border-radius: 100%;"></a>
186
192
  <a href="https://github.com/schlich"><img alt="schlich" src="https://avatars.githubusercontent.com/u/21191435?u=6f1240adb68f21614d809ae52d66509f46b1e877&v=4" style="height: 32px; border-radius: 100%;"></a>
@@ -192,17 +198,15 @@ and the [gallery](https://pawamoy.github.io/markdown-exec/gallery/) for more exa
192
198
  <a href="https://github.com/activeloopai"><img alt="activeloopai" src="https://avatars.githubusercontent.com/u/34816118?v=4" style="height: 32px; border-radius: 100%;"></a>
193
199
  <a href="https://github.com/roboflow"><img alt="roboflow" src="https://avatars.githubusercontent.com/u/53104118?v=4" style="height: 32px; border-radius: 100%;"></a>
194
200
  <a href="https://github.com/cmclaughlin"><img alt="cmclaughlin" src="https://avatars.githubusercontent.com/u/1061109?u=ddf6eec0edd2d11c980f8c3aa96e3d044d4e0468&v=4" style="height: 32px; border-radius: 100%;"></a>
195
- <a href="https://github.com/blaisep"><img alt="blaisep" src="https://avatars.githubusercontent.com/u/254456?u=97d584b7c0a6faf583aa59975df4f993f671d121&v=4" style="height: 32px; border-radius: 100%;"></a>
196
201
  <a href="https://github.com/RapidataAI"><img alt="RapidataAI" src="https://avatars.githubusercontent.com/u/104209891?v=4" style="height: 32px; border-radius: 100%;"></a>
197
202
  <a href="https://github.com/rodolphebarbanneau"><img alt="rodolphebarbanneau" src="https://avatars.githubusercontent.com/u/46493454?u=6c405452a40c231cdf0b68e97544e07ee956a733&v=4" style="height: 32px; border-radius: 100%;"></a>
198
203
  <a href="https://github.com/theSymbolSyndicate"><img alt="theSymbolSyndicate" src="https://avatars.githubusercontent.com/u/111542255?v=4" style="height: 32px; border-radius: 100%;"></a>
199
204
  <a href="https://github.com/blakeNaccarato"><img alt="blakeNaccarato" src="https://avatars.githubusercontent.com/u/20692450?u=bb919218be30cfa994514f4cf39bb2f7cf952df4&v=4" style="height: 32px; border-radius: 100%;"></a>
200
205
  <a href="https://github.com/ChargeStorm"><img alt="ChargeStorm" src="https://avatars.githubusercontent.com/u/26000165?v=4" style="height: 32px; border-radius: 100%;"></a>
201
- <a href="https://github.com/Alphadelta14"><img alt="Alphadelta14" src="https://avatars.githubusercontent.com/u/480845?v=4" style="height: 32px; border-radius: 100%;"></a>
202
206
  <a href="https://github.com/Cusp-AI"><img alt="Cusp-AI" src="https://avatars.githubusercontent.com/u/178170649?v=4" style="height: 32px; border-radius: 100%;"></a>
203
207
  </p></div>
204
208
 
205
209
 
206
- *And 7 more private sponsor(s).*
210
+ *And 4 more private sponsor(s).*
207
211
 
208
212
  <!-- sponsors-end -->
@@ -1,15 +1,14 @@
1
1
  # Markdown Exec
2
2
 
3
3
  [![ci](https://github.com/pawamoy/markdown-exec/workflows/ci/badge.svg)](https://github.com/pawamoy/markdown-exec/actions?query=workflow%3Aci)
4
- [![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/markdown-exec/)
4
+ [![documentation](https://img.shields.io/badge/docs-zensical-FF9100.svg?style=flat)](https://pawamoy.github.io/markdown-exec/)
5
5
  [![pypi version](https://img.shields.io/pypi/v/markdown-exec.svg)](https://pypi.org/project/markdown-exec/)
6
6
  [![gitter](https://img.shields.io/badge/matrix-chat-4DB798.svg?style=flat)](https://app.gitter.im/#/room/#markdown-exec:gitter.im)
7
7
  [![radicle](https://img.shields.io/badge/rad-clone-6666FF.svg?style=flat)](https://app.radicle.at/nodes/seed.radicle.at/rad:z77aiLJkzYXtuNpZuvizfGkDuZbQ)
8
8
 
9
9
  Utilities to execute code blocks in Markdown files.
10
10
 
11
- For example, you write a Python code block that computes some HTML,
12
- and this HTML is injected in place of the code block.
11
+ For example, you write a Python code block that computes some HTML, and this HTML is injected in place of the code block.
13
12
 
14
13
  ## Installation
15
14
 
@@ -82,13 +81,19 @@ markdown_extensions:
82
81
  - pymdownx.superfences
83
82
  ```
84
83
 
84
+ ...or in Zensical configuration file, as a legacy plugin:
85
+
86
+ ```toml
87
+ [project.plugins.markdown-exec]
88
+ ```
89
+
85
90
  TIP: We recommend enabling Markdown Exec with the MkDocs plugin
86
- if you are using MkDocs: it will take care of adding relevant
91
+ if you are using MkDocs/Zensical: it will take care of adding relevant
87
92
  assets (CSS/JS) to the final site when needed.
88
93
 
89
- WARNING: **Limitation of configuration through Markdown/PyMDown.**
90
- Configuration through `pymdownx.superfences` directly is not well supported for fences that require assets inclusion, like `pyodide`.
91
- For these you will have to include the assets manually. In the future we will provide ways to include them automatically.
94
+ WARNING: **Limitation of configuration through Markdown/PyMDown for MkDocs.**
95
+ Configuration through `pymdownx.superfences` directly is not well supported within MkDocs for fences that require assets inclusion, like `pyodide`.
96
+ For these you will have to include the assets manually. In the future we will provide ways to include them automatically. In Zensical these assets are provided natively.
92
97
 
93
98
  ## Usage
94
99
 
@@ -144,7 +149,7 @@ and the [gallery](https://pawamoy.github.io/markdown-exec/gallery/) for more exa
144
149
  <a href="https://github.com/BenHammersley"><img alt="BenHammersley" src="https://avatars.githubusercontent.com/u/99436?u=4499a7b507541045222ee28ae122dbe3c8d08ab5&v=4" style="height: 32px; border-radius: 100%;"></a>
145
150
  <a href="https://github.com/trevorWieland"><img alt="trevorWieland" src="https://avatars.githubusercontent.com/u/28811461?u=74cc0e3756c1d4e3d66b5c396e1d131ea8a10472&v=4" style="height: 32px; border-radius: 100%;"></a>
146
151
  <a href="https://github.com/MarcoGorelli"><img alt="MarcoGorelli" src="https://avatars.githubusercontent.com/u/33491632?u=7de3a749cac76a60baca9777baf71d043a4f884d&v=4" style="height: 32px; border-radius: 100%;"></a>
147
- <a href="https://github.com/analog-cbarber"><img alt="analog-cbarber" src="https://avatars.githubusercontent.com/u/7408243?u=642fc2bdcc9904089c62fe5aec4e03ace32da67d&v=4" style="height: 32px; border-radius: 100%;"></a>
152
+ <a href="https://github.com/analog-cbarber"><img alt="analog-cbarber" src="https://avatars.githubusercontent.com/u/7408243?u=fe0e7bf2882d1c9c901a341c2502e1518466527a&v=4" style="height: 32px; border-radius: 100%;"></a>
148
153
  <a href="https://github.com/OdinManiac"><img alt="OdinManiac" src="https://avatars.githubusercontent.com/u/22727172?u=36ab20970f7f52ae8e7eb67b7fcf491fee01ac22&v=4" style="height: 32px; border-radius: 100%;"></a>
149
154
  <a href="https://github.com/rstudio-sponsorship"><img alt="rstudio-sponsorship" src="https://avatars.githubusercontent.com/u/58949051?u=0c471515dd18111be30dfb7669ed5e778970959b&v=4" style="height: 32px; border-radius: 100%;"></a>
150
155
  <a href="https://github.com/schlich"><img alt="schlich" src="https://avatars.githubusercontent.com/u/21191435?u=6f1240adb68f21614d809ae52d66509f46b1e877&v=4" style="height: 32px; border-radius: 100%;"></a>
@@ -156,17 +161,15 @@ and the [gallery](https://pawamoy.github.io/markdown-exec/gallery/) for more exa
156
161
  <a href="https://github.com/activeloopai"><img alt="activeloopai" src="https://avatars.githubusercontent.com/u/34816118?v=4" style="height: 32px; border-radius: 100%;"></a>
157
162
  <a href="https://github.com/roboflow"><img alt="roboflow" src="https://avatars.githubusercontent.com/u/53104118?v=4" style="height: 32px; border-radius: 100%;"></a>
158
163
  <a href="https://github.com/cmclaughlin"><img alt="cmclaughlin" src="https://avatars.githubusercontent.com/u/1061109?u=ddf6eec0edd2d11c980f8c3aa96e3d044d4e0468&v=4" style="height: 32px; border-radius: 100%;"></a>
159
- <a href="https://github.com/blaisep"><img alt="blaisep" src="https://avatars.githubusercontent.com/u/254456?u=97d584b7c0a6faf583aa59975df4f993f671d121&v=4" style="height: 32px; border-radius: 100%;"></a>
160
164
  <a href="https://github.com/RapidataAI"><img alt="RapidataAI" src="https://avatars.githubusercontent.com/u/104209891?v=4" style="height: 32px; border-radius: 100%;"></a>
161
165
  <a href="https://github.com/rodolphebarbanneau"><img alt="rodolphebarbanneau" src="https://avatars.githubusercontent.com/u/46493454?u=6c405452a40c231cdf0b68e97544e07ee956a733&v=4" style="height: 32px; border-radius: 100%;"></a>
162
166
  <a href="https://github.com/theSymbolSyndicate"><img alt="theSymbolSyndicate" src="https://avatars.githubusercontent.com/u/111542255?v=4" style="height: 32px; border-radius: 100%;"></a>
163
167
  <a href="https://github.com/blakeNaccarato"><img alt="blakeNaccarato" src="https://avatars.githubusercontent.com/u/20692450?u=bb919218be30cfa994514f4cf39bb2f7cf952df4&v=4" style="height: 32px; border-radius: 100%;"></a>
164
168
  <a href="https://github.com/ChargeStorm"><img alt="ChargeStorm" src="https://avatars.githubusercontent.com/u/26000165?v=4" style="height: 32px; border-radius: 100%;"></a>
165
- <a href="https://github.com/Alphadelta14"><img alt="Alphadelta14" src="https://avatars.githubusercontent.com/u/480845?v=4" style="height: 32px; border-radius: 100%;"></a>
166
169
  <a href="https://github.com/Cusp-AI"><img alt="Cusp-AI" src="https://avatars.githubusercontent.com/u/178170649?v=4" style="height: 32px; border-radius: 100%;"></a>
167
170
  </p></div>
168
171
 
169
172
 
170
- *And 7 more private sponsor(s).*
173
+ *And 4 more private sponsor(s).*
171
174
 
172
175
  <!-- sponsors-end -->
@@ -4,6 +4,6 @@ in-place = true
4
4
  output = "CHANGELOG.md"
5
5
  parse-refs = false
6
6
  parse-trailers = true
7
- sections = ["build", "deps", "feat", "fix", "refactor"]
7
+ sections = ["build", "deps", "feat", "fix", "perf", "refactor"]
8
8
  template = "keepachangelog"
9
9
  versioning = "pep440"
@@ -1,34 +1,14 @@
1
- target-version = "py39"
1
+ target-version = "py311"
2
2
  line-length = 120
3
+ output-format = "concise"
3
4
 
4
5
  [lint]
5
6
  exclude = [
6
7
  "tests/fixtures/*.py",
7
8
  ]
8
- select = [
9
- "A", "ANN", "ARG",
10
- "B", "BLE",
11
- "C", "C4",
12
- "COM",
13
- "D", "DTZ",
14
- "E", "ERA", "EXE",
15
- "F", "FBT",
16
- "G",
17
- "I", "ICN", "INP", "ISC",
18
- "N",
19
- "PGH", "PIE", "PL", "PLC", "PLE", "PLR", "PLW", "PT", "PYI",
20
- "Q",
21
- "RUF", "RSE", "RET",
22
- "S", "SIM", "SLF",
23
- "T", "T10", "T20", "TCH", "TID", "TRY",
24
- "UP",
25
- "W",
26
- "YTT",
27
- ]
9
+ select = ["ALL"]
28
10
  ignore = [
29
11
  "A001", # Variable is shadowing a Python builtin
30
- "ANN101", # Missing type annotation for self
31
- "ANN102", # Missing type annotation for cls
32
12
  "ANN204", # Missing return type annotation for special method __str__
33
13
  "ANN401", # Dynamically typed expressions (typing.Any) are disallowed
34
14
  "ARG005", # Unused lambda argument
@@ -36,13 +16,18 @@ ignore = [
36
16
  "D105", # Missing docstring in magic method
37
17
  "D417", # Missing argument description in the docstring
38
18
  "E501", # Line too long
19
+ "EM101", # String literal when raising exception
20
+ "EM102", # f-string when raising exception
39
21
  "ERA001", # Commented out code
22
+ "FIX", # TODO, FIXME, etc.
40
23
  "G004", # Logging statement uses f-string
41
24
  "PLR0911", # Too many return statements
42
25
  "PLR0912", # Too many branches
43
26
  "PLR0913", # Too many arguments to function call
44
27
  "PLR0915", # Too many statements
45
- "SLF001", # Private member accessed
28
+ "SLF001", # Private member accessed
29
+ "TD002", # Missing author in TODO
30
+ "TD003", # Missing issue link for TODO
46
31
  "TRY003", # Avoid specifying long messages outside the exception class
47
32
  ]
48
33
 
@@ -0,0 +1,6 @@
1
+ [src]
2
+ exclude = ["tests/fixtures"]
3
+
4
+ [terminal]
5
+ error-on-warning = true
6
+ output-format = "concise"
@@ -23,11 +23,10 @@
23
23
  "name": "docs",
24
24
  "type": "debugpy",
25
25
  "request": "launch",
26
- "module": "mkdocs",
26
+ "module": "zensical",
27
27
  "justMyCode": false,
28
28
  "args": [
29
29
  "serve",
30
- "-v"
31
30
  ]
32
31
  },
33
32
  {
@@ -4,9 +4,6 @@
4
4
  "**/.venvs*/**": true,
5
5
  "**/venv*/**": true
6
6
  },
7
- "mypy-type-checker.args": [
8
- "--config-file=config/mypy.ini"
9
- ],
10
7
  "python.testing.unittestEnabled": false,
11
8
  "python.testing.pytestEnabled": true,
12
9
  "python.testing.pytestArgs": [
@@ -19,6 +16,7 @@
19
16
  "ruff.lint.args": [
20
17
  "--config=config/ruff.toml"
21
18
  ],
19
+ "ty.configurationFile": "config/ty.toml",
22
20
  "yaml.schemas": {
23
21
  "https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml"
24
22
  },
@@ -0,0 +1,44 @@
1
+ // Project-local debug tasks
2
+ //
3
+ // For more documentation on how to configure debug tasks,
4
+ // see: https://zed.dev/docs/debugger
5
+ [
6
+ {
7
+ "label": "python (current file)",
8
+ "adapter": "Debugpy",
9
+ "request": "launch",
10
+ "program": "$ZED_FILE",
11
+ "justMyCode": false
12
+ },
13
+ {
14
+ "label": "run",
15
+ "adapter": "Debugpy",
16
+ "request": "launch",
17
+ "module": "markdown_exec",
18
+ "justMyCode": false
19
+ },
20
+ {
21
+ "label": "docs",
22
+ "adapter": "Debugpy",
23
+ "request": "launch",
24
+ "module": "zensical",
25
+ "args": [
26
+ "serve"
27
+ ],
28
+ "justMyCode": false
29
+ },
30
+ {
31
+ "label": "test",
32
+ "adapter": "Debugpy",
33
+ "request": "launch",
34
+ "module": "pytest",
35
+ "args": [
36
+ "-c=config/pytest.ini",
37
+ "-vvv",
38
+ "--no-cov",
39
+ "--dist=no",
40
+ "tests"
41
+ ],
42
+ "justMyCode": false
43
+ }
44
+ ]
@@ -0,0 +1,43 @@
1
+ // Zed settings
2
+ //
3
+ // For information on how to configure Zed, see the Zed
4
+ // documentation: https://zed.dev/docs/configuring-zed
5
+ //
6
+ // To see all of Zed's default settings without changing your
7
+ // custom settings, run `zed: open default settings` from the
8
+ // command palette (cmd-shift-p / ctrl-shift-p)
9
+ {
10
+ "languages": {
11
+ "YAML": {
12
+ "auto_indent_on_paste": false,
13
+ "auto_indent": "preserve_indent",
14
+ "format_on_save": "off"
15
+ },
16
+ "Python": {
17
+ "language_servers": ["ty", "ruff"],
18
+ "code_actions_on_format": {
19
+ "source.organizeImports.ruff": true
20
+ },
21
+ "formatter": {
22
+ "language_server": {
23
+ "name": "ruff"
24
+ }
25
+ }
26
+ }
27
+ },
28
+ "lsp": {
29
+ "ty": {
30
+ "settings": {
31
+ "configurationFile": "config/ty.toml"
32
+ }
33
+ },
34
+ "ruff": {
35
+ "initialization_options": {
36
+ "settings": {
37
+ "configurationPreference": "filesystemFirst",
38
+ "configuration": "config/ruff.toml"
39
+ }
40
+ }
41
+ }
42
+ }
43
+ }
@@ -0,0 +1,72 @@
1
+ [
2
+ {
3
+ "label": "changelog",
4
+ "command": "scripts/make",
5
+ "args": ["changelog"]
6
+ },
7
+ {
8
+ "label": "check",
9
+ "command": "scripts/make",
10
+ "args": ["check"]
11
+ },
12
+ {
13
+ "label": "check-quality",
14
+ "command": "scripts/make",
15
+ "args": ["check-quality"]
16
+ },
17
+ {
18
+ "label": "check-types",
19
+ "command": "scripts/make",
20
+ "args": ["check-types"]
21
+ },
22
+ {
23
+ "label": "check-docs",
24
+ "command": "scripts/make",
25
+ "args": ["check-docs"]
26
+ },
27
+ {
28
+ "label": "check-api",
29
+ "command": "scripts/make",
30
+ "args": ["check-api"]
31
+ },
32
+ {
33
+ "label": "clean",
34
+ "command": "scripts/make",
35
+ "args": ["clean"]
36
+ },
37
+ {
38
+ "label": "docs",
39
+ "command": "scripts/make",
40
+ "args": ["docs"]
41
+ },
42
+ {
43
+ "label": "docs-deploy",
44
+ "command": "scripts/make",
45
+ "args": ["docs-deploy"]
46
+ },
47
+ {
48
+ "label": "format",
49
+ "command": "scripts/make",
50
+ "args": ["format"]
51
+ },
52
+ {
53
+ "label": "release",
54
+ "command": "scripts/make",
55
+ "args": ["release"]
56
+ },
57
+ {
58
+ "label": "setup",
59
+ "command": "scripts/make",
60
+ "args": ["setup"]
61
+ },
62
+ {
63
+ "label": "test",
64
+ "command": "scripts/make",
65
+ "args": ["test", "coverage"]
66
+ },
67
+ {
68
+ "label": "vscode",
69
+ "command": "scripts/make",
70
+ "args": ["vscode"]
71
+ }
72
+ ]
@@ -1,5 +1,5 @@
1
1
  <!-- Giscus -->
2
- <!-- https://squidfunk.github.io/mkdocs-material/setup/adding-a-comment-system/#giscus-integration -->
2
+ <!-- https://zensical.org/docs/setup/comment-system/#giscus-integration -->
3
3
  <div id="feedback" style="display: none;">
4
4
  <h2 id="__comments">Feedback</h2>
5
5
  <script src="https://giscus.app/client.js"
@@ -0,0 +1,21 @@
1
+ /* Mark external links as such. */
2
+ a.external::after,
3
+ a.autorefs-external::after {
4
+ /* https://primer.style/octicons/arrow-up-right-24 */
5
+ mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
6
+ -webkit-mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
7
+ content: ' ';
8
+
9
+ display: inline-block;
10
+ vertical-align: middle;
11
+ position: relative;
12
+
13
+ height: 1em;
14
+ width: 1em;
15
+ background-color: currentColor;
16
+ }
17
+
18
+ a.external:hover::after,
19
+ a.autorefs-external:hover::after {
20
+ background-color: var(--md-accent-fg-color);
21
+ }