狮身人面像到乳胶图放置

Alex 发表于 Dev

亚历克斯

我正在尝试使用Sphinx生成乳胶和HTML手册，但乳胶中的图形放置存在问题。在Sphinx中，我的数据如下：

.. 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'

}

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

亚历克斯

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

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

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

简而言之，我本可以升级到最新版本的sphinx，但是我只是从pull请求中添加了代码，并且现在可以正常工作了。

本文收集自互联网，转载请注明来源。

如有侵权，请联系[email protected] 删除。