跳转到主要内容

Sphinx指令,用于添加不可选提示

项目描述

Sphinx Prompt

初始化

conf.py中添加extensions += ['sphinx_prompt']

语法

可以使用prompt指令创建一个默认提示

.. prompt::

   <statements>

提示可以通过以下两种方式之一进一步自定义

  • 使用位置参数

    .. prompt:: [<language> [<prompts> [<modifiers>]]]
    
        <statements>
    
  • 使用选项

    .. prompt::
        :language: <language>
        :prompts: <prompts>
        :modifiers: <modifiers>
    
       <statements>
    

虽然这些结构生成相同的输出,但在需要使用包含空格的提示时,不能使用位置参数。这是reStructuredText的限制。

如果它们不重叠,则可以将位置参数与选项混合使用(因此,如果您通过选项传递提示,则只能使用位置参数传递语言)

.. prompt:: bash
    :prompts: (cool_project) $

   python3 -m pip install --upgrade sphinx-prompt

语言

支持的语言

  • text(无颜料,默认)
  • bash
  • batch
  • powershell
  • python
  • scala

提示

如果修改符为auto,则是在语句中查找的提示的逗号分隔列表。

否则是在每个语句上添加的提示,对于Python和Bash语言,支持末尾的\

默认为空,除非以下列出的shell语言

  • bash - $
  • batch - C:\>
  • powershell - PS C:\>

示例

见:http://sbrunner.github.io/sphinx-prompt/

运行测试和prospector

python3 -m pip install --user --upgrade poetry
poetry install
poetry run pytest
poetry run prospector

代码应该使用blackisort格式化。

创建新版本

git tag <version>
git push origin <version>

贡献

安装pre-commit钩子

pip install pre-commit
pre-commit install --allow-missing-config

项目详情


下载文件

下载您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分布

sphinx_prompt-1.9.0.tar.gz (5.3 kB 查看哈希值)

上传时间:

构建分布

sphinx_prompt-1.9.0-py3-none-any.whl (7.3 kB 查看哈希值)

上传时间: Python 3

由以下支持

AWSAWS云计算和安全赞助商DatadogDatadog监控FastlyFastlyCDNGoogleGoogle下载分析MicrosoftMicrosoftPSF赞助商PingdomPingdom监控SentrySentry错误日志StatusPageStatusPage状态页面