狮身人面像到乳胶图放置

Question

我正在尝试使用 Sphinx 生成 Latex 和 HTML 手册，但我在 Latex 中放置图形时遇到问题。 在狮身人面像中，我的数字如下：

.. figure:: _images/somepicture.png
    :figwidth: 100 %
    :width: 100 %
    :align: center

    some caption

这样当它写入 HTML 时，这些数字就会跨越整个页面的宽度。 这工作正常。

问题出在乳胶中，乳胶中的典型数字写为：

\begin{figure}[htbp]
\centering

\includegraphics[width=1.000\linewidth]{reset.png}
\end{figure}

问题在于 [htbp] 放置选项。 由于图像的长度是 \\linewidth，它们非常大，最终会浮动到下一页，并且文档中文本和图形的顺序通常不会保留在 pdf 输出中。 我想将 [htbp] 更改为 [H]。

我找到了一个选项，可以在名为“figure_align”的乳胶元素部分下放入 conf.py 文件，但是当我使用它时，它不起作用。 链接在这里http://sphinx.readthedocs.org/en/latest/config.html#options-for-latex-output

在我的 conf.py 文件中，我有以下内容：

latex_elements = {
# The paper size ('letterpaper' or 'a4paper').
#'papersize': 'letterpaper',

# The font size ('10pt', '11pt' or '12pt').
#'pointsize': '10pt',

# Additional stuff for the LaTeX preamble.
#'preamble':'',

#Figure placement within LaTeX paper NOT WORKING
'figure_align': 'H'

}

我的问题是，为什么这个选项不起作用，我该怎么做才能使它起作用？

Answer 1

修改 conf.py 时，您可能忘记了“H”后的逗号。

乳胶图（浮动）对齐

'figure_align': 'H',

在 sphinx-doc 版本 1.4.6 上对我有用。

'figure_align' Latex 图形浮动对齐，默认为 'htbp'（此处为顶部、底部、页面）。 每当图像不适合当前页面时，它就会“浮动”到下一页，但前面可能有任何其他文本。 如果您不喜欢这种行为，请使用“H”，这将严格按照它们在源中出现的顺序禁用浮动和定位数字。 参考 Sphinx-doc latex_element 。

Answer 2

我在这里找到了添加此功能的拉取请求： https : //bitbucket.org/birkenfeld/sphinx/pull-request/227/latex-allow-alternative-float-options-for/diff

我查看了我的源代码，发现我的 sphinx 版本没有在 writers 文件中包含乳胶元素“figure_align”。 我从拉取请求中添加了代码，现在可以使用了。

sphinx 的“构建配置文件”文档中声明的版本（可在此处找到）指出，所有乳胶元素选项都在 0.5 或更高版本中可用，似乎某些元素仅在更高版本的 sphinx 中添加。 我使用的是 1.2.2 版，并且“figure_align”不是有效的乳胶元素。

简而言之，我本可以升级到最新版本的 sphinx，但是我只是从拉取请求中添加了代码，现在它可以按预期工作。