css 如何将ReadTheDocs Sphinx主题的文本对齐方式更改为“justify”？

wwwo4jvm 于 2023-05-02 发布在其他

关注(0)|答案(2)|浏览(150)

我正在为我的项目在REST中编写一个新文档。该文档在ReadTheDocs上使用Sphinx呈现。我已经将ReadTheDocs主题作为git子模块下载到我的仓库docs/source/_themes文件夹中，这样我就可以修改一些模板或CSS设置。
我想将大段的文本对齐方式从 ragged right 更改为 fully justified。
我在哪里可以改变他在数百行的CSS代码？

文档结构：

...
<div class="section" id="basic-2-flip-flop-synchronizer">
  <h2>Basic 2 Flip-Flop Synchronizer</h2>
  <p>The 2 flip-flop ....

  </p>
</div>

要包含或替换的CSS代码：

text-align:justify;

我10年前就使用CSS了，但我对新的CSS选择器并不了解。.. *

css

来源：https://stackoverflow.com/questions/37298188/how-can-i-change-text-justification-to-justify-for-the-readthedocs-sphinx-them

2条答案

按热度按时间

pwuypxnk1#

您可以通过添加以下代码块直接修改docs/source/_themes中的css文件

.section #basic-2-flip-flop-synchronizer{
     text-align:justify;
}

我建议把这个代码块放在css文件的最后，因为如果.section #basic-2-flip-flop-synchronizer碰巧出现在css文件中的某个地方，它会覆盖css属性。
就像@Ricardo Ruiz Melendez在下面建议的那样，更改css文件的最佳实践是使用自定义的css文件。您可以在here和official website上找到分步指南

赞(0）回复(0）举报 2023-05-02

aij0ehis2#

看起来文档结构在2016年到2023年之间进行了更新，Sphinx现在使用<section>标签而不是<div class="section">。如果你想对齐所有的部分，只需要去掉_static/css/custom.css中的点：

section {
    text-align: justify;
}

注册这个自定义css（根据docs.readthedocs.io）：

## conf.py

# These folders are copied to the documentation's HTML output
html_static_path = ['_static']

# These paths are either relative to html_static_path
# or fully qualified paths (eg. https://...)
html_css_files = [
    'css/custom.css',
]

赞(0）回复(0）举报 2023-05-02

我来回答

css 如何将ReadTheDocs Sphinx主题的文本对齐方式更改为“justify”？

2条答案

相关问题

热门标签

最新问答