最近我加入了GitHub。我在那里主持了一些项目。
我需要在README文件中包含一些图像。我不知道该怎么做。
我搜索了一下,但得到的只是一些链接,告诉我“在web上托管图像并在README.md文件中指定图像路径”。
是否有任何方法可以在不在任何第三方网络托管服务上托管图像的情况下做到这一点?
最近我加入了GitHub。我在那里主持了一些项目。
我需要在README文件中包含一些图像。我不知道该怎么做。
我搜索了一下,但得到的只是一些链接,告诉我“在web上托管图像并在README.md文件中指定图像路径”。
是否有任何方法可以在不在任何第三方网络托管服务上托管图像的情况下做到这一点?
当前回答
无需编写任何代码。GitHub上的自述文件现在支持拖放
打开README.md文件单击“编辑此文件”拖放图像单击提交更改
其他回答
在文件夹(myFolder)中提交图像(image.png),并在README.md中添加以下行:
![可选文本](../master/myFolder/image.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帮助页面,文件视图显示分支上的最新版本)
我们可以简单地做到这一点,
在GitHub上创建新问题在Issue的body div上拖放图像
几秒钟后,将生成一个链接。现在,复制链接或图像URL并使用任何支持的平台。
如果添加多个屏幕截图并希望使用表格数据对齐它们以提高可访问性,请考虑使用表格,如下所示:
如果markdown解析器支持它,您还可以将role=“presentation”WIA-ARIA属性添加到TABLE元素,并省略th标记。
您可以使用
![A test image](image.png)
哪里[A test image]是您的alt文本,(image.png)是您图像的链接。
您可以将图像放在云服务或其他在线图像托管平台上或者,如果存储库中有图像链接,则可以从存储库中提供图像链接
您还可以在存储库中创建专用于自述文件图像的特定文件夹