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

Jam*_*hon 79 wiki github gollum-wiki

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

Github团队的这篇文章听起来像你应该能够链接到维基标记内的维基存储库中存储的图像.

图像和文件夹

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

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

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

Rya*_*n Q 94

对于希望在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,因为"页面"选项卡只是简单地列出它们.但请记住,即使按下新目录,"页面"选项卡也不会列出目录.


Ben*_*kes 53

使用相对路径做:

[[foo.jpg]]
Run Code Online (Sandbox Code Playgroud)

有关详细信息,请参阅图像上demo wiki页面.

  • 这个例子似乎不再起作用了. (52认同)
  • 也许我错过了一些东西......但是`[[wiki syntax]]`在我帮助的这个wiki中起作用:https://github.com/newhavenrb/conferences/wiki/WindyCityRails-2012也许你正在尝试这与自述文件? (4认同)
  • 这个答案不再有效,请参阅下面的@Werner答案(简而言之,使用![text](images/someimage.png)并保存 - 预览时不会显示) (3认同)
  • Wiki语法由文件扩展名决定.`.wiki`使用mediawiki风格.`.md`使用降价式(RyanQ的回答). (2认同)

its*_*_me 30

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

如果图像的URL是:

https://github.com/Username/Repository-Name/blob/master/Directory-Inside-Repository/image.png
Run Code Online (Sandbox Code Playgroud)

更换blobraw为您提供了原始图像的URL:

https://github.com/Username/Repository-Name/raw/master/Directory-Inside-Repository/image.png
Run Code Online (Sandbox Code Playgroud)

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

![Image Alt](https://github.com/Username/Repository-Name/raw/master/Directory-Inside-Repository/image.png)
Run Code Online (Sandbox Code Playgroud)

更新:截至目前,GitHub还提供来自不同子域的原始图像raw.github.com.所以,你也可以使用:

https://raw.github.com/Username/Repository-Name/master/Directory-Inside-Repository/image.png
Run Code Online (Sandbox Code Playgroud)

例: https://raw.github.com/Automattic/liveblog/master/screenshot-1.png


Wer*_*ner 25

相对路径对我来说是这样的:

维基的主页:

![text](wiki/images/someimage.png)
Run Code Online (Sandbox Code Playgroud)

维基的子页面:

![text](images/someimage.png)
Run Code Online (Sandbox Code Playgroud)

请注意,在进行预览时图像不会显示,我保存了它.

  • @Werner的这个提示非常重要.(非常感谢!)由于某种原因,你的wiki的主页与其他主页不同,所以在主页上你需要**wiki/path/foo.ext**其他所有页面都使用**path/foo .EXT**.返回到您自己的repo的相对引用比绝对引用要好得多.如果移动或克隆项目,或者离线修改项目,无论回购地点在哪里,一切仍然有效.另请注意,此![text](链接)语法适用于大多数用途,但如果您需要对齐图像,则必须使用标准的HTML IMG标记. (3认同)

小智 14

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

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

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

希望这有助于任何人寻找快速修复,而无需将图像驻留在回购中.


小智 8

这是一种实用的方法:

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

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

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

Jam*_*hon 6

弄清楚了.

网址格式如下

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

pathtoimage 是可选的

  • 这有效,但与GitHub存储文件的方式紧密相关.如果他们改变了路径,那就会破裂.当通过`gollum`在本地运行wiki时,它也会破坏. (3认同)

Nin*_*non 5

詹姆斯的URL格式对我不起作用,也许它已被改变.我用过:

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

哪里pathtoimage可选.