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

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

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

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


当前回答

您还可以添加带有简单HTML标记的图像:

<p align="center">
  <img src="your_relative_path_here" width="350" title="hover text">
  <img src="your_relative_path_here_number_2_large_name" width="350" alt="accessibility text">
</p>

其他回答

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

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

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

您还可以添加带有简单HTML标记的图像:

<p align="center">
  <img src="your_relative_path_here" width="350" title="hover text">
  <img src="your_relative_path_here_number_2_large_name" width="350" alt="accessibility text">
</p>

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

一旦您将图像放到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位于根目录中。

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

像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文件中包含一些图像。我不知道该怎么做这样做。

我创建了一个小向导,允许您为GitHub存储库的自述文件创建和自定义简单的图像库:请参阅ReadmeGalleryCreatorForGitHub。

该向导利用了GitHub允许img标签出现在README.md中的事实。此外,该向导还利用了将图像上传到GitHub的流行技巧,方法是将图像拖放到问题区域(如本主题的一个答案中所述)。