将图像嵌入到GitHub Wiki(Gollum)存储库中?


84

Github Wiki由一个单独的git存储库和主项目存储库支持。

Github团队的帖子使您听起来应该可以链接到Wiki标记内的Wiki存储库中存储的图像。

图像和文件夹

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

我已经检出了Wiki的存储库,并将资源文件夹和图像推送到其中。我的问题是,如何使用该图像

这有可能还是我误解了?


有关于将图像添加到Wiki的github常见问题解答,但这里没有讨论有关较短的相对图像URL的信息
k3b 2015年

Answers:


57

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

[[foo.jpg]]

有关更多信息,请参见demo wiki的images页面


这比对路径进行硬编码更好。我唯一不知道的是如何使用此方法创建替代文本。哦,该演示中的图像不适合我。
詹姆斯·麦克马洪

如果克隆git://github.com/mojombo/gollum-demo.git然后运行gollum,您将看到它们。:)
本杰明·奥克斯

4
也许我遗漏了一些东西……但是[[wiki syntax]]这个维基中我可以帮助的作品: github.com/newhavenrb/conferences/wiki/WindyCityRails-2012 也许您正在使用自述文件进行尝试?
本杰明·奥克斯

2
Wiki语法由文件扩展名确定。.wiki使用mediawiki样式。.md使用markdown样式(RyanQ的答案)。
Drew Noakes 2014年

3
此答案不再起作用,请参阅下面的
@Werner

96

对于希望在github Wiki上查看图像的查看器,我发现以下方法可以工作:

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

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

  • 现在,在该存储库中创建一个图像目录,我将其称为“ images”,然后将所需的任何图像放入目录中

  • 然后将您的Wiki git目录推送到github
  • 您将无法在“页面”选项卡上实际看到图像,但是,如果仅在本地链接中引用图像,则应该能够看到它们。下面的Markdown示例:

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

  • 您还可以通过进一步包装图像来将图像嵌入为链接本身,如下所示:

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

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


31

在中添加图片时,没有答案似乎起作用readme.md。我有一个解决方案:

如果图片的网址是:

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

替换blobraw会给您原始图像的URL:

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

现在,您将使用普通的markdown嵌入图像:

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


太棒了...这使我可以直接在GitHub评论中链接到图像。:) github.com/mccalltd/AttributeRouting/issues/...
Leniel Maccaferri

1
为我工作,谢谢。可惜的是它不适合相对路径
Elvis Ciotti 2013年

26

相对路径对我来说像这样:

Wiki主页:

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

Wiki的子页面:

![text](images/someimage.png)

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


3
@Werner的技巧非常重要。(非常感谢!)由于某种原因,您的Wiki主页不同于其他所有主页,因此在主页上需要wiki / path / foo.ext,其中所有其他页面都使用path / foo.ext。回到您自己的仓库的相对引用比绝对引用要好得多。如果您移动或克隆您的项目,或者脱机修改它,则无论回购在何处,一切仍然有效。还要注意,这种[[text](link)语法)在大多数情况下都很好,但是如果需要对齐图像,则必须使用标准的HTML IMG标签。
TonyG '16

似乎这是最新的答案
albfan

这是什么分支
强尼

15

如果您想通过拖放快速上传图像,则可以执行以下操作(虽然有点黑):

创建一个虚拟问题;将图片拖放到此处;将上传的markdown图片代码复制/粘贴到您的Wiki;

一次创建问题后,可以多次使用它。

希望这可以帮助任何寻求快速修复的人,而无需将映像驻留在存储库中。


8

这是一种实用的方法:

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

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


2
谢谢!我想知道为什么github在其Wiki站点上不支持此功能。
Sven



2

最后,使用nerdwin描述的方法将图像放入存储库,并使用wiki将其显示在Wiki中。 ![test](test.jpg)


1

以下标记将引用相应GitHub Wiki中的GitHub存储库中的图像

![My Alt Text](../blob/master/Path/ToAsset/In/Repo.png?raw=true)

上面的示例假设您的存储库中具有以下文件结构

  • 路径
    • 资产
        • Repo.png

对于一个真实的示例,如果我想从相应的Wiki中引用github中的此图像,则可以使用此markdown

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

注意事项

  1. 案件很重要
  2. 如果您位于Wiki的特殊主页上,则不需要与../上一层。在上面的示例中,正确的链接是

对于主页:

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

案件很重要。Repo.png与repo.png不同
Josh

如果您位于Wiki主页上,则此更改会稍有变化。您需要删除../。链接为(blob / master / Path / ToAsset / In / Repo.png?raw = true)
乔什(Josh

托管映像的分支重要吗?
强尼

我没有尝试过,但是通过查看示例中的URL,我相信可以。在我的样本中,我假设一切都掌握了。您大概可以将示例中的“主”一词更改为图像所在的任何分支
Josh

1

使用相对路径

Wiki位于 [repositoryname]/wiki

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

因此,只需使用相对路径: ../raw/master/[file path in repository]


我必须../../在子页面中进行操作,所以请注意,它是相对于当前页面路径的
tutuDajuju

如果没有名为master的分支?
强尼

1

我将图像和PDF都放入了我的Wiki。我克隆了Wiki并添加imagesfiles目录,然后使用以下markdown嵌入图像链接并添加文件链接:

图片:

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

如果您的Wiki页面全部位于根目录级别,则不需要使用斜线,但是我使用子目录,并且绝对路径可以正确解析并保持简单。

档案:

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

请注意,Wikifiles路径中的前导斜杠不能正确解析为这种格式的链接。

我在GitHub要点中对此进行了详细记录


0

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


0

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

我要显示的图像的语法:

[[/images/imageName.png]]

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

wikiPage.md --> wikiPage.wiki

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

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

但:

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


0

许多答案对我没有用,这是最终有用的方法:

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

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

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

-约翰

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.