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

【问题标题】：How can I change text justification to 'justify' for the ReadTheDocs Sphinx theme?如何将 ReadTheDocs Sphinx 主题的文本对齐方式更改为“对齐”？
【发布时间】：2016-05-18 11:24:39
【问题描述】：

我正在为我的 reST 项目编写新文档。该文档在 ReadTheDocs 上使用 Sphinx 呈现。我已经将 ReadTheDocs 主题作为 git 子模块下载到我的存储库 docs/source/_themes 文件夹中，因此我可以修改一些模板或 CSS 设置。

我想将大段落的文本对齐方式从右对齐更改为完全对齐。
几百行 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 themes python-sphinx read-the-docs

【解决方案1】：

你可以直接修改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 上找到分步指南

【讨论】：

如果你有这行代码，我建议在你的自定义 css 中添加这行代码，它应该在你的主题 css 之后链接。最好以这种方式覆盖主题的类，以防您将来需要将模板更新到较新的版本，而无需确定您在该文件中更改了哪些类。