Встраивание изображений в репозиторий GitHub wiki (gollum)?
Вики-файлы Github поддерживаются отдельным репозиторием git, а затем основным репозиторием проекта.
этот пост команда Github делает это так, как будто вы должны иметь возможность ссылаться на изображения, хранящиеся в репозитории wiki внутри разметки wiki.
изображения и папки
теперь вы можете ссылаться на изображения, размещенные в репозитории Git.
Я проверил репозиторий моей Вики и толкнула папка ресурсов и изображение в нее. Мой вопрос в том,как я могу использовать это изображение?
Это вообще возможно или я что-то недопонимаю?
14 ответов:
для использования относительных путей выполните:
[[foo.jpg]]для получения дополнительной информации см. демо-страница Вики на изображениях.
для зрителей, желающих просматривать изображения на GitHub wiki я нашел следующий метод работы:
- перейдите на вкладку "Git Access" внутри вики-страницы вашего репозитория и получите SSH-путь, который должен быть чем-то вроде: [email protected]:USER/REPO.wiki.git где пользователь-это имя вашей учетной записи, а РЕПО-имя репозитория.
на вашем локальном компьютере используйте любой инструмент командной строки Git, который вы хотите записать в свой локальный каталог и получить репозиторий через
git clone [email protected]:USER/REPO.wiki.git
теперь в этом репозитории создайте каталог изображений, я буду называть его "изображения" и помещать любые изображения, которые вы хотите в каталог
- а затем нажмите свой каталог wiki git в github
вы не сможете физически видеть изображения на вкладке "страницы", но если вы просто ссылаетесь на изображения в локальной ссылке, вы должны быть в состоянии видеть их. Пример с уценкой ниже:
вы также можете встроить изображение в качестве самой ссылки, обернув его дальше следующим образом:
[](http://Yoursite.com)вы также можете добавить подкаталоги в вашей локальной копии, чтобы помочь организовать Вики, так как вкладка "страницы" просто перечисляет их. Имейте в виду, однако, что даже когда новый каталог нажимается вкладка "страницы" не перечисляет каталог.
ни один из ответов не работает при добавлении изображения в
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теперь вы вставляете изображение, используя обычную уценку:
обновление: на данный момент 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
относительный путь работает для меня такой:
главная страница Вики:
суб страницы:
обратите внимание, что при выполнении предварительного просмотра изображение не будет отображаться, я должен был сохранить его.
Если вы хотите быстро загрузить изображение с помощью перетаскивания, вы можете выполнить следующее (хотя и хакерское):
создайте фиктивную проблему; перетащите туда свое изображение; скопируйте / вставьте загруженный код изображения markdown в свою Вики;
после создания проблемы один раз, вы можете использовать его любое количество раз, чтобы сделать это.
надеюсь, что это поможет любому, кто ищет быстрое исправление, без необходимости иметь изображение находится в репо.
разобрался.
url-адрес имеет следующий формат
https://raw.github.com/wiki/username/project/pathtoimage/imagename.extension
pathtoimageнеобязательно
вот практический способ сделать это:
- перейти к любому вопросу на github
- В разделе комментариев Вы можете прикрепить файлы, просто перетащите, выберите или вставьте изображение
- скопируйте код / ссылку, отображаемую в текстовом поле
- вставьте его в вики
- профит !
вам даже не нужно создавать или изменять какие-либо проблемы по сравнению с @решение предлагается !
формат URL Джеймса не работал для меня, возможно, он был изменен. Я использовал:
https://github.com/username/project/wiki/pathtoimage/image.extension
здесь
pathtoimageне является обязательным.
наконец - то получил изображения в репозиторий с помощью метода, описанного nerdwin и получил их для отображения в Вики с помощью

следующая уценка будет ссылаться на изображение в вашем GitHub РЕПО из вашего соответствующего GitHub wiki
В приведенном выше примере предполагается, что у вас есть следующая структура файла в репозитории
- путь
- ToAssets
- In
- РЕПО.png
для примера реального мира, если бы я хотел для справки этот образ в github из соответствующей Вики, я бы использовал эту уценку
предостережения
- регистр
- если вы находитесь на специальной домашней странице Вики, вам не нужно подниматься на уровень ../ В моем примере выше, правильная ссылка будет
На Главной Странице:

используйте относительный путь
Вики находится по адресу
[repositoryname]/wikiфайлы в репозитории находятся по адресу
[repositoryname]/raw/master/[file path in repository]так что просто используйте относительный путь:
../raw/master/[file path in repository]
я помещаю как изображения, так и PDF-файлы в свои Вики. Я клонирую Вики и добавляю
imagesиfilesкаталог, затем используйте следующую разметку для вставки ссылок на изображения и добавления ссылок на файлы:изображение:
[[/images/path/to/image.ext|ALT TEXT]]ведущая косая черта не нужна, если все ваши вики-страницы находятся на корневом уровне, но я использую подкаталоги, а абсолютный путь правильно разрешает и упрощает вещи.
файлы:
[link text](files/path/to/file.ext "ALT TEXT")обратите внимание, нет косой черты на вики
filesпуть для правильного разрешения в качестве ссылки в этом формате.Я задокументировал это в GitHub gist
чтобы встроить эскиз внешнего изображения, используйте следующее,

комментарий от @Обратил Ноукс на первоначальный вопрос сделал это за меня:
синтаксис изображения, которое я хотел отобразить:
[[/images/imageName.png]]Это изображение отображалось только при переименовании:
wikiPage.md --> wikiPage.wikiв репозитории wiki использовалась следующая структура папок:
repository.wiki |--wikiPage.wiki |--images |--imageName.pngно:
синтаксис in .wiki отличается от файлов .md.
Comments