在 reStructuredText 中格式化链接中的文本

2023-12-11

如何格式化 reStructuredText 中指定链接内的文本?

具体来说,我希望从我的第一个代码生成以下 HTML:

<a href="http://docs.python.org/library/optparse.html"><tt>optparse.OptionParser</tt> documentation documentation</a>

结果应该是这样的:

optparse.OptionParser文档

其中“optparse.OptionParser”部分采用固定宽度字体。

I tried

```optparse.OptionParser`` <http://docs.python.org/library/optparse.html>`_

然而,这给了

<tt class="docutils literal">`optparse.OptionParser</tt> documentation &lt;<a class="reference external" href="http://docs.python.org/library/optparse.html">http://docs.python.org/library/optparse.html</a>&gt;`_

看起来像这样

``optparse.OptionParser documentation <http://docs.python.org/library/optparse.html>\_


这个构造:

Here you have |optparse.OptionParser|_.

.. |optparse.OptionParser| replace:: ``optparse.OptionParser`` documentation
.. _optparse.OptionParser: http://docs.python.org/library/optparse.html

生成此 HTML(添加了一些换行符):

<p>Here you have 
  <a class="reference external" href="http://docs.python.org/library/optparse.html">
  <tt class="docutils literal"><span class="pre">optparse.OptionParser</span></tt> documentation</a>.
</p>

我意识到这不是exactly你所要求的,但也许已经足够接近了。也可以看看http://docutils.sourceforge.net/FAQ.html#is-nested-inline-markup-possible.

本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

在 reStructuredText 中格式化链接中的文本 的相关文章

  • RestructedText - 向链接添加标题属性

    我正在尝试在我的网站上使用从 reStructuredText 生成的 jQuery lightBox 实现 lightBox 将图像周围的链接标题作为 lightBox 显示中图像的标题 但是 我似乎无法在 reStructuredTex
  • 通过序言格式化 csv 表?

    尽我所能 我无法弄清楚如何更改 sphinx 的 pdf 输出中的默认表格格式 我可以编辑 tex 文件或 writer py 源代码 但这两个似乎都是不好的选择 有什么东西可以通过序言来实现这一点吗 取决于您试图通过更改表格格式来完成的任
  • 将可点击的 SVG 图像插入 Sphinx 文档

    我有 SVG 图像文件 其中有多个节点 每个节点都与 URL 关联 如果我直接在浏览器中打开此文件 我可以单击每个节点 它将打开不同的 URL 但是 当我在 Sphinx 文档中使用这张图片时 它不起作用 图片作为一个整体呈现 所以我需要通
  • 比较和对比轻量级标记语言[关闭]

    就目前情况而言 这个问题不太适合我们的问答形式 我们希望答案得到事实 参考资料或专业知识的支持 但这个问题可能会引发辩论 争论 民意调查或扩展讨论 如果您觉得这个问题可以改进并可能重新开放 访问帮助中心 help reopen questi
  • 如何使用Sphinx管理多个版本的文档? [关闭]

    Closed 这个问题是基于意见的 help closed questions 目前不接受答案 我维护一个用 C 编写的小型库项目 我想使用 Sphinx 来维护每个发行版本的图书馆网站 用户文档 我发现 类似的问题如何管理多个版本 htt
  • 如何在 reStructuredText / Sphinx 中创建浮动图形?

    我想要一个带有文字的图形 这就是我要说的 Installation of Optional Accessories warning Never plug in or unplug a Hand Robot or a Grasp Sensor
  • 如何交叉引用 Sphinx 中 autodoc 生成的函数?

    我正在使用Sphinx autodoc根据我的 Python 库的文档字符串生成文档的功能 找到交叉引用的语法here http sphinx doc org markup inline html ref role 该部分之前必须有一个标签
  • 摆脱 Sphinx 中的“重复标签”警告

    在 Sphinx 中 我收到大量警告 例如 PATH FILENAME LINE WARNING duplicate label LABELNAME other instance in PATH FILENAME 似乎将所有节标题视为 标签
  • 通过 :ref:? 从 ReST 文档中提取文本块

    我有一些 reStructuredText 文档 我想在在线帮助中使用其中的片段 似乎一种方法是通过引用 剪掉 标记片段 例如 my boring section Introductory prose blah blah blah my i
  • 自 1.4.0 版本以来,sphinx_rtd_theme 不再是硬依赖项

    C Users Administrator Desktop item code serv documents api gt 制作 html 运行 Sphinx v1 6 2 加载腌制环境 失败 无法获取属性 WarningStream
  • Sphinx:将输出 html 分割成比输入文件更小的页面

    假设我有一个 Sphinx 索引文件 toctree foo bar 并且文档 foo 只有一个标题 Foo All about foo 而酒吧有两个 Bar All about Bars Parrot All about ex parro
  • 无法在我的 Django 项目中使用 Sphinx 生成自动文档

    我正在向我的 Django 项目添加文档 github链接 https github com augustakingfoundation queryjane app 该项目是开源的 使用sphinx 但是当尝试生成python文件的auto
  • Sphinx 的 .. include:: 指令和“重复标签”警告

    我正在尝试使用Sphinx http sphinx doc org s include 指示 http docutils sourceforge net docs ref rst directives html include将一个文件中的
  • sphinx导入父目录第一个文件?

    我需要为每个模块创建一个 sphinx 项目 每个模块共享一些公共资源 例如公司信息 许可证等 我的项目树是这样的 conf py index rst intro rst about rst device1 conf py device1
  • sphinx 中的分组方法文档字符串

    是否可以使用 sphinx 的 autodoc 功能将多个方法文档字符串分组 以便将它们列在一起 class Test object def a self A method of group foo def b self A method
  • 用于类工厂/选择器的 python rtype 文档字符串/重构文本

    rtype 指定这是返回对象的类型 因此 当我创建对象时obj在下面的代码片段中 我收到来自 IDE 的警告 cls is not callable 因为 IDE 期望cls is object类型的SomeAbstractClass 而且
  • Sphinx autodoc找不到模块

    我是 sphinx 的新手 需要帮助找出为什么会出现以下错误 WARNING autodoc failed to import module employe dao from module models the following exce
  • 如何在sphinx中启用数学?

    我在用sphinx http sphinx pocoo org index html与pngmath http sphinx pocoo org ext math html module sphinx ext pngmath扩展来记录我的代
  • sphinx 删除 automodule 中参数的模块前缀

    我知道如何通过设置 add module names False 来删除 automodule 指令中函数的模块前缀 从 sphinx 函数中删除包和模块名称 https stackoverflow com questions 208644
  • RestructedText 文档中的行距不一致

    我正在为我公司的文档构建 RST 文件 一件令人恼火的事情是 枚举列表在行距方面似乎没有任何一致性 有没有简单的方法来解决这个问题 Robert 这是一个众所周知的问题docutils Sphinx 构建的库 来自 GitHub 上的 Sp

随机推荐

  • 通过投影查询返回实体

    是否可以使用投影查询返回实体 我已经使用 SQL 查询成功完成了此操作 见下文 但找不到如何使用投影查询来完成此操作 Dim sql As String SELECT a b FROM a LEFT OUTER JOIN b ON a pk
  • 在 Select 语句计算 Oracle SQL 中使用列别名 [重复]

    这个问题在这里已经有答案了 是否可以做类似的事情select 1 as foo foo 1 from dual 这返回ERROR at line 1 ORA 00904 FOO invalid identifier 我有一个组成列的冗长计算
  • 从 Geb 测试调用 GORM 方法

    在我的 Grails 应用程序中 我有一套 Geb 测试 其中我调用各种 GORM 方法来保存 检索数据 直到最近 这一切都运行良好 但现在 每当我尝试从 Geb 测试调用 GORM 方法时 都会收到以下错误 类 com example M
  • 如何在打字稿中将日期转换为字符串格式 yyyy-mm-dd [重复]

    这个问题在这里已经有答案了 如何将日期转换为字符串格式年 月 日在打字稿中 现在我得到的日期为2017 年 3 月 24 日星期五 00 00 00 GMT 0400 东部夏令时间 我只需要格式中的日期 2017 03 24 从此并且没有任
  • jQuery 验证 – 选中复选框时检查输入值

    我有一个电话号码输入字段 其中包含短信更新选项 我想检查当选中短信复选框时该号码是否是手机号码 我已经使正则表达式正常工作 并且正在验证 但即使未选中复选框 也会显示 移动要求 错误 validator addMethod regex fu
  • 使用复选框在 mvc 中创建用户时添加功能

    我想在 mvc 中创建具有特殊功能的用户 当用户要创建时 我想为每个用户分配一些特殊功能 例如特定用户拥有自己的房子 使用复选框选择拥有自己的汽车 特定功能驻留在名为 feature 的不同表中 那么我如何在创建用户时向用户添加这些功能 我
  • Firestore 安全规则 - 如何防止修改某个字段

    假设我们有一个名为的 Firestore 集合todos 其中每个待办事项将如下所示 name Buy milk completed false user eYtGDHdfgSERewfqwEFfweE some user s uid 现在
  • 获取列表中最大的可用数字

    我有以下字符串List
  • Safari 上的 setDragImage 意外崩溃

    我很难确定为什么 Safari 6 0 在尝试使用 setDragImage 方法时意外崩溃 我有一个 Dragstart 事件 我想在发生此事件时附加背景图像 记录的方法是在事件接线上使用 setDragImage 方法 这在 Firef
  • 取消引用无效指针,然后获取结果的地址

    考虑 int ptr int 0xDEADBEEF cout lt lt void ptr 到底有多违法 考虑到它与立即数结合使用 并且考虑到没有超载op op 在玩吗 这对于寻址尾后数组元素有特殊的影响 myArray n 一个明确等价于
  • 文本框自动完成无法正常工作

    我正在尝试使用数组形式的自定义数据源实现文本框自动完成 该数据源显示有关单字符输入的建议 但是当我运行该程序时 自动完成功能仅在第二个字符输入后启动 当我调试时 我看到数据存在于 AutoCompleteNameCollection 中 但
  • cv::imdecode 将图像从 JS 转换为 C++(opencv、emscripten)

    我正在尝试做的事情 用户加载 html 中的图像 opencv 用 C 接收该图像并对其进行一些处理 我所做的或多或少与此处描述的相同 https answers opencv org question 222994 how to pass
  • loadNamespace 中出现错误,在 plm 包中找不到对象“vI”

    我以前在安装软件包时从未遇到过问题 当我第一次尝试安装时plm包 它给了我一个错误 说该包pbkrtest没有安装 所以我尝试安装pbkrtest but install packages pbkrtest 不起作用 它给了我这个错误消息
  • 没有周末的约会的倒退

    我经常用这个query1要返回 6 天的可变日期 query1 SELECT DATE FORMAT DATE 2018 11 21 INTERVAL S I 1 DAY Y m d AS VAR FROM HELPER SEQ AS S
  • 局部变量声明问题

    我收到以下错误 在声明之前不能使用局部变量 dob 这是我的实现 public class Person public string dob get set public int getAge DateTime origin DateTim
  • 从列表中打印随机字符串(多次),不重复

    我想在整个程序中多次打印同一列表中的随机字符串 但不重复任何先前打印的随机字符串 如果我有以下内容 core a b c d print random sample core 0 k 2 print random sample core 0
  • 如何使用列表中的元素构建特定形状的树

    给定一个 s 表达式 a b c d 和一个清单 e f g h 如何遍历 s 表达式创建具有相同形状但元素取自列表的 s 表达式 例如 对于上面的 s 表达式和列表 结果将是 e f g h 按从左到右的顺序遍历树对并不是特别困难 因为c
  • 获取任意给定数量的包含字符串的数组的交集元素的函数

    我有以下函数返回一些字符串数组之间的元素的交集 最初它只打算处理 2 个数组 但我开始需要它处理 2 个以上的数组 所以我添加了条件return使其递归 我怎样才能让它足够灵活 以便它能够处理任意数量的数组 当然等于或大于 2 我想过使用
  • 使用 Qt 运行日志流处理程序时 Python 崩溃

    Goal 我有一个在运行时记录文件 realtime log 的进程 我想在我的应用程序中实时打印该文件的每个新行 换句话说 我想将进程的输出重定向到 GUI 这意味着我有两个不同的过程运行 引擎 和GUI 我已经通过使用 Tkinter
  • 在 reStructuredText 中格式化链接中的文本

    如何格式化 reStructuredText 中指定链接内的文本 具体来说 我希望从我的第一个代码生成以下 HTML a href http docs python org library optparse html a