Добавьте изображения в README.md на GitHub

Недавно я присоединился к GitHub. Я разместил там несколько проектов.

Мне нужно включить несколько изображений в файл README. Я не знаю, как это сделать.

Я искал об этом, но все, что я получил, это несколько ссылок, которые говорят мне "разместить изображения на веб-хостинге и указать путь к изображению в файле README.md".

Есть ли способ сделать это без размещения изображений на сторонних хостингах?

Комментарии к вопросу (5)
Решение

Попробуйте эту уценку:

![alt text](http://url/to/img.png)

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

![alt text](https://raw.githubusercontent.com/username/projectname/branch/path/to/img.png)

Редактирование: только что заметил комментарий, ссылающийся на статью, в которой предлагается использовать gh-pages. Кроме того, относительные ссылки могут быть лучшей идеей, чем абсолютные URL, о которых я писал выше.

Комментарии (19)

Вы также можете использовать относительные пути, как

![Alt text](relative/path/to/img.jpg?raw=true "Title")
Комментарии (13)
  • Вы можете создать новый выпуск
  • загрузить в него изображения (перетащить & drop)
  • Скопируйте URL изображений и вставьте его в файл README.md.

Вот подробное видео на YouTube, в котором это подробно объясняется:

https://www.youtube.com/watch?v=nvPOUdz5PL4

Комментарии (10)

Это'ы гораздо проще, чем.

Просто загрузите ваши изображения в корень репозитория, а ссылка на имя файла без пути к нему, например, так:

![Screenshot](screenshot.png)
Комментарии (6)

Вы также можете добавлять изображения с простой HTML-теги:

<p align="center">

  ![accessibility text](your_relative_path_here_number_2_large_name)
</p>
Комментарии (3)

Многие из опубликованных решений являются неполными или не в моем вкусе.

  • Внешнего УСР, как Imgur добавляет еще один инструмент к цепи. Мех.
  • Создание вопроса Незнайке в баг-трекере Хак. Он создает беспорядок и путаницу. Это'ы боль, чтобы перенести это решение на развилке, или выключить на GitHub.
  • Использование в GH-страниц филиал делает URL-адреса ломкими. Еще один человек работает над проектом сохранения гр-страницы могут не знать чего-то внешнего зависит от пути к этим изображениям. У GH-страниц филиал имеет определенное поведение на GitHub, который не является необходимым для таких КДС изображений.
  • Отслеживание активов в системе управления версиями-это хорошо. По мере развития проекта и изменения его's более надежный способ управлять и отслеживать изменения несколькими пользователями.
  • Если изображение относится к конкретной доработки программного обеспечения, он может быть предпочтительным, чтобы связать неизменный образ. Таким образом, если изображение будет позже обновлен, чтобы отразить изменения в программное обеспечение, кто-то читает, что пересмотр'ы ридми найдете правильный образ.

Мой предпочтительным решением, вдохновленный эта сущность, - использовать филиал активы с Постоянные для конкретных исправлений.

git checkout --orphan assets
git reset --hard
cp /path/to/cat.png .
git add .
git commit -m 'Added cat picture'
git push -u origin assets
git rev-parse HEAD  # Print the SHA, which is needed below.

Построить на "ссылка" на эту доработку изображения, и оберните его в уценке:

![Кот](https://raw.githubusercontent.com/{пользователь}/{РЕПО}/{ша}/упак.ПНГ)

например

![Cat](https://raw.githubusercontent.com/paulmelnikow/zsh-startup-timer/3923c60fc66d4223ccf063d169ccf2ff167b1270/cat.png)

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

![Кот](https://raw.githubusercontent.com/{пользователь}/{РЕПО}/активов/кошка.ПНГ)

Комментарии (2)

Совершение изображение (изображения.ПНГ) в папке (папка) и добавьте следующую строку в ваш в файле README.МД:

![Текст](../мастер/моя_папка/изображения.ПНГ)

Комментарии (0)
  • Создайте вопрос по поводу добавления изображений Добавлять изображения путем перетаскивания или выбора файлов

  • Скопируйте исходном изображении

  • Теперь добавить` в ридми.файл MD

Молодец!

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

Образец оформления

Комментарии (2)

Просто добавьте `<ИМГ и GT; тег для вашего ридми.MD с относительной src для вашего репозитория. Если вы'повторно не используя относительный src, убедитесь, что сервер поддерживает ПДБС.

Это работает, потому что поддержка на GitHub инлайн-HTML-код

![My cool logo](/docs/logo.png)
# My cool project and above is the logo of it

Наблюдать здесь

Комментарии (0)
![myimage-alt-tag](url-to-image)

Здесь:

  1. мой образ-альт-тег : текст, который будет отображаться, если изображение не отображается.
  2. URL-адрес для изображения : независимо от вашего имиджа ресурса. Ури изображения

Пример:

![stack Overflow](http://lmsotfy.com/so.png)

Это будет выглядеть следующим образом:

Комментарии (0)

Я нужно включать какие-то образы в моем файле README. Я не'т знать, как это сделать.

Я создал небольшой мастер, который позволяет создавать и настраивать простой галереи изображений для вашего репозиторий GitHub'ы ридми: см. ReadmeGalleryCreatorForGitHub.

Мастер использует тот факт, что гитхаб позволяет теги img происходят в ридми.МД`. Кроме того, мастер использует популярный трюк загрузки изображений на GitHub с помощью drag'Н'сбросив их в районе выпуска (как уже упоминалось в одном из ответов в этой теме).

Комментарии (1)

Используйте таблицы, чтобы выделиться, это придаст отдельный Шарм к нему

Синтаксис таблица:

Отдельно каждый столбец ячейки с символом |

и заголовок таблицы (первая строка) на 2-й строки ---

<БР>| колонка 1&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;| столбец 2&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;|</БР> <БР>|------------|-------------|</БР> <БР>| рис. 1 | Рис. 2 |</БР>

выход

<БР>теперь просто положить `<ИМГ СРЦ=с"URL-адрес/и relativepath" и> на рис. 1 и рис. 2 при использовании двух изображений</БР>

<БР>Примечание: Если вы используете несколько изображений просто включать несколько столбцов, вы можете использовать атрибут ширины и высоты, чтобы сделать его читаемым.</БР>

Пример

<БР>| колонка 1&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;| столбец 2&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;&ампер;усилитель; nbsp;|</БР> <БР>|------------|-------------|</БР> <БР>| <ИМГ src="https://media.wired.com/photos/5926db217034dc5f91becd6b/master/w_582,c_limit/so-logo-s.jpg" ширина=на"250" и> | <ИМГ src="https://mk0jobadderjftub56m0.kinstacdn.com/wp-content/uploads/stackoverflow.com-300.jpg" ширина=на"250" и> | </БР>

Расстояние не имеет значения

Вывод изображения

помогли : Адам-П

Комментарии (2)

Можно ссылку на изображения в вашем проекте из ридми.МД (или наружно), использование альтернативной ссылке на GitHub КДС.

URL-адрес будет выглядеть так:

https://cdn.rawgit.com////<path>//

У меня есть SVG-картинку в мой проект, и когда я ссылаться на него в моем проектной документации Python, оно не оказывает.

Проект ссылка ## Вот проект ссылку на файл (не отображается в виде картинки):

https://github.com/jongracecox/anybadge/blob/master/examples/awesomeness.svg

Пример внедренного изображения:

Непереработанными ссылке#

Здесь есть сырые ссылку на файл (по-прежнему не отображается в виде картинки):

https://raw.githubusercontent.com/jongracecox/anybadge/master/examples/awesomeness.svg

Пример внедренного изображения:

Ссылка# КДС

С помощью ссылки CDN, я могу ссылку на файл, используя (как изображение):

https://cdn.rawgit.com/jongracecox/anybadge/master/examples/awesomeness.svg

Пример внедренного изображения:

Это, как я могу использовать мой проект в моем ридми.файл MD, и в моем PyPi reStructredText проекта doucmentation (здесь)

Комментарии (0)

В моем случае я использую показывает и воспользуйтесь прямой ссылкой сюда.

![img](http://i.imgur.com/yourfilename.png)
Комментарии (0)

Я решил эту проблему. Вам нужно только обратиться к кому-то еще's в файле README.

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

<БР> <ИМГ высота=то"700" и src="https://github.com/mrhyh/TableView-/blob/master/%E8%AF%B4%E6%98%8E%E5%9B%BE/TableViewDemo.gif" /> <БР>

Комментарии (0)

Обычно я размещаю изображение на сайте, а это может ссылаться на любое размещенное изображение. Просто добавьте это в readme. Работает для файлов .rst, не уверен насчет .md.

.. image:: https://url/path/to/image
   :height: 100px
   :width: 200 px
   :scale: 50 %
Комментарии (0)

Вы можете просто сделать:

git checkout --orphan assets
cp /where/image/currently/located/on/machine/diagram.png .
git add .
git commit -m 'Added diagram'
git push -u origin assets

Затем вы можете просто ссылаться на него в файле ридми вроде так:

![диаграмма](рис.ПНГ)

Комментарии (2)

В случае, если вам нужно загрузить несколько фотографий для документации, хороший подход заключается в использовании ГИТ-ОРС. Предполагали, что у вас установлена ГИТ-ОРС выполните следующие действия:

  1. Intialize ГИТ ОРС для каждого типа изображения:

ГИТ ОРС .ПНГ ГИТ ОРС .СВГ ГИТ ОРС .гиф ГИТ ОРС .формат JPG ГИТ ОРС *.в формате JPEG

  1. Создать папку, которая будет использоваться в качестве местоположения изображения например, док. На GNU/Linux и UNIX систем это можно сделать через:

компакт-диск project_folder команды mkdir док в Git добавить док

  1. Копировать вставить любые изображения в папке doc. Затем добавить их с помощью команды git добавить команду`.

  2. Commit и push.

  3. Изображения являются общедоступными в следующий URL-адрес:

протокол HTTPS://media.githubusercontent.com/media/^github_username^/^РЕПО^/^филиал^/^image_location в репо^

Где:

  • ^github_username^ имя пользователя на GitHub (вы можете найти его на странице профиля)
  • ^repo_name^ - название репозитория
  • ^филиал^ является хранилищем ветку, где изображения загружаются
  • image_location^в репо^ - расположение, включая папку, в которой хранится изображение.

Также вы можете загрузить сначала изображение, а затем посетить место в ваших проектах на GitHub странице и перемещаться, пока вы не найдете изображение, а затем нажмите на кнопку "Загрузить" а потом скопировать и вставить URL из браузера's в адресной строке.

Посмотри этот из моего проекта в качестве ссылки.

Затем вы можете использовать этот URL, чтобы включить их, используя упомянутые выше синтаксис Markdown:

![some alternate text that describes the image](^github generated url from git lfs^)

Например: предположим, мы используем этот photo затем вы можете использовать синтаксис Markdown:

![In what order to compile the files](https://media.githubusercontent.com/media/pc-magas/myFirstEnclave/master/doc/SGX%20Compile%20workflow.png)
Комментарии (0)

В моем случае я хотел показать на экране печать на гитхабе, но и на НПМ. Хотя, используя относительный путь работал в гитхаб, это было'т работающих вне его. В принципе, даже если я толкнул моего проекта НПМ А (который просто использует тот же ридми.МД`, изображение никогда не показывал.

Я попробовал несколько способов, в конце это то, что работал для меня:

![Превью](https://raw.githubusercontent.com/username/project/master/image-path/image.png)

Теперь я вижу, правильно мой образ на НПМ или где-нибудь еще, что я мог бы опубликовать свой пакет.

Комментарии (0)

ПРОСТО ЭТО РАБОТАЕТ!!

позаботиться о вашем имени файла прописные буквы в теге и поставить ПНГ inroot файл, а ссылка на имя файла без пути:

![Screenshot](screenshot.png)
Комментарии (0)