首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

如何在Sphinx中折叠所有的第二级部分?

在Sphinx中折叠所有的第二级部分,可以通过使用Sphinx提供的toctree和sphinx-togglebutton插件来实现。

首先,在你的Sphinx项目的conf.py文件中,添加sphinx-togglebutton插件的配置:

代码语言:txt
复制
extensions = [
    'sphinx_togglebutton'
]

然后,在你的文档中,使用toctree指令来创建目录结构,并使用sphinx-togglebutton插件提供的按钮指令来折叠第二级部分。示例如下:

代码语言:txt
复制
.. toctree::
   :maxdepth: 2

   section1
   section2
   section3

.. togglebutton:: Toggle Sections
   :target: toctree

   .. toctree::
      :hidden:

      section1
      section2
      section3

上述代码中,toctree指令用于创建目录结构,其中的:maxdepth: 2表示只显示第一级和第二级部分。togglebutton指令用于创建一个折叠按钮,点击按钮可以展开或折叠第二级部分。:target: toctree表示按钮的目标是toctree指令创建的目录结构。在togglebutton指令内部,又使用了一个隐藏的toctree指令来实际显示第二级部分。

这样配置后,生成的文档中将会显示一个折叠按钮,点击按钮可以展开或折叠第二级部分。

页面内容是否对你有帮助?
有帮助
没帮助

相关·内容

reStructuredtext快速入门

在必要的时候,.rst文件可以被转化成PDF或者HTML格式,也可以有Sphinx转化为LaTex,man等格式,现在被广泛的用于程序的文档撰写。...段落 段落是reST文档中最基础的部分,段落通过一个或者多个空行分隔开。左侧必须对齐(没有空格,或者有相同多的空格)。 内联标记 标准的reST内联标记包括:粗体、斜体以及引用。...无序列表 和顺序列表相似, 使用 “*” “+” “-” 代替数字: * 列表第一级 + 第二级 - 第三级 + 第二级的另一个项目 自定义列表 或者叫名词解释更确切: *鸡*...* 及上划线表示章节 =, 小章节 -, 子章节 ^, 子章节的子章节 ", 段落 显示标记 显式标用在那些需做特殊处理的reST结构, 尾注,突出段落,评论,通用指令....也是reST 的扩展规则, 在 Sphinx 经常被用到。

1.5K20

IEEE S&P 2022丨速度提升达4-6个数量级,港科大、星云Clustar联合提出隐私保护的在线机器学习新框架

为了确保在公有云上进行计算使用的用户数据隐私,研究者们提出了各种基于不同技术的隐私保护机器学习算法(多方安全计算、同态加密或差分隐私)。...Sphinx 将其神经网络模型的线性参数 (linear) 保持为明文,并使用差分隐私技术进行隐私保护;其加和偏差部分模型参数 (bias) 使用同态加密技术进行加密保护。...因此,我们提出了基于多隐私保护计算技术的在线机器学习框架SphinxSphinx的核心架构是将深度神经网络的每个线性层分为两部分:线性分量 和偏置分量 。...Sphinx提出了更多的系统级别的优化方案。延迟再缩放和再线性计算、设计暂存正向传播密文特征的缓存来用于在反向梯度传播减少密文的重复传输次数,以及设计加密、传输密文和解密的加速方案。...由于Sphinx使用了差分隐私技术对部分的模型参数进行了保护,部分模型参数是通过添加噪声之后以明文的形式保存在服务器上的。

77320
  • FPGA的亚稳态

    在信号传输中产生亚稳态就会导致与其相连其他数字部件将其作出不同的判断,有的判断到“1”有的判断到“0”,有的也进入了亚稳态,数字部件就会逻辑混乱。在复位电路中产生亚稳态可能会导致复位失败。...图3.6 三级寄存器同步 这种模型大部分资料都说的是第一级寄存器产生亚稳态后,第二级寄存器稳定输出概率为90%,第三极寄存器稳定输出的概率为99%,如果亚稳态跟随电路一直传递下去,那就会另自我修护能力较弱的系统直接崩溃...如图3.7示为一个正常第一级寄存器发生了亚稳态,第二级、第三极寄存器消除亚稳态时序模型。 ?...因此,在进行异步信号跨频提取边沿时候,一般采用多进行一级寄存器消除亚稳态,可能在系统稳定性要求高的情况下,采用更多级寄存器来消除亚稳态,程序清单 4.2示,即为采用4级寄存器消除亚稳态,相应的边沿信号产生的时间就晚了两个时钟周期...常用电路模型所示。采用第二级寄存器输出作为全局复位信号输出。

    1.2K10

    ReStructuredText 文档编写全攻略编写文档说明

    sphinx 介绍 sphinx 是一个基于python的文档生成工具,许多 python 项目都用使用这个工具自动生成文档。...我的思考结果如下: 标题 段落 文本标记 图片 表格 链接 上述6个部分几乎包括一篇的全部组成,所以学习 rst 语法也从这6个部分着手。...语法: 8.png 8_1.png 结果: 8_2.png 语法: 8_3.png 结果: 8_4.png 具体语法,可以参看上面的中文文档链接,先学会核心的这几个,遇到问题再针对性的查找: 比如:如何在文档内提供下载链接...-g 创建一个项目:初始化书本的目录 gitbook init 生成两个文件: README.md SUMMARY.md 在 SUMMARY.md 文件构造目录结构 比如创建两个章节: #...安装sphinx pip install sphinx 3. 创建文档项目 sphinx_quickstart 几乎是一路默认下来。看操作提示。

    5.7K31

    关于 Python 3.13 的规划

    项目计划 根据 Python 语言的发展周期,每六个月发布一个新版本,并在每个版本实现一些优化和改进。我们目前正在开发 3.13 版本,计划在 2023 年 6 月发布。...3.13 版本中将要实现的一些主要特性: 完成分层编译器(tiered compiler)的设计和实现,包括两个级别:第一级是基于 PEP 659 的自适应优化器(adaptive optimizer),第二级是基于...第二级编译器负责将热点代码编译成机器码,并进行一些复杂的优化,例如常量传播(constant propagation)、死码消除(dead code elimination)、寄存器分配(register...语法分析器负责将源代码解析成抽象语法树(abstract syntax tree),并进行一些语法层面的优化,例如常量折叠(constant folding)、表达式简化(expression simplification...指令生成器负责根据指令定义来生成不同级别编译器所需的代码,例如主解释器(main interpreter)、第二级解释器(tier 2 interpreter)、文档生成器(documentation

    51110

    Markdown:技巧进阶参考资料:开始学习:

    参考资料: Markdown基础语法整理 如何在markdown打出上标、下标和一些特殊符号 https://github.com/guodongxiaren/README https://www.zybuluo.com...例如: - 第一级目录无序列表 - 第二级目录无序列表 - 第二级目录无序列表 1. 第二级目录下的有序列表1 2....第二级目录下的有序列表2 - 第三级目录 - 第一级目录 显示效果: 第一级目录无序列表 第二级目录无序列表 第二级目录无序列表 第二级目录下的有序列表1 第二级目录下的有序列表2 第三级目录...1,写法如下: n2=n+1 下标的标签是,同理我们来实现一个例子:a=log2 b写法如下: a=log2b 还有一些特殊的、键盘上没有的符号也可以打出来...例如: hello[^1] [^1]: hi 显示效果: hello[1] 锚点(页面内跳转) 网页,锚点其实就是页内超链接,也就是链接本文档内部的某些元素,实现当前页面的跳转。

    1.2K20

    关于 Python 3.13 的规划

    项目计划 根据 Python 语言的发展周期,每六个月发布一个新版本,并在每个版本实现一些优化和改进。我们目前正在开发 3.13 版本,计划在 2023 年 6 月发布。...3.13 版本中将要实现的一些主要特性: 完成分层编译器(tiered compiler)的设计和实现,包括两个级别:第一级是基于 PEP 659 的自适应优化器(adaptive optimizer),第二级是基于...第二级编译器负责将热点代码编译成机器码,并进行一些复杂的优化,例如常量传播(constant propagation)、死码消除(dead code elimination)、寄存器分配(register...语法分析器负责将源代码解析成抽象语法树(abstract syntax tree),并进行一些语法层面的优化,例如常量折叠(constant folding)、表达式简化(expression simplification...指令生成器负责根据指令定义来生成不同级别编译器所需的代码,例如主解释器(main interpreter)、第二级解释器(tier 2 interpreter)、文档生成器(documentation

    36410

    Python3.13要来了

    项目计划 根据 Python 语言的发展周期,每六个月发布一个新版本,并在每个版本实现一些优化和改进。我们目前正在开发 3.13 版本,计划在 2023 年 6 月发布。...3.13 版本中将要实现的一些主要特性: 完成分层编译器(tiered compiler)的设计和实现,包括两个级别:第一级是基于 PEP 659 的自适应优化器(adaptive optimizer),第二级是基于...第二级编译器负责将热点代码编译成机器码,并进行一些复杂的优化,例如常量传播(constant propagation)、死码消除(dead code elimination)、寄存器分配(register...语法分析器负责将源代码解析成抽象语法树(abstract syntax tree),并进行一些语法层面的优化,例如常量折叠(constant folding)、表达式简化(expression simplification...指令生成器负责根据指令定义来生成不同级别编译器所需的代码,例如主解释器(main interpreter)、第二级解释器(tier 2 interpreter)、文档生成器(documentation

    90210

    VMware 用户请注意,Kubernetes 扫盲看这里了!

    Dashboard 的功能也变得越来越强大,它可以实现大部分的 K8s 集群管理功能,而不用输入很长的 kubectl 命令。...当然,YAML 配置文件在 K8s 不仅用于定义集群,也用于定义其他的组件,:副本集合、服务、部署等。...不同的是,K8s 中标签是必须的,而不是可选的。...当然两者基本的工作原理是不一样的,K8s 的所有实例正常情况都是在工作的,在多个实例间均衡工作负载,而不存在主备的概念,这是由云原生应用的本质决定的。...负载均衡 vSphere 并不内置有负载均衡功能,一般是通过虚拟的 ( NSX) 或物理的 ( F5) 负载均衡器来把服务请求平均分配给多台虚机。

    59820

    PHP+MySQL+sphinx+scws实现全文检索功能详解

    '/rules.utf8.ini'); //设定分词返回结果时是否去除一些特殊的标点符号 $so- set_ignore(true); //设定分词返回结果时是否复式分割,“中国人”返回“中国+人+中国人...## 有的字符串,虽然长度很长,但是实际上并没有使用那么长的字符,所以在Sphinx并不会收录所有的字符,而是给每个属性一个缓存作为长度限制。...## searchd会讲spa和spi预读取到内存。但是如果这部分内存数据长时间没有访问,则它会被交换到磁盘上。 ## 设置了mlock就不会出现这个问题,这部分数据会一直存放在内存的。...并不是所有的字段都需要进行前缀和中缀索引。...max_children = 30 ## 进程id文件 pid_file = /home/yejianfeng/instance/coreseek/var/log/searchd.pid ## 守护进程在内存为每个索引保持并返回给客户端的匹配数目的最大值

    2.7K32

    哈佛开发机器人手臂,收放海洋软体动物而不会造成伤害

    然而,这些生物体的许多都是软体的,如水母,鱿鱼和章鱼,并且难以用现有的水下工具捕获它们,因为这些工具经常会破坏它们。现在,由哈佛大学Wyss研究的研究人员,John A....Paulson工程与应用科学学院(SEAS)和拉德克利夫高级研究开发了机器人设备,可以安全地将精致的海洋生物捕获到折叠的多面体外壳内,该研究报告发表在Science Robotics上。...当单个电机向花瓣相遇的点施加力矩时,它会使整个结构围绕其关节旋转并折叠成一个空心的十二面体(十二面,几乎呈圆形的盒子),它的名字为旋转驱动的十二面体(RAD)。...它也是模块化的,所以如果有什么东西坏了,我们可以简单地更换那个部分并将采样器送回水中,这种折叠也非常适合在太空中使用,因为它也是一个低重力,不适宜居住,操作任何设备都具有挑战性的环境。”...“我们想为采样器添加摄像头和传感器,以便将来我们可以捕获动物,收集大量有关它的数据,它的大小,材料属性,甚至它的基因组,然后再进行释放。”

    35130

    ATT&CK视角下的红蓝对抗之UAC用户账户控制

    虽然此类机能一直遭到部分用户的批评,但后续的Windows操作系统仍保留此类机能。Windows 7,微软公司保留并改进了此项功能(自定义UAC的安全等级)。 2....2)第二级别(默认级别) 仅在程序尝试试图改变系统设置时才会弹出UAC提示,用户改变系统设置时不会弹出提示(如果我们使用常见程序和常见网站,推荐使用这种模式),如图1-2示。...3)第三级别 仅当程序尝试更改计算机时弹出通知提示,用户自行设置更改计算机时不会弹出通知提示(与第二级别基本相同,但不使用安全桌面),如图1-3示。...正常来说,当我们使用账号登录到操作系统之后会产生令牌,令牌会记载我们有的权限 ,如果我们以管理员角色权限进行登录会生成两份访问令牌,如图1-7示。...我们可根据实际情况选择是还是否,如图1-8示,出现这种情况的原因是在访问之前,系统会先检查进程所持有的Access Token 以及被访问对象的安全描述符的DACL规则,确保携带的令牌以及规则正确无误

    30710

    使用python编写量子线路打印的简单项目,并使用Sphinx自动化生成API文档

    一般一个python项目的文档有两部分组成:一部分是用markdown撰写的使用说明文档,其宗旨在于概述的介绍整个项目的重点内容,以及可能包含少部分的使用示例。...这部分的文档可以先用markdown写,然后通过一些开源工具,mkdocs等转换成read_the_docs格式的文档。read_the_docs格式的文档大概如下图所示,也可以直接参考其官方文档。...在这个执行的过程,有一部分的告警是跟注释规范相关的,其实不用处理也没有关系。...需要注意的是,如果相关的类或者函数是受保护的类型,那么在sphinx生成的文档是不会显示的(构造过程自动忽略)。...补充说明(2021.03.27) 如果在使用sphinx的过程,发现代码的注释文件并未被成功生成。

    2.9K20

    各位 VMware 用户请注意,Kubernetes 扫盲只需看这一篇就够了!

    Dashboard 的功能也变得越来越强大,它可以实现大部分的 K8s 集群管理功能,而不用输入很长的 kubectl 命令。...当然,YAML 配置文件在 K8s 不仅用于定义集群,也用于定义其他的组件,:副本集合、服务、部署等。...不同的是,K8s 中标签是必须的,而不是可选的。...当然两者基本的工作原理是不一样的,K8s 的所有实例正常情况都是在工作的,在多个实例间均衡工作负载,而不存在主备的概念,这是由云原生应用的本质决定的。...负载均衡 vSphere 并不内置有负载均衡功能,一般是通过虚拟的 ( NSX) 或物理的 ( F5) 负载均衡器来把服务请求平均分配给多台虚机。

    83110

    Lucenu和Sphinx介绍

    一、Lucene介绍 1、简介 Lucene 是apache软件基金会一个开放源代码的全文检索引擎工具包,是一个全文检索引擎的架构,提供了完整的查询引擎和索引引擎,部分文本分析引擎。...Lucene的目的是为软件开发人员提供一个简单易用的工具包,以方便的在目标系统实现全文检索的功能,或者是以此为基础建立起完整的全文检索引擎。...它只是一个类库,有足够的定制和优化空间:经过简单定制,就可以满足绝大部分常见的需求;经过优化,可以支持 10亿+ 量级的搜索。 4、缺点 需要额外的开发工作。...所有的扩展,分布式,可靠性等都需要自己实现;非实时,从建索引到可以搜索中间有一个时间延迟,而当前的“近实时”(Lucene Near Real Time search)搜索方案的可扩展性有待进一步完善。...,在检索速度上,和lucene相差不大,但检索精准度方面Lucene要优于Sphinx,另外在加入中文分词引擎难度方面,Lucene要优于Sphinx.其中Sphinx支持实时搜索,使用起来比较简单方便

    1.4K60

    【笔记】《MeshCNN: A Network with an Edge》的思路

    如下图的过程,边折叠过程让5条边变成两条,从而减少了网络特征的数量,也允许了网络主动选择需要被简化的部分,这是和PointNet不同的,任务相关的处理部分。...网格顶点坐标本身对于网络并没有什么意义,后面会新计算出来的顶点坐标也仅仅是为了可视化而计算,对网络不会有影响 二维上的卷积操作是让卷积核的每个元素与当前扫描到的部分进行逐项相乘并求和,因此这部分操作在三维网格卷积中被改造成了下面的式子...,但是三维并不如此,在这篇文章中将池化定义为折叠一系列边的过程,每一组池化将五条相关边折叠成两条,对于如何动态处理折叠后产生的新的相邻关系,Berg等人在08年的论文中详细阐述了这种情况的解决方法。...对一条边进行折叠后,产生新边的方法与PartB的介绍是相同的,按照下面的求平均式子把五条边的特征变为了两条边的特征 ? 每次折叠一条边,便需要对网格结构进行一次更新以备接下来的折叠。...折叠还要注意并不是所有的边都可以进行折叠折叠必须满足前面所说一条边有四个邻边的假设,不满足假设的边不能折叠 PartE 网格上池化 上池化操作接近于池化操作的逆运算,它是一种上采样,会提升网格被降低的分辨率

    4.9K41

    下载量过亿的 15 个 Python 库

    Urllib3:8.93亿次下载 Urllib3 是 Python 的 HTTP 客户端,它提供了许多 Python 标准库没有的功能。...使用 pip 从 Python Package Index和其他仓库(本地镜像或包含私有软件的自定义仓库等)安装软件包不费吹灰之力。...利用这些证书的公开部分,浏览器就可以验证网站的签名,从而证明你访问的是真正的网站,而且别人没有在窃听数据。 Python 也可以做到同样的功能,这就需要用到 certifi。...那么问题何在? 问题是许多应用程序(Email客户端和Web浏览器等)并不支持非 ASCII 字符。或者更具体地说,Email 和 HTTP 协议并不支持这些字符。...Sphinx 的核心也使用了 docutils。Sphinx 用于创建文档项目。如果说 docutils 是一台机器,那么 Sphinx 就是一个工厂。

    16010
    领券