在GitHub wiki(gollum)存储库中嵌入图像?

时间:2012-04-06 15:22:24

标签: github wiki gollum-wiki

Github wiki由一个单独的git存储库支持,然后是主项目存储库。

Github团队的

This post让你觉得你应该可以链接到wiki标记内的wiki存储库中存储的图像。

  

图片和文件夹

     

您现在可以引用Git存储库中托管的图像。

我已经检查了我的wiki的存储库,并将资源文件夹和图像压入其中。我的问题是,如何使用此图片

这甚至可能还是我误解了什么?

15 个答案:

答案 0 :(得分:93)

对于希望在github wiki上查看图像的观众,我发现了以下方法:

  • 转到存储库的wiki页面中的“Git Access”选项卡并检索SSH路径,该路径应该是:git@github.com:USER / REPO.wiki.git其中USER是您的帐户名称, REPO是存储库名称。
  • 在本地计算机上使用您想要的任何Git命令行工具进入您选择的本地目录并通过

    获取存储库
      

    git clone git@github.com:USER / REPO.wiki.git

  • 现在在这个存储库中创建一个图像目录,我将其称为“图像”,并将您想要的任何图像放入目录

  • 然后将您的wiki git目录推送到github
  • 您无法在“页面”标签中查看图像,但如果您只是在本地链接中引用图像,则应该能够看到它们。以下Markdown示例:

    ![Alt attribute text Here](images/YOURIMAGE.ext)

  • 您也可以将图像作为链接嵌入,方法如下:

    [![Alt attribute text Here](images/YOURIMAGE.ext)](http://Yoursite.com)

您还可以在本地副本中添加子目录以帮助组织Wiki,因为“页面”选项卡只是简单地列出它们。但请记住,即使按下新目录,“页面”选项卡也不会列出目录。

答案 1 :(得分:53)

要使用相对路径,请执行以下操作:

[[foo.jpg]]

有关详细信息,请参阅demo wiki's page on images

答案 2 :(得分:30)

readme.md中添加图片时,似乎没有任何答案可行。我有一个解决方案:

如果图片的网址是:

https://github.com/Username/Repository-Name/blob/master/Directory-Inside-Repository/image.png

blob替换raw会为您提供原始图片的网址:

https://github.com/Username/Repository-Name/raw/master/Directory-Inside-Repository/image.png

现在,您使用正常降价来嵌入图像:

![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

答案 3 :(得分:25)

像我这样的相对路径工作:

维基的主页:

![text](wiki/images/someimage.png)

维基的子页面:

![text](images/someimage.png)

请注意,在进行预览时图像不会显示,我已将其保存。

答案 4 :(得分:14)

如果您想通过拖放快速上传图片,可以执行以下操作(尽管是hackish):

创建一个虚拟问题;拖拽放下你的形象;将上传的降价图像代码复制/粘贴到您的维基;

创建一次问题后,您可以多次使用它来执行此操作。

希望这可以帮助任何寻找快速修复的人,而无需将图像驻留在回购中。

答案 5 :(得分:7)

这是一种实用的方法:

  • 转到github上的任何问题
  • 在评论部分,您可以附加文件,只需拖放,选择或粘贴图片
  • 复制textarea
  • 中显示的代码/链接
  • 将其粘贴到维基
  • 利润!

与@tiby解决方案相比,您甚至不必创建或修改任何问题!

答案 6 :(得分:6)

想出来。

网址格式如下

  

https://raw.github.com/wiki/username/project/pathtoimage/imagename.extension

pathtoimage是可选的

答案 7 :(得分:5)

詹姆斯的网址格式对我不起作用,也许它已经改变了。我用过:

  

https://github.com/username/project/wiki/pathtoimage/image.extension

pathtoimage是可选的。

答案 8 :(得分:2)

最后使用nerdwin描述的方法将图像放入存储库,并使用![test](test.jpg)

将它们显示在wiki中

答案 9 :(得分:1)

以下降价将在相应的GitHub wiki

中引用GitHub repo 中的图片
![My Alt Text](../blob/master/Path/ToAsset/In/Repo.png?raw=true)

上面的示例假设您的repo中有以下文件结构

  • 路径
    • ToAssets
        • Repo.png

对于一个真实世界的例子,如果我想在相应的wiki中引用github中的this image,我会使用这个降价

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

<强>注意事项

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

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

答案 10 :(得分:1)

我将两张图片和PDF放在我的wiki中。我克隆了wiki并添加了imagesfiles目录,然后使用以下markdown来嵌入图片链接并添加文件链接:

图片:

[[/images/path/to/image.ext|ALT TEXT]]

如果您的维基页面都在根级别,则不需要前导斜杠,但我使用子目录并且绝对路径正确解析并保持简单。

文件:

[link text](files/path/to/file.ext "ALT TEXT")

请注意,wiki files路径没有前导斜杠可以正确解析为此格式的链接。

我在GitHub gist

中详细记录了这一点

答案 11 :(得分:1)

使用相对路径

Wiki位于[repositoryname]/wiki

存储库中的文件位于[repositoryname]/raw/master/[file path in repository]

所以只需使用相对路径:../raw/master/[file path in repository]

答案 12 :(得分:0)

要嵌入外部图像缩略图,请使用以下方法, ![Image](<external link to the image>)

答案 13 :(得分:0)

@ Drew Noakes对原始问题的评论为我做了:

我想要显示的图像的语法:

[[/images/imageName.png]]

此图像仅在重命名时显示:

wikiPage.md --> wikiPage.wiki

wiki存储库中使用了以下文件夹结构:

repository.wiki
   |--wikiPage.wiki
   |--images
        |--imageName.png       

<强> BUT:

.wiki中的语法与.md文件不同。

答案 14 :(得分:0)

许多答案对我都无效,这是最终有效的方法:

![](../raw/master/Images/ImportantImage.png)

使用“降价”编辑器模式和一个子页面,例如:

https://github.com/project/repo/wiki/MyPage

-约翰