如何将本地文件系统图片插入RhodeCode拉取请求评论

核心结论 #

不能直接将本地文件系统中的图片嵌入到RhodeCode拉取请求评论中，必须先将图片上传至可公开访问的网络位置，再通过网络链接嵌入。

原因说明 #

RhodeCode的评论渲染逻辑在服务器端执行，服务器无法访问你本地的文件系统路径（如C:\image.png）。无论使用loading: embed参数还是引号包裹路径，都无法让服务器读取到你本地的图片文件，因此会显示为空评论块。

可行方案 #

使用你已经验证有效的网络图片嵌入语法即可：

.. image:: https://www.website.com/pathToImage

参数澄清 #

:loading: embed参数仅适用于本地构建reStructuredText文档的场景（比如嵌入与文档同目录的本地图片），目的是将图片直接打包到生成的HTML/PDF中。但该参数无法作用于RhodeCode评论系统，因为服务器没有你的本地图片资源。

内容的提问来源于stack exchange，提问作者SeanTwomey