是否可以在一个GitHub存储库的README文件中放置一个截图?语法是什么?
当前回答
我的图像在名称中有空格,例如,粘贴图像20221006123035.png,这导致了我的问题,我失去了一些时间来修复它。如果有人有同样的问题,那么下面是步骤
我通过上传选项上传了图像 然后在网站的文件浏览UI中点击图片。 图像在浏览器中打开。从浏览器的URL复制图像的URL。您可以复制整个路径,或相对于您的.md文件 现在像这样插入。md文件的链接![概述](粘贴%20image%2020221006123035.png)
其他回答
对我来说,相对路径非常有效。
我是怎么做到的: 在我当前的md文件中,我想使用来自另一个目录的图片,我使用了这样的相对路径-考虑以下点。
Md文件loc: base dir -> _post -> current_file.md
&图片文件loc,我想使用:基础dir -> _asset -> picture_to_use.jpeg
我使用的语句是在current_file上。md文件:
![your-pic-caption-name](../_asset/picture_to_use.jpeg)
注意-在此之前,我使用的是direct _asset,但理想情况下,它从../_asset/and-so-no开始
参考资料- https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-readmes
用于显示图像的markdown语法确实是:
![image](https://{url})
但是:如何提供url ?
你可能不想用截图把你的回购弄得乱七八糟,它们和代码没有任何关系 你可能不想处理把你的图片放到网上的麻烦。(上传到服务器…).
所以…你可以使用这个很棒的技巧让github托管你的图像文件。TDLR:
在回购的问题列表上创建一个问题 在这个问题上拖放你的截图 复制标记代码,github刚刚为你创建显示你的图像 将其粘贴到您的自述文件(或任何您想要的地方)
http://solutionoptimist.com/2013/12/28/awesome-github-tricks/
如果您使用Markdown (README.md):
如果你有图片在你的repo,你可以使用一个相对URL:
![Alt text](/relative/path/to/img.jpg?raw=true "Optional Title")
如果您需要嵌入托管在其他地方的图像,则可以使用完整的URL
![Alt text](http://full/path/to/img.jpg "Optional title")
GitHub建议使用带?raw=true参数的相对链接,以确保fork回购点正确。
raw=true参数的存在是为了确保你链接到的图像将会按原样呈现。这意味着只有图像将被链接,而不是相应文件的整个GitHub界面。更多细节请看这条评论。
请看一个例子:https://raw.github.com/altercation/solarized/master/README.md
如果你使用svg,那么你也需要将sanitize属性设置为true: ?raw=true&sanitize=true。(感谢@EliSherer)
另外,README文件中有关相对链接的文档:https://help.github.com/articles/relative-links-in-readmes
当然还有降价文档:http://daringfireball.net/projects/markdown/syntax
此外,如果您创建了一个新的分支屏幕截图来存储图像,您可以避免它们在主工作树中
然后你可以使用以下方法嵌入它们:
![Alt text](/../<branch name>/path/to/image.png?raw=true "Optional Title")
对我来说,最好的办法是
用github上的存储库创建一个新问题,然后以gif格式上传文件。要将视频文件转换为gif格式,您可以使用这个网站http://www.online-convert.com/ 提交新创建的问题。 复制上传文件的地址 最后在你的README文件中放入!
希望这能有所帮助。
在存储库中从上传文件选项添加图像,然后在README文件中
![Alt text]("enter image url of repositoryhere")
推荐文章
- 在Markdown中创建一个没有标题的表
- 强制LF eol在git的回购和工作副本
- 防止在GitHub上推送到master ?
- 我如何在github上引用特定问题的评论?
- 我如何才能看到我在Github上看到的所有问题?
- R -降价避免包装加载消息
- 在GitHub上链接到其他Wiki页面?
- 你如何跟踪你对GitHub问题的评论?
- 我如何在GitHub中为其他人的代码做出贡献?
- GitHub项目和里程碑之间的区别/关系是什么?
- gitignore是什么?
- 在MarkDown中包含SVG(托管在GitHub上)
- 新Github项目发布通知?
- 如何在本地删除分支?
- GitHub.com的存储库大小限制