最近我加入了GitHub。我在那里主持了一些项目。

我需要在README文件中包含一些图像。我不知道该怎么做。

我搜索了一下,但得到的只是一些链接,告诉我“在web上托管图像并在README.md文件中指定图像路径”。

是否有任何方法可以在不在任何第三方网络托管服务上托管图像的情况下做到这一点?


当前回答

我通常在网站上托管图像,这可以链接到任何托管图像。把这个放在自述文件里。适用于.rst文件,不确定.md

.. image:: https://url/path/to/image
   :height: 100px
   :width: 200 px
   :scale: 50 %

其他回答

还有一个选项我还没有看到。您可以简单地在用户或组织下创建另一个名为“资产”的存储库。将您的图像推送到此回购,并从其他回购中引用它们:

![alt text](https://raw.githubusercontent.com/my-org/assets/master/folder/logo.png)

我在我的一次回购中做了这件事,它很适合我。我可以独立于我的代码为我的所有项目版本我的README图像,但仍然将它们保存在一个地方。不需要问题、分支或其他容易错位的工件。

也可以使用相对路径,如

![Alt text](relative/path/to/img.jpg?raw=true "Title")

还可以使用所需的.fileExtetion尝试以下操作:

![plot](./directory_1/directory_2/.../directory_n/plot.png)

我只是在已经接受的答案上延伸或添加一个例子。

一旦您将图像放到Github存储库中。

然后:

在浏览器上打开相应的Github repo。导航到目标图像文件,然后在新选项卡中打开图像。复制url最后将url插入到以下模式![替换文本](https://raw.githubusercontent.com/username/projectname/branch/path/to/img.png)

就我的情况而言

![在一张图片中](https://raw.githubusercontent.com/shadmazumder/Xcode/master/InOnePicture.png)

哪里

shadmazumder是我的用户名Xcode是项目名称master是分支InOnePicture.png是图像,在我的情况下,InOnePicture.php位于根目录中。

非常简单:可以使用Ctrl+C/V完成

这里的大多数答案都是直接或间接地将图像上传到其他地方,然后提供链接。

只需复制任何图像并在编辑Readme.md时粘贴即可完成

复制图像-您只需单击图像文件并使用Ctrl+C,也可以使用剪切工具将截图图像复制到剪贴板然后,您可以在编辑Readme.md时简单地按Ctrl+V

Guithub将自动将其上传到user-images.githubusercontent.com,并在那里插入指向它的链接

您可以使用替代的github CDN链接从README.md(或外部)链接到项目中的图像。

URL将如下所示:

https://cdn.rawgit.com/<USER>/<REPO>/<BRANCH>/<PATH>/<TO>/<FILE>

我的项目中有一个SVG图像,当我在Python项目文档中引用它时,它不会呈现。

项目链接

以下是文件的项目链接(不渲染为图像):

https://github.com/jongracecox/anybadge/blob/master/examples/awesomeness.svg

嵌入图像示例:

原始链接

以下是指向文件的RAW链接(仍然无法渲染为图像):

https://raw.githubusercontent.com/jongracecox/anybadge/master/examples/awesomeness.svg

嵌入图像示例:

CDN链接

使用CDN链接,我可以使用(渲染为图像)链接到文件:

https://cdn.rawgit.com/jongracecox/anybadge/master/examples/awesomeness.svg

嵌入图像示例:

这就是我如何在README.md文件和PyPi项目reStructedText doucmentation(此处)中使用项目中的图像