An open API service indexing awesome lists of open source software.

https://github.com/attakei/rst-package-refs


https://github.com/attakei/rst-package-refs

docutils hacktoberfest pypi python

Last synced: 6 months ago
JSON representation

Awesome Lists containing this project

README

          

================
rst-package-refs
================

.. note:: This is experimental package.

reStructuredText's custom roles and role builder kit for package registries of any languages.

Installation
============

.. code:: console

pip install rst-package-refs

Usage
=====

Command line test
-----------------

.. code:: console

$ echo ':npm:`react`' | python -m rst_package_refs



react

With Sphinx
-----------

.. code:: python

extensions = [
"rst_package_refs.sphinx",
]

.. code:: rst

This uses :npm:`react`.

Set up for local development
============================

Pre-requirements
----------------

* `Rye `_
* `pre-commit `_
* Git

Set up
------

.. code:: console

git clone https://github.com/attakei/rst-package-refs.git
cd /path/to/rst-package-refs
rye run setup