如何用狮身人面像制作2列

Question

我想在我的文档中创建多个列。

在全球范围内，我想做一些类似于 此主页 的事情，其中​​有 3 列：一列带有当前版本，其中包含新闻和内容更新和基础知识。

当我在谷歌上搜索有关 Sphinx 中的多列时，我发现将列表分成两列，这不是我的情况

在维基上我发现的多列的唯一内容是表格，但我认为这不适用于此处？

在使用 Sphinx 的第一个文件中这可能吗？

多谢

Answer 1

好吧，我终于找到了：

您可以在 sphinx/rst 文件中使用 container 关键字来分隔内容

.. container:: twocol

    .. container:: leftside

        text on left column

    .. container:: rightside

        text on right column

然后在您的 .css 文件中：

div.leftside {
  width: 43%;
  padding: 0px 3px 0px 0px;
  float: left;
}

div.rightside {
  margin-left: 45%;
  /* float: right; */
}

使用此方法，您可以在容器中写入您想要的所有内容（图像，链接、文本……它将正确显示。

Answer 2

这是一个有点老的问题，但现在这个问题的一个可能更好的答案是使用 https://sphinx-panels.readthedocs.io/en/latest/

该扩展提供了您在普通休息中没有的各种组件。

Answer 3

一种解决方案是使用 sphinx-design 扩展，它是面板的后继者。重要的是，这不需要您配置任何 html 或 css。

Answer 4

有几种方法可以做到这一点，因此您可以找到一个基于三列的 sphinx 主题（据我所知没有），或者作为 @Steve_Piercy 建议您可以创建自己的主题，这可能是一项艰巨的任务。但是，您可以使用选择的主题，只需调整 .rst 文件内容并覆盖您的主题即可以 3 列的方式显示内容。为此，您需要一些 HTML 和 CSS。

因此，首先您需要创建一个 test.rst ，其中的内容为 html 原始代码，如下所示：

Test
======

.. raw:: html

    <div class="row">
      <div class="column" style="background-color:#aaa;">
        <h2>Column 1</h2>
        <p>Some text..</p>
      </div>
      <div class="column" style="background-color:#bbb;">
        <h2>Column 2</h2>
        <p>Some text..</p>
      </div>
      <div class="column" style="background-color:#ccc;">
        <h2>Column 3</h2>
        <p>Some text..</p>
      </div>
    </div>

现在内容已准备就绪，我们在 _static/custom_style 下为其创建一个样式文件。 css 包含以下代码：

/* Create three equal columns that floats next to each other */
.column {
  float: left;
  width: 33.33%;
  padding: 10px;
  height: 500px;
}

/* Clear floats after the columns */
.row:after {
  content: "";
  display: table;
  clear: both;
}

最后一步是将此样式添加到您的 conf.py 文件中，以便将其添加到您的主题中。因此，在您的 conf.py 中添加以下行：

def setup(app):
    app.add_stylesheet('custom_style.css')

就是这样，现在运行并测试。输出应该看起来像这样（取决于您的主题）：

Answer 5

我不允许向 LudwigVonKoopa 接受的解决方案添加评论，但存在如何结束两列设置的问题。
除了已接受的解决方案之外，根据 SuperKogito 的答案，我将其添加到我的 css 文件中：

/* Clear floats after the columns */
div.after {
  content: "";
  display: table;
  clear: both;
}

这允许使用以下内容结束两列部分

.. |space| unicode:: U+0020 .. space

.. container:: twocol

    .. container:: leftside

       Left side text

    .. container:: rightside
     
       Right side text


.. container:: after

   |space|

。这不会在 html 输出中生成一行，但它会结束两列部分。