Github wiki 由一个单独的 git 存储库支持,然后是主项目存储库。
Github 团队的这篇文章听起来你应该能够链接到存储在 wiki 存储库中的 wiki 标记内的图像。
图像和文件夹
您现在可以引用托管在 Git 存储库中的图像。
我检查了我的 wiki 存储库并将资源文件夹和图像推入其中。我的问题是,我该如何使用这张图片?
这甚至可能还是我误解了什么?
Github wiki 由一个单独的 git 存储库支持,然后是主项目存储库。
Github 团队的这篇文章听起来你应该能够链接到存储在 wiki 存储库中的 wiki 标记内的图像。
图像和文件夹
您现在可以引用托管在 Git 存储库中的图像。
我检查了我的 wiki 存储库并将资源文件夹和图像推入其中。我的问题是,我该如何使用这张图片?
这甚至可能还是我误解了什么?
对于希望在 github wiki 上查看图像的查看者,我发现以下方法可行:
在您的本地机器上,使用您希望 cd 进入您选择的本地目录并通过以下方式获取存储库的任何 Git 命令行工具
git clone git@github.com:USER/REPO.wiki.git
现在在这个存储库中创建一个图像目录,我将其命名为“图像”并将您想要的任何图像放入目录中
您将无法实际看到“页面”选项卡中的图像,但如果您只是在本地链接中引用图像,您应该能够看到它们。下面的 Markdown 示例:
![Alt attribute text Here](images/YOURIMAGE.ext)
您还可以通过进一步包装图像将图像嵌入为链接本身,如下所示:
[![Alt attribute text Here](images/YOURIMAGE.ext)](http://Yoursite.com)
您还可以在本地副本中添加子目录来帮助组织 wiki,因为“页面”选项卡只是将它们列出来。但是请记住,即使推送了新目录,“页面”选项卡也不会列出该目录。
在readme.md
. 我有一个解决方案:
如果图片的 URL 是:
https://github.com/Username/Repository-Name/blob/master/Directory-Inside-Repository/image.png
替换blob
为raw
您提供原始图像的 URL:
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
相对路径对我来说是这样的:
维基主页:
![text](wiki/images/someimage.png)
维基子页面:
![text](images/someimage.png)
请注意,在进行预览时,图像不会显示,我已经保存了它。
如果您想通过拖放快速上传图像,您可以执行以下操作(尽管有点骇人听闻):
创建一个虚拟问题;将您的图像拖放到那里;将上传的 Markdown 图像代码复制/粘贴到您的 wiki;
创建问题一次后,您可以多次使用它来执行此操作。
希望这可以帮助任何寻求快速修复的人,而无需将图像驻留在存储库中。
这是一种实用的方法:
与@tiby 解决方案相比,您甚至不必创建或修改任何问题!
弄清楚了。
url 格式如下
https://raw.github.com/wiki/username/project/pathtoimage/imagename.extension
pathtoimage
是可选的
James 的 URL 格式对我不起作用,也许它已经改变了。我用过:
https://github.com/username/project/wiki/pathtoimage/image.extension
哪里pathtoimage
是可选的。
最后使用 nerdwin 描述的方法将图像放入存储库,并使用它们显示在 wiki 中![test](test.jpg)
以下降价将从您相应的 GitHub wiki中引用您的 GitHub存储库中的图像
![My Alt Text](../blob/master/Path/ToAsset/In/Repo.png?raw=true)
上面的示例假设您的存储库中有以下文件结构
对于一个真实世界的例子,如果我想从相应的 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)
我将图像和 PDF 都放在我的 wiki 中。我克隆 wiki 并添加一个images
和一个files
目录,然后使用以下 markdown 嵌入图像链接并添加文件链接:
图片:
[[/images/path/to/image.ext|ALT TEXT]]
如果您的 wiki 页面都位于根级别,则不需要前导斜杠,但我使用子目录并且绝对路径可以正确解析并保持简单。
文件:
[link text](files/path/to/file.ext "ALT TEXT")
请注意,wiki 路径没有前导斜杠files
以正确解析为这种格式的链接。
我在GitHub gist中更详细地记录了这一点
维基位于[repositoryname]/wiki
存储库中的文件位于[repositoryname]/raw/master/[file path in repository]
所以只需使用相对路径:../raw/master/[file path in repository]
要嵌入外部图像缩略图,请使用以下命令,
![Image](<external link to the image>)
@Drew Noakes对原始问题的评论对我来说是这样的:
我想显示的图像的语法:
[[/images/imageName.png]]
此图像仅在重命名时显示:
wikiPage.md --> wikiPage.wiki
wiki 存储库中使用了以下文件夹结构:
repository.wiki
|--wikiPage.wiki
|--images
|--imageName.png
但:
.wiki 中的语法与 .md 文件不同。
许多答案对我不起作用,这就是最终起作用的方法:
![](../raw/master/Images/ImportantImage.png)
使用“Markdown”编辑器模式和子页面,例如:
https://github.com/project/repo/wiki/MyPage