Вбудовування зображень у сховище wiki (gollum) GitHub?

Вікі Github підтримуються окремим сховищем git, а потім основним сховищем проекту.

Цей допис команди Github здається схожим на те, що ви повинні мати змогу посилатися на зображення, що зберігаються у сховищі wiki всередині розмітки wiki.

Зображення та папки

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

Я перевірив репозиторій моєї вікі і засунув туди папку ресурсів та зображення. Моє питання полягає в тому, як я можу використовувати це зображення ?

Це взагалі можливо чи я щось неправильно зрозумів?

Щоб використовувати відносні шляхи, зробіть:

[[foo.jpg]]

Для отримання додаткової інформації див. Демонстраційну сторінку wiki на зображеннях .

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

• Перейдіть на вкладку "Git Access" на вікі-сторінці вашого сховища та отримайте шлях SSH, який має бути приблизно таким: git@github.com: USER / REPO.wiki.git, де USER - це ваше ім'я облікового запису, а REPO - це назва сховища.

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

  git clone git@github.com: USER / REPO.wiki.git

• Тепер у цьому сховищі створіть каталог зображень, я буду називати його "images" та вкладати в каталог будь-які образи, які ви хочете

• А потім натисніть ваш 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)

Зверніть увагу, що під час попереднього перегляду зображення не відображатиметься, я мав його зберегти.

Якщо ви хочете швидко завантажити зображення за допомогою перетягування / падіння, ви можете виконати наступне (хоча і хакі):

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

Створивши проблему один раз, ви можете використовувати її будь-яку кількість разів, щоб зробити це.

Сподіваюся, це допоможе кожному, хто шукає швидкого виправлення, без необхідності розміщувати зображення в репо.

Ось практичний спосіб зробити це:

• Перейдіть до будь-якого випуску на 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

Щоб вбудувати ескіз зовнішнього зображення, скористайтеся наступним, ![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

-Джон