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

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

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

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


当前回答

如果您想显示任何网站上托管的图像(假设url为“http://abc.def.com/folder/image.jpg”),那么在README.md文件中使用以下语法:![alt-text](<http://abc.def.com/folder/image.jpg>)

只需在浏览器中浏览图像(可以通过单击图像)。它可以是任何网站,包括你的或其他人的github托管图像。从浏览器地址栏中复制url,即要在上述语法中使用的“image_url”。


对于托管在您自己的github存储库中的图像,除了上述url格式之外,您还可以使用相对路径![alt-text](<path_relative_to_current_github_location/image.jpg>)如果图像与README.md文件位于同一文件夹中(相对路径url的特殊情况),则可以使用:![alt-text](<image.jpg>)


注意url周围的尖括号“<”和“>”。有时,这些是url工作所必需的。

其他回答

这就行了!!

注意标记中的文件名大写,将PNG文件放入根目录,并链接到没有任何路径的文件名:

![Screenshot](screenshot.png)

尝试此标记:

![alt text](http://url/to/img.png)

我认为,如果图像存储在存储库中,您可以直接链接到原始版本的图像。即

![alt text](https://github.com/[username]/[reponame]/blob/[branch]/image.jpg?raw=true)

最新的

Wiki可以显示PNG、JPEG或GIF图像

现在您可以使用:

[[https://github.com/username/repository/blob/master/img/octocat.png|alt=octocat]]

-OR-

遵循以下步骤:

在GitHub上,导航到存储库的主页面。在存储库名称下,单击Wiki。使用wiki侧栏,导航到要更改的页面,然后单击“编辑”。在wiki工具栏上,单击“图像”。在“插入图像”对话框中,键入图像URL和替代文本(搜索引擎和屏幕阅读器使用)。单击“确定”。

参考文件。

在最新的Github中,我尝试了以上所有方法,但未能在自述文件页面上显示图像。如果是公共回购,我发现最好的方法是对master或main分支使用githubpages,然后引用自述文件中的链接。

步骤:

在您的存储库中,转到“代码和自动化”下的设置->选择页选择回购的来源和分支,然后单击保存

现在您的repo应该托管在(https://*username*.github.io/*repone*/)上

现在,您可以通过

![Preview Image](https://*username*.github.io/*reponame*/images/logo.PNG)

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

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