python - Docutils:rst2html 是否复制图像？

Question

rst2html 是否复制图像目录和图像路径？

我尝试了 rst2odt，它复制了图像。我未能达到 rst2html 的相同效果。

太疯狂了。它是一个文档工具，但我花了几个小时寻找这样一个核心问题的明确答案。

Answer 1

reStructuredText 标记语言包括image directive ,与基于 reStructuredText 构建的文档生成器一样，例如 Sphinx 。图像如何包含在输出中取决于输出格式。

例如，rst2odt程序不会复制图像目录或图像路径，它将实际图像复制到 ODT 文件中。 ODT files are just ZIP files with a particular structure ,这样您就可以解压 ODT 文件并在 Pictures/ 中查看图像。

相比之下，rst2html 程序不会将图像直接存储在 HTML 文件中因为这不是典型的 HTML。相反，它generates一个img tag指向图像。例如，这个标记:

.. image:: example.png

将生成以下 HTML:

<img alt="example.png" src="example.png" />

路径example.png是相对于源文件的路径示例，但是there are other options for img tags .

如果您想将图像直接嵌入到 HTML 文件中，例如 data URLs ,您需要做其他事情，例如:

1. 手动将图像转换为 Base64，使用它制作带有数据 URL 的 HTML img 标签，并使用以下命令将其包含在 reStructuredText 中: raw directive .

   例如，这个标记:

   .. raw:: html
   
       <img alt="red square" src="data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAGQAAABkAQMAAABKLAcXAAAAA1BMVEX/AAAZ4gk3AAAAFElEQVQ4 y2NgGAWjYBSMglFATwAABXgAASlxufwAAAAASUVORK5CYII=" />
   

   将生成以下 HTML:

   <img alt="red square" src="data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAGQAAABkAQMAAABKLAcXAAAAA1BMVEX/AAAZ4gk3AAAAFElEQVQ4 y2NgGAWjYBSMglFATwAABXgAASlxufwAAAAASUVORK5CYII=" />
   

   这将产生此图像:

   

2. 使用诸如SingleFile之类的工具, inliner ,或webpage2html至post-process the generated HTML .

请注意，数据 URL 存在限制，包括 browser-dependent size restrictions .

相关:

• Creating a self contained, offline HTML5 app and the best method for embedding its resources

• How to create MHTML standalone file with same page links

• How to save html pages as one file?

• What's the best "file format" for saving complete web pages (images, etc.) in a single archive?

• How to provide a web site as a single file?

• Embedding Base64 Images

• How to display Base64 images in HTML?

• Should I embed images as data/base64 in CSS or HTML

• Data protocol URL size limitations

• http://www.techerator.com/2011/12/how-to-embed-images-directly-into-your-html/

• https://www.davidbcalhoun.com/2011/when-to-base64-encode-images-and-when-not-to/