在Sphinx中切换页面内容和折叠警告。

sphinx-togglebutton的Python项目详细描述


斯芬克斯切换按钮

一个小的狮身人面像扩展,可以添加一个“切换按钮”到 页面的部分。这允许您:

  • 折叠斯芬克斯警告(注释、警告等),以隐藏其内容 直到用户单击切换按钮。在
  • 使用collapse指令折叠页面上的任意内容块。在

demo gif

安装

您可以使用pip安装sphinx-togglebutton

pip install sphinx-togglebutton

使用

conf.py配置文件中,添加sphinx_togglebutton 你的扩展列表。在

例如:

^{pr2}$

现在,无论何时您希望警告能够切换,请添加 :class: dropdown参数。在

例如,此代码将创建一个可切换的“注意”警告 开始隐藏:

..note:::class: dropdown

    This is my note.

单击切换按钮将切换项目的可见性。在

您也可以在默认情况下显示内容。为此,请添加dropdown以及atoggle-shown类,如下所示:

..note:::class: dropdown, toggle-shown

    This is my note.

您还可以使用containers添加任意可切换的代码。例如, 这是一个里面有图像的容器:

..container:: toggle, toggle-hidden

    ..admonition:: Look at that, an image!

        ..image:: https://media.giphy.com/media/mW05nwEyXLP0Y/giphy.gif

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
java WebClient请求级别超时抛出名为default onErrorDropped的运算符   java JAXB外部绑定文件错误   Freemarker中的java转义宏参数值   java正在同步来自不同对象{已编辑}的线程   java如何在另一个类上更新活动中的元素   java Hibernate连接查询   java可以使用Apache Crunch创建类似于图形的数据结构吗?   java在JLabel的开头加上3个点   java 安卓应用程序显示线程错误   java@RequestBody在Spring中总是空的   java Android异步任务永远不会结束   具有多个属性的java Jaxws枚举   java中的安卓 Stripe InvalidRequestException   多线程java。util。非多线程程序中的ConcurrentModificationException   Minecraft Java插件如何删除HashMap中存储的所有块   空Java字符串的大小   从AJP连接器请求检索Shibboleth属性的java   oracle11g将Java类文件加载到Oracle数据库