在GitHub wiki(gollum)存储库中embedded图像?
Github wiki由单独的git存储库和主项目存储库提供支持。
Github团队发布的这篇文章听起来像是应该能够链接到wiki标记中存储在wiki库中的图像。
图像和文件夹
您现在可以引用Git存储库内托pipe的图像。
我已经检出了我的维基库,并把一个资源文件夹和一个图像放到里面。 我的问题是, 我怎么去使用这个图像 ?
这是甚至可能或者我误解了一些东西?
要使用相对path:
[[foo.jpg]]
有关更多信息,请参阅图像上的演示wiki页面 。
对于希望在github wiki上查看图像的用户,我发现了以下方法:
- 转到存储库的wiki页面中的“Git Access”选项卡,并检索应该是这样的东西的SSHpath:git@github.com:USER / REPO.wiki.git其中USER是您的帐户名称,REPO是存储库名称。
-
在你的本地机器上,使用你希望将每个Git命令行工具放到你select的本地目录中,并通过它来获取存储库
git clone git@github.com:USER / REPO.wiki.git
-
现在在这个存储库中创build一个图像目录,我将它称为“图像”,并把你想要的任何图像到目录中
- 然后把你的wiki git目录推到github上
-
您将无法在“页面”选项卡中看到图像,但是如果只是在本地链接中引用图像,则应该能够看到它们。 以下是Markdown的例子:
![Alt attribute text Here](images/YOURIMAGE.ext)
-
您也可以通过如下方式将图像作为链接自身embedded:
[![Alt attribute text Here](images/YOURIMAGE.ext)](http://Yoursite.com)
您也可以在本地副本中添加子目录,以帮助组织维基,因为“页面”选项卡将其列出。 但请记住,即使在新目录被按下时,“页面”选项卡也不会列出目录。
在readme.md
添加图像时似乎没有任何答案。 我有一个解决scheme,但:
如果图像的URL是:
https://github.com/Username/Repository-Name/blob/master/Directory-Inside-Repository/image.png
使用raw
replaceblob
会为您提供原始图像的URL:
https://github.com/Username/Repository-Name/raw/master/Directory-Inside-Repository/image.png
现在,您将使用普通的markdownembedded图像:
![Image Alt](https://github.com/Username/Repository-Name/raw/master/Directory-Inside-Repository/image.png)
更新:截至目前,GitHub还提供来自不同子域raw.github.com
原始图像。 所以,你也可以使用:
https://raw.github.com/Username/Repository-Name/master/Directory-Inside-Repository/image.png
示例: https://raw.github.com/Automattic/liveblog/master/screenshot-1.png
: https://raw.github.com/Automattic/liveblog/master/screenshot-1.png
相对path为我这样工作:
维基的主页:
![text](wikihttp://img.dovov.comsomeimage.png)
维基的子页面:
![text](images/someimage.png)
请注意,在预览时,图像不会显示,我已经保存了。
如果您想通过拖/放方式快速上传图片,可以执行以下操作(尽pipe如此):
创build一个虚拟的问题; 在那里拖放你的图像; 将上传的降价图片代码复制/粘贴到您的wiki;
创build问题一次后,您可以使用任意次数来执行此操作。
希望这有助于任何寻找快速修复的人,而不需要将图像驻留在回购站中。
弄清楚了。
url格式如下
https://raw.github.com/wiki/username/project/pathtoimage/imagename.extension
pathtoimage
是可选的
詹姆斯的URL格式不适合我,也许它已经改变。 我用过:
https://github.com/username/project/wiki/pathtoimage/image.extension
pathtoimage
是可选的。
最后使用nerdwin描述的方法将图像存入存储库,并使用![test](test.jpg)
test.jpg)将它们显示在wiki中
下面的markdown会在你的相应的GitHub wiki中引用你的GitHub 仓库中的一个图像
![My Alt Text](../blob/master/Path/ToAsset/In/Repo.png?raw=true)
上面的例子假设你在你的仓库中有以下的文件结构
- path
- ToAssets
- 在
- Repo.png
- 在
- ToAssets
对于一个真实世界的例子,如果我想在相应的wiki的github中引用这个图像 ,我会使用这个markdown
![Azure App Settings](../blob/master/TrelloWorld/TrelloWorld.Server/Assets/Azure_AppSettings.png?raw=true)
注意事项
- 案件事宜
- 如果你在维基的特殊主页,你不需要上.. ..在上面的例子中,正确的链接将是
首页:
![Azure App Settings](blob/master/TrelloWorld/TrelloWorld.Server/Assets/Azure_AppSettings.png?raw=true)
要embedded外部图像缩略图,请使用以下内容: ![Image](<external link to the image>)
使用相对path
Wiki位于[repositoryname]/wiki
存储库中的文件位于[repositoryname]/raw/master/[file path in repository]
因此,只需使用相对path: ../raw/master/[file path in repository]
我把我的维基上的图像和PDF文件。 我克隆维基并添加一个images
和一个files
目录,然后使用下面的markdown来embedded图像链接并添加文件链接:
图片:
[[http://img.dovov.compath/to/image.ext|ALT TEXT]]
如果您的维基页面全部位于根级别,则不需要使用前导斜杠,但是我使用子目录和绝对path正确parsing并保持简单。
文件:
[link text](files/path/to/file.ext "ALT TEXT")
请注意,对于wiki files
path,没有引导斜线可正确parsing为此格式的链接。
我在GitHub的要点中logging了这一点
@ Drew Noakes对原来的问题的评论对我来说是这样的:
我想要显示的图像的语法:
[[http://img.dovov.comimageName.png]]
此图像仅在重命名时显示:
wikiPage.md --> wikiPage.wiki
wiki资料库中使用了以下文件夹结构:
repository.wiki |--wikiPage.wiki |--images |--imageName.png
但:
.wiki中的语法与.md文件不同。
这是一个切实可行的方法:
- 去github上的任何问题
- 在评论部分,您可以附加文件,只需拖放,select或粘贴您的图像
- 复制在textarea中显示的代码/链接
- 将其粘贴到wiki中
- 利润!
与@tiby解决scheme相比,您甚至不必创build或修改任何问题!