Уценка для вставки и отображения изображения в репозитории GitHub

40

Согласно документации GitHub , синтаксис Markdown для вставки изображения:

![GitHub Logo](/images/logo.png)
Format: ![Alt Text](url)

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

Даже пример логотипа GitHub не работает.

Чего мне не хватает? Или это ошибка GitHub?

НИК
источник
Измените URL-адрес на полный путь, полный HTTP, и посмотрите, куда он вас приведет
Восемь дней недуга
@EightDaysofMalaise: Это действительно помогает ... Не могли бы вы написать это как ответ? Я сообщил об ошибке документации в Github.
НИК
Я думаю, что их документация изменилась. «Изображение» , «картинка» и «логотип» больше не упоминаются на странице.

Ответы:

34

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

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

https://github.com/images/logo.png

Но это не правильный файл или местоположение.

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

Таким образом, ваш пример будет использовать что-то похожее на это:

![Bilby Stampede](http://example.com/images/logo.png)
Восемь дней недомогания
источник
24

В ответ на ответ выше:

По состоянию на 30 января 2013 года, GitHub теперь разрешает относительные ссылки .

Убедитесь, что вы добавляете? Raw = true в конец URL. Вот пример:

![Image](../blob/master/public_html/img/nokia.png?raw=true)

Благодаря тому, как GitHub обрабатывает URL-адреса, если вы не добавите? Raw = true к исходному URL-адресу, ваш браузер попытается загрузить страницу с изображением.

Крис Моррис
источник
Вы уверены, что обновление также включает использование в качестве src?
Восемь дней недомогания
1
Да, это так. Тем не менее, вы должны добавить «? Raw = true» в конец URL. Вот пример :! [Image] (../ blob / master / public_html / img / nokia.png? Raw = true)
Крис Моррис
Только что обновил ответ :).
Крис Моррис
1
Это работает для моего файла Markdown, но я получаю сообщение об ошибке с pandoc: pandoc: Ошибка при создании PDF из источника TeX. ! Ошибка LaTeX: Неизвестное расширение графики: .png? Raw = true. См. Руководство к LaTeX или LaTeX Companion для объяснения. Введите H <return> для немедленной помощи. ... l.175 ... 2014-04-08_Bergman2011_Fig2.png? raw = true}
djhocking
2

Мне нравится тестировать мой Markdown локально, прежде чем нажать где-нибудь видимое только через URL. Поэтому я хочу относительный URL, который я могу использовать где угодно. GitHub теперь поддерживает их.

Ваш imagesподкаталог, если он находится в том же каталоге, что и ваш файл Markdown, в начале не нуждается в косой черте - попробуйте:

markdown ![GitHub Logo](images/logo.png)

вместо того

markdown ![GitHub Logo](/images/logo.png)

brannerchinese
источник