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



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



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




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



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




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



Это вообще возможно или я что-то недопонимаю?

2119   14  

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
  • вы не сможете физически видеть изображения на вкладке "страницы", но если вы просто ссылаетесь на изображения в локальной ссылке, вы должны быть в состоянии видеть их. Пример с уценкой ниже:

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

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

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

создайте фиктивную проблему; перетащите туда свое изображение; скопируйте / вставьте загруженный код изображения 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 и получил их для отображения в Вики с помощью ![test](test.jpg)

следующая уценка будет ссылаться на изображение в вашем GitHub РЕПО из вашего соответствующего GitHub wiki

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

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

  • путь
    • ToAssets
      • In
        • РЕПО.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>)

комментарий от @Обратил Ноукс на первоначальный вопрос сделал это за меня:

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

[[/images/imageName.png]]

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

wikiPage.md --> wikiPage.wiki

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

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

но:

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

Comments

    Ничего не найдено.