Встраивание изображений в репозиторий GitHub wiki (gollum)?

В вики Github поддерживается отдельный репозиторий git, а затем основной репозиторий проекта.

Этот пост от команды Github звучит так, как будто вы должны иметь возможность ссылаться на изображения, хранящиеся в репозитории wiki внутри разметки wiki.

Изображения и папки

Теперь вы можете ссылаться на изображения, размещенные внутри репозитория git.

Я проверил мой репозиторий wiki и нажал папку с ресурсом и изображение. Мой вопрос: как я могу использовать этот образ?

Возможно ли это, или я что-то не понял?

Ответ 2

Для зрителей, желающих просматривать изображения на вики-сайте github, я нашел следующий метод для работы:

  • Перейдите на вкладку "Git Access" на вики-странице вашего репозитория и найдите путь SSH, который должен выглядеть примерно так: [email protected]: USER/REPO.wiki.git, где USER - это имя вашей учетной записи, а REPO - это имя хранилища.
  • На вашем локальном компьютере используйте любой инструмент командной строки Git, который вы хотите, чтобы перейти в выбранный локальный каталог и получить репозиторий через

    git clone [email protected]: ПОЛЬЗОВАТЕЛЬ /REPO.wiki.git

  • Теперь внутри этого репозитория создайте каталог изображений, я назову его "images" и помещу в каталог любые изображения, которые вы хотите.

  • А затем перенесите свой каталог вики-git на github
  • Вы не сможете физически видеть изображения, скажем, на вкладке "Страницы", но если вы просто будете ссылаться на изображения в локальной ссылке, вы сможете их увидеть. Пример с уценкой ниже:

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

  • Вы также можете встроить изображение как саму ссылку, обернув его следующим образом:

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

Вы также можете добавить подкаталоги в свою локальную копию, чтобы упростить организацию вики, поскольку вкладка "страницы" просто перечисляет их. Имейте в виду, однако, что даже когда новая папка нажата, вкладка "страницы" не перечисляет каталог.

Ответ 3

Кажется, что ни один из ответов не работает при добавлении изображения в 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

Ответ 4

Относительный путь работает для меня следующим образом:

домашняя страница вики:

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

подстраница wiki:

![text](images/someimage.png)

Обратите внимание, что при выполнении предварительного просмотра изображение не будет отображаться, я сохранил его.

Ответ 5

Если вы хотите быстро загрузить изображение с помощью перетаскивания, вы можете выполнить следующее (хотя и хакерское):

Создайте фиктивную проблему; перетащите изображение туда; скопируйте/вставьте загруженный код изображения уценки в свою вики;

После создания проблемы один раз вы можете использовать его сколько угодно раз для этого.

Надеемся, что это поможет любому, кто ищет быстрое исправление, не требуя, чтобы изображение находилось в репо.

Ответ 6

Вот практический способ сделать это:

  • Перейти к любой проблеме github
  • В разделе комментариев вы можете прикреплять файлы, просто перетаскивайте, выберите или вставьте свое изображение.
  • Скопируйте код/​​ссылку, отображаемую в текстовом поле
  • Вставить его в wiki
  • Прибыль!

Вам даже не нужно создавать или изменять какие-либо проблемы по сравнению с решением @tiby!

Ответ 9

Наконец, загрузили изображения в хранилище, используя метод, описанный nerdwin, и заставили их отображать в вики, используя ![test](test.jpg)

Ответ 10

Следующая уценка будет ссылаться на изображение в вашем GitHub repo из вашей соответствующей вики-страницы GitHub

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

В приведенном выше примере предполагается, что у вас есть следующая файловая структура в вашем репо

  • Путь
    • ToAssets
      • В
        • Repo.png

Для примера в реальном мире, если я хотел бы ссылаться на это изображение в github из соответствующей вики, я бы использовал эту уценку

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

Ответ 11

Я помещаю изображения и PDF файлы в свои вики. Я клонирую вики и добавляю каталог images и files, а затем использую следующую разметку для встраивания ссылок на изображения и добавления ссылок на файлы:

Изображений:

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

Начальная косая черта не обязательна, если все ваши вики-страницы находятся на корневом уровне, но я использую подкаталоги, а абсолютный путь разрешается правильно и делает вещи простыми.

файлы:

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

Обратите внимание, что для правильного разрешения пути вики- files в качестве ссылки в этом формате нет косой черты.

Я задокументировал это более подробно в GitHub Gist

Ответ 12

Используйте относительный путь

Wiki находится в [repositoryname]/wiki

Файлы в репозитории расположены в [repositoryname]/raw/master/[file path in repository]

Поэтому просто используйте относительный путь: ../raw/master/[file path in repository]

Ответ 13

Чтобы встроить миниатюру внешнего изображения, используйте следующее: ![Image](<external link to the image>)

Ответ 14

Комментарий от @Drew Noakes к оригинальному вопросу сделал это для меня:

Синтаксис изображения, который я хотел бы отобразить:

[[/images/imageName.png]]

Это изображение отображается только при переименовании:

wikiPage.md --> wikiPage.wiki

В репозитории wiki была использована следующая структура папок:

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

НО:

Синтаксис в .wiki отличается от файлов .md.