跳转到主要内容

Sphinx扩展用于OS代码块

项目描述

Documentation Status

Sphinx的osexample扩展

这是Serge Domkowski的examplecode扩展的修改分支,用于Sphinx。

关于

这是一个简单的扩展,当作为HTML渲染时,它将折叠包含不同操作系统管理示例的多个代码块,并可以通过按钮切换到另一个块。

它旨在用于显示包管理器示例。(例如,apt install或dnf install)。

此扩展添加了example-code指令,它为应折叠的代码块的外部容器添加一个类。该类允许包含的JavaScript和CSS渲染折叠的块和按钮。

目前支持:Debian,Ubuntu,Fedora,CentOS,OSX

快速示例

源代码看起来可能像这样

.. example-code::
    .. code-block:: Debian

        sudo apt install htop

    .. code-block:: Fedora

        sudo dnf install htop

这将创建如下所示的输出

Example how it looks like as generated HTML

安装

$ pip install sphinxcontrib-osexample
在 Sphinx 中启用扩展

只需将 sphinxcontrib.examplecode 添加到 conf.py 文件中扩展列表即可。例如

extensions = ['sphinxcontrib.osexample']

文档

最终用户的完整文档可以在“docs”文件夹中找到。

您还可以在 Read The Docs 上找到。

贡献

支持

如果您遇到问题,请告诉我们。

许可证

该项目采用 BSD 许可。

项目详情


下载文件

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

源分布

sphinxcontrib-osexample-0.1.1.tar.gz (4.8 kB 查看哈希值)

上传时间

支持