在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 

使用rawreplaceblob会为您提供原始图像的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

对于一个真实世界的例子,如果我想在相应的wiki的github中引用这个图像 ,我会使用这个markdown

 ![Azure App Settings](../blob/master/TrelloWorld/TrelloWorld.Server/Assets/Azure_AppSettings.png?raw=true) 

注意事项

  1. 案件事宜
  2. 如果你在维基的特殊主页,你不需要上.. ..在上面的例子中,正确的链接将是

首页:

 ![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 filespath,没有引导斜线可正确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或修改任何问题!