Как добавить скриншот в readmes в репозитории github?

можно ли разместить скриншот в файле README в репозитории GitHub? Какой синтаксис?

13 ответов


если вы используете Markdown (README.md):

при условии, что у вас есть изображение в вашем РЕПО, вы можете использовать относительный URL-адрес:

![Alt text](/relative/path/to/img.jpg?raw=true "Optional Title")

Если вам нужно вставить изображение, размещенное в другом месте, вы можете использовать полный URL-адрес

![Alt text](http://full/path/to/img.jpg "Optional title")

GitHub рекомендует использовать относительная ссылка С ?raw=true параметр, чтобы обеспечить разветвленную точку РЕПО правильно.

проверить пример: https://raw.github.com/altercation/solarized/master/README.md

кроме того, документация по относительным ссылкам в файлах README:https://help.github.com/articles/relative-links-in-readmes

и, конечно, документы markdown:http://daringfireball.net/projects/markdown/syntax

кроме того, если вы создадите новую ветку screenshots для хранения изображений вы можете избежать их нахождения в master рабочий дерево!--7-->

затем вы можете вставить их, используя:

![Alt text](/../<branch name>/path/to/image.png?raw=true "Optional Title")

хотя уже есть принятый ответ, я хотел бы добавить еще один способ загрузки изображений в readme на GitHub.

  • нужно создать проблему в вашем РЕПО
  • перетащите в области комментариев изображение
  • после того, как ссылка для изображения генерируется вставьте его в свой readme

Подробнее вы можете найти здесь


я обнаружил, что путь к изображению в моем РЕПО недостаточно, я должен был связать с изображением на raw.github.com поддомен.

формат URL https://raw.github.com/{USERNAME}/{REPOSITORY}/{BRANCH}/{PATH}

пример Markdown ![Settings Window](https://raw.github.com/ryanmaxwell/iArrived/master/Screenshots/Settings.png)


одна строка ниже должна быть тем, что вы ищете

Если ваш файл находится в репозитории

![ScreenShot](https://raw.github.com/{username}/{repository}/{branch}/{path})

Если ваш файл находится в другом внешнем url

![ScreenShot](https://{url})

  1. загрузите изображение в postimage.org
  2. получить GitHub Markdown url
  3. вставьте в свой ReadMe

синтаксис markdown для отображения изображений действительно:

![image](https://{url})

но: как обеспечить url ?

  • вы, вероятно, не хотите загромождать свое РЕПО скриншотами, они не имеют ничего общего с кодом
  • вы, возможно, не захотите иметь дело с хлопотами о том, чтобы сделать ваше изображение доступным в интернете... (загрузите его на сервер... ).

Так... вы можете использовать это удивительный трюк сделать GitHub размещает ваш файл изображения. ДСОР:

  1. создайте проблему в списке проблем вашего РЕПО
  2. перетащите скриншот по этому вопросу
  3. скопируйте код markdown, который github только что создал для вас для отображения изображения
  4. вставьте его на свой readme (или где угодно)

http://solutionoptimist.com/2013/12/28/awesome-github-tricks/


добавьте это в README

<div align="center">
    <img src="/screenshots/screen1.jpg" width="400px"</img> 
</div>

Markdown: ![Screenshot](http://url/to/img.png)

  • создать проблему, касающуюся добавления изображений
  • добавить изображение путем перетаскивания или выбора файлов
  • затем скопируйте Источник изображения

  • добавлять ![Screenshot](http://url/to/img.png) к вашему README.md файл

готово!

В качестве альтернативы вы можете использовать некоторые изображения хостинга сайта, как imgur и вам это url-адрес и добавьте его в свой README.md-файл или вы можете использовать статический файловый хостинг.

образец вопрос


гораздо проще, чем добавление URL Просто загрузите изображение в тот же репозиторий, например:

![Screenshot](screenshot.png)


метод 1 - >Путь Markdown

![Alt Text](https://raw.github.com/{USERNAME}/{REPOSITORY}/{BRANCH}/{PATH})

Метод 2 - > HTML way

<img src="https://link(format same as above)" width="100" height="100"/>

или

<img src="https://link" style=" width:100px ; height:100px " />

Примечание - > если вы не хотите, чтобы стиль вашего изображения i.e изменить размер удалить часть стиля


во-первых, создайте каталог(папку) в корень вашей локальной РЕПО, который будет содержать screenshots вы хотите добавил. Назовем название этого каталога screenshots. Поместите изображения (JPEG, PNG, GIF и т. д.), которые вы хотите добавить в этот каталог.

Скриншот Рабочего Пространства Android Studio

во-вторых, вам нужно добавить ссылку на каждое изображение в свой README. Итак, если у меня есть изображения с именем 1_ArtistsActivity.png и 2_AlbumsActivity.png в моем каталоге скриншотов я добавлю их ссылки вроде так:

 <img src="screenshots/1_ArtistsActivity.png" height="400" alt="Screenshot"/> <img src=“screenshots/2_AlbumsActivity.png" height="400" alt="Screenshot"/>

если вы хотите, чтобы каждый скриншот на отдельной строке, напишите свои ссылки на отдельных строках. Однако лучше, если вы напишете все ссылки в одной строке, разделенной только пробелом. На самом деле это может выглядеть не слишком хорошо, но GitHub автоматически организует их для вас.

наконец, примените изменения и нажмите его!


для меня лучший способ -

  1. создайте новую проблему с этим репозиторием на github, а затем загрузите файл в формате gif.Чтобы конвертировать видео файлы в формат gif, вы можете использовать этот веб-сайтhttp://www.online-convert.com/
  2. отправить вновь созданную проблему.
  3. скопировать адрес загруженного файла
  4. наконец-то в вашем файле README поставить ![demo] (скопированный адрес)

надеюсь, это поможет .


с изображениями, расположенными в