问题标签 [restructuredtext]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
html - sphinx,restructuredtext:为单个单词设置颜色
有没有办法在sphinx中设置单个单词(或字符)的颜色?我很确定应该有一些标记标签,比如 HTML 的font
标签。
python-sphinx - 在 Sphinx 中,如何在没有大量开销的情况下创建可链接的“术语”部分?
我想创建一个“术语”部分,其中包含我正在使用的术语的定义,这样每次我使用此术语部分中的术语时,都会创建一个指向定义的链接。
目前,我能想到的最好的是:
然后,在其他文本中,我必须这样做:
我发现上面的语法非常麻烦。我知道我可以使用另一层脚本或 m4 来自动生成这种语法,但我希望有更好的方法..
python - 用于将 rst 转换为 html 的单个 py 文件
我有一个用 reStructuredText 编写的博客,目前我在发布新帖子时必须手动将其转换为 HTML。
我正在使用 Google App Engine 编写一个新的博客系统,需要一种将 rst 转换为 HTML 的简单方法。
我不想使用docutils
,因为它太大太复杂。有没有更简单的(理想情况下是单个 python 文件)方法可以做到这一点?
python - 使用 reStructuredText 添加一些带有自定义“id”和“class”属性的 HTML
使用 rsStructuredText 生成 HTML,我试图包装一个
带有额外 div 元素的段落。必须包含带有我分配的值的“id”属性。此外,该
必须具有“可编辑”值的“类”属性。
这是我到目前为止所拥有的:
这是输出:
我已经得到了我想要的结果,虽然我不喜欢嵌入原始 HTML。我的问题是reStructuredText 中是否有任何指令或其他方法可以不显眼地实现相同的结果?
restructuredtext - 有没有办法在重组文本表的单元格中右对齐文本?
当我在表格中输入数字时,我通常希望它们正确对齐并采用固定宽度的字体。否则数字变得难以比较。
有没有办法在表中正确对齐字段?
例如,我如何让这个数字正确地呈现出来?
django - 在 django(和 python)中解析重组文本
我将使用 Django(我来自 Sphinx)管理一些文档,以便更好地控制输出。文档位于 git 存档中的 rst(重组文本)中,使用过滤器在 HTML 中显示它们很简单。我的问题是它们很长,我希望对分页方式有更多的控制,所以我可以在每个 HTML 页面上显示一个部分,对单个部分进行评论等等......
我的目标是能够解析每个文档,创建带有指向单独 HMTL 页面中每个部分的链接的 TOC,其中视图将遍历整个文档以仅在 html 中呈现一个部分。
我知道这主要是 docutils 的问题,我能找到的最有趣的例子是:http ://www.ibm.com/developerworks/library/x-matters24/#code2但它似乎已经过时并且示例在“面向树的处理”部分中,这就是魔法所在,似乎不适用于我的 docutils 版本。文章很好:我可以使用更多相同的主题!
有没有类似于我计划做的事情可以学习,或者有人可以指出我对 docutils 的温和介绍来解析 rst 文档?
python - 如何抑制或禁用 reSTructuredText 中的警告?
我正在用 Python 开发一个 CMS,它使用 reStructuredText(通过 docutils)来格式化内容。我的很多内容都是从其他来源导入的,通常以无格式文本文档的形式出现。reST 对此非常有效,因为它默认情况下让一切看起来都非常正常。
然而,我遇到的一个问题是,我收到警告转储到我的网络服务器上的 stderr并 注入到我的页面内容中。例如,我在网页上收到如下警告:
系统消息:WARNING/2(第 296 行);反向链接
我的问题是:如何抑制、禁用或以其他方式重定向这些警告?
理想情况下,我很想将这些写到日志文件中,但如果有人能告诉我如何关闭警告,以免注入到我的内容中,那将是完美的。
负责将 reST 解析为 HTML 的代码:
python - 带有 reStructuredText 的项目符号列表中的源代码
我正在尝试使用 reStructuredText 将源代码包含在项目符号列表中;像这样:
但是,我收到以下警告:
System Message: WARNING/2
Literal block expected; none found.
列表中的空行缩进一个空格。有任何想法吗?
svn - svn和rST格式项目
我在提交 rST 文件时遇到了一些问题,例如
我收到了这个错误:
我发现问题出在=
字符上,可能它们与 diff 格式冲突,所以我全部替换=
为_
,现在它可以工作了,但它很难看。为什么会出现这个问题以及如何解决?
python - Sphinx:将代码段放在无序列表项的第一行
我正在使用 Sphinx 来管理我的项目文档。
我有一个无序列表,我希望每个项目的第一行都是一个代码段。(不是内联,一个段落。)
我怎样才能做到这一点?