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

40

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

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

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

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

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

github markdown

— НИК
источник

Измените 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
источник