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

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

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

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


当前回答

你可以这样做:

git checkout --orphan assets
cp /where/image/currently/located/on/machine/diagram.png .
git add .
git commit -m 'Added diagram'
git push -u origin assets

然后,您可以在README文件中引用它,如下所示:

![diagram](diagram.png)

其他回答

这个对我有用!!!。

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

alt text是在图像URL不存在的情况下要显示的可选文本。

user_name是您的GitHub用户名。reponame是您的GitHub repo名称。

也可以使用相对路径,如

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

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

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

许多张贴的解决方案都不完整或不合我的口味。

像imgur这样的外部CDN为该链添加了另一个工具。无聊的。在问题跟踪程序中创建虚拟问题是一种黑客行为。它会造成混乱,让用户感到困惑。将此解决方案迁移到fork或脱离GitHub是一件痛苦的事。使用gh-pages分支会使URL变得脆弱。另一个在维护gh页面的项目中工作的人可能不知道一些外部信息,这取决于这些图像的路径。gh-pages分支在GitHub上有一个特殊的行为,这对于托管CDN图像是不必要的。在版本控制中跟踪资产是一件好事。随着项目的发展和变化,管理和跟踪多个用户的变化是一种更可持续的方式。如果图像适用于软件的特定版本,则最好链接不可变图像。这样,如果稍后更新图像以反映软件的更改,任何阅读该版本自述文件的人都会找到正确的图像。

受这一要点启发,我的首选解决方案是使用带有特定修订永久链接的资产分支。

git checkout --orphan assets
git reset --hard
cp /path/to/cat.png .
git add .
git commit -m 'Added cat picture'
git push -u origin assets
git rev-parse HEAD  # Print the SHA, which is optional, you'll see below.

构造一个“永久链接”到图像的这个版本,并将其包装在Markdown中。

然而,手动查找提交SHA是不方便的,因此,作为快捷键,按Y键可以永久链接到特定提交中的文件,正如这个help.github页面所说的那样。

要始终显示资产分支上的最新图像,请使用blob URL:

https://github.com/github/{repository}/blob/assets/cat.png 

(从同一个GitHub帮助页面,文件视图显示分支上的最新版本)

一步一步的过程,首先创建一个文件夹(命名您的文件夹),并添加要在Readme.md文件中上载的图像。(您也可以将图像添加到项目的任何现有文件夹中。)现在,单击Readme.md文件的编辑图标,然后

![](relative url where images is located/refrence_image.png)  // refrence_image is the name of image in my case.

添加图像后,您可以在“预览更改”选项卡中看到更改的预览。您可以在此处找到您的图像。例如像这样,在我的情况下,

![](app/src/main/res/drawable/refrence_image.png)

app文件夹->src文件夹->主文件夹->res文件夹->可绘制文件夹->和内部可绘制文件夹reference_image.png文件。要添加多个图像,可以这样做,

![](app/src/main/res/drawable/refrence_image1.png)
![](app/src/main/res/drawable/refrence_image2.png)
![](app/src/main/res/drawable/refrence_image3.png)

注意1-确保图像文件名不包含任何空格。如果它包含空格,则需要为文件名之间的每个空格添加%20。最好去掉空格。

注意2-您甚至可以使用HTML标记调整图像大小,或者有其他方法。你可以在谷歌上搜索更多。如果你需要的话。

之后,编写提交更改消息,然后提交更改。

还有很多其他的技巧,比如创建问题等等。到目前为止,这是我遇到的最好的方法。

最新的

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

现在您可以使用:

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

-OR-

遵循以下步骤:

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

参考文件。