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

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

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

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

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

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

Возможно ли это вообще, или я что-то неправильно понял?

Чтобы использовать относительные пути:

[[foo.jpg]]

Для получения дополнительной информации см . Страницу демонстрационной вики с изображениями .

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

• Перейдите на вкладку «Git Access» на вики-странице вашего репозитория и получите путь SSH, который должен выглядеть примерно так: git@github.com: USER / REPO.wiki.git, где USER - это имя вашей учетной записи, а REPO - это имя вашей учетной записи. имя репозитория.

• На вашем локальном компьютере используйте любой инструмент командной строки Git, который вы хотите перенести в свой локальный каталог по выбору, и получите репозиторий через

  git clone git@github.com: ПОЛЬЗОВАТЕЛЬ / REPO.wiki.git

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

• А затем переместите свой каталог git вики на github

• Вы не сможете физически увидеть изображения, скажем, на вкладке «Страницы», но если вы просто сделаете ссылку на изображения в локальной ссылке, вы сможете их увидеть. Пример с Markdown ниже:

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

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

  [![Alt attribute text Here](images/YOURIMAGE.ext)](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

Теперь вы должны встроить изображение, используя обычную уценку:

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

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

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

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

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

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

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

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

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

Догадаться.

URL-адрес отформатирован следующим образом

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

pathtoimage необязательно

Формат URL Джеймса у меня не работал, возможно, он был изменен. Я использовал:

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

Где pathtoimageнеобязательно.

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

Следующая уценка будет ссылаться на изображении в GitHub репо из вашей соответствующего 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)

Предостережения

1. Дело имеет значение
2. Если вы находитесь на специальной домашней странице вики, вам не нужно подниматься на уровень выше ../ В моем примере выше правильная ссылка будет

Для домашней страницы:

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

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

Вики находится по адресу [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

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

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

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

[[/images/imageName.png]]

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

wikiPage.md --> wikiPage.wiki

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

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

НО:

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

Многие ответы не сработали для меня, вот что в итоге сработало:

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

Использование режима редактора «Markdown» и подстраницы, например:

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

-Джон