Skip to content

Commit

Permalink
docs: document how to use dargs sphinx directive in markdown files (#77)
Browse files Browse the repository at this point in the history
inspired by deepmodeling/deepmd-kit#3989

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- **Documentation**
- Added a code snippet for writing Markdown files using MyST-Parser in
the documentation.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
  • Loading branch information
njzjz authored Jul 17, 2024
1 parent 7c18715 commit b8d71d8
Showing 1 changed file with 10 additions and 0 deletions.
10 changes: 10 additions & 0 deletions docs/sphinx.rst
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,16 @@ A :class:`list` of :class:`Argument <dargs.Argument>` is also accepted.
:module: dargs._test
:func: test_arguments

To write Markdown files with `MyST-Parser <https://github.com/executablebooks/MyST-parser>`_, one can use:

.. code-block:: markdown
```{eval-rst}
.. dargs::
:module: dargs._test
:func: test_argument
```
Cross-referencing Arguments
---------------------------

Expand Down

0 comments on commit b8d71d8

Please sign in to comment.