文档：rst2html是否复制图像？

Question

rst2html是否复制图像目录和图像路径？你知道吗

我试过rst2odt，它会复制图像。对于rst2html，我没有达到同样的效果。你知道吗

太疯狂了。它是一个文档工具，但我花了几个小时寻找这样一个中心问题的最终答案。你知道吗

Answer 1

重构文本标记语言 包括^{} directive， 以及基于重构文本构建的文档生成器，例如 Sphinx。 图像如何包含在输出中 取决于输出格式。你知道吗

例如，rst2odt程序不复制映像目录或映像路径， 它将实际图像复制到ODT文件中。 ODT files are just ZIP files with a particular structure， 因此，您可以解压缩ODT文件并查看Pictures/中的图像。你知道吗

相比之下，rst2html程序不直接在HTML文件中存储图像 因为这不是典型的HTML。 相反，它generates 安^{} 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标记，并使用 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/