Украсьте свой GitHub!
Если вы когда-нибудь заходили на чей-то GitHub и замечали, что на его домашней странице есть несколько причудливых картинок, крутых эмодзи и статистика, вы, возможно, задавались вопросом, как сделать такую страницу самостоятельно. Если это похоже на вас, продолжайте читать, потому что в этой статье я расскажу вам, как сделать ваш GitHub README привлекательным!
Как сделать свой собственный
Создание профиля GitHub README — это суперпростая задача, но ее немного трудно выполнить самостоятельно. Как только вы вошли в GitHub, инициализируйте новый репозиторий, перейдя по адресу . Назовите ваш новый репозиторий именем вашей учетной записи GitHub (подсказка: его можно найти, наведя курсор на значок вашего профиля в правом верхнем углу экрана) и нажмите «Создать репозиторий».
Для краткости отметьте пункт «Добавить файл README» при создании репозитория. README должен быть там, чтобы ваш новый необычный профиль был необычным.
Выделите его
Теперь, когда вы создали свой GitHub README, вам нужно знать несколько вещей о том, как сделать его красивым. В GitHub README используется язык Markdown. Вы можете использовать Markdown для добавления изображений, ссылок, рисунков, заголовков и многого другого.
Одна вещь, которая мне очень нравится на странице профиля GitHub — это заголовок. Это приятный личный штрих, который очень легко сделать с помощью таких программ, как PhotoShop, Sketch или даже Google Docs. А если вы хотите сделать что-то еще проще, посмотрите Canva Headers .
В заголовке может быть ваше имя, фотография, должность, местоположение и множество других вещей. Вот несколько примеров, которые мне очень нравятся:
Добавить картинки в README на GitHub очень просто. Если у вас есть файл, сохраненный локально, вы можете просто перетащить его в свою разметку, и он будет импортирован. Если вы хотите добавить ссылку в виде фотографии, вы можете использовать тег и добавить src с путем к фотографии, которую вы хотите добавить. Помните, что
— это самозакрывающийся тег, в Markdown могут быть ошибки, поэтому не забудьте закрыть этот тег!
Расскажите людям о себе
Людям интересны другие люди, расскажите свою историю. Пара строк текста о вашей философии разработчика может в значительной степени показать потенциальному работодателю или сотруднику, кто вы есть! Еще лучше — дать список того, над чем вы сейчас работаете, что вам интересно узнать, и дать ссылки на несколько ваших проектов. Поиск соавторов по вашим текущим проектам — один из лучших способов налаживания связей.
Это еще одна прекрасная возможность рассказать интересный факт о себе. Убедитесь, что ваши пункты краткие и в точку. Добавьте эмодзи, чтобы было немного интереснее.
Подчеркивание своих навыков
Настоятельно рекомендуется отображать свои навыки прямо на домашней странице GitHub. Вы упорно работали над этими навыками, покажите их! Когда потенциальные работодатели или соавторы зайдут на вашу страницу GitHub, это даст им возможность быстро понять, на каких языках вы можете работать.
Есть несколько способов сделать это: вы можете разместить логотипы всех языков, инструментов и технологий, в которых разбираетесь.
Самый простой способ найти эти значки — использовать google images, а затем нажать на «tools», затем «color», затем «transparent». В результате вы получите большое количество изображений в формате .png, размер которых можно легко изменить в Markdown.
Некоторые другие замечательные источники для поиска логотипов или иконок — https://simpleicons.org/, а если вы ищете что-то более причудливое, загляните на https://shields.io.
Покажите свою работу
Еще один действительно хороший способ похвастаться своими навыками — это демонстрация своих репозиториев. Первый способ сделать это — закрепить свои лучшие репозитории прямо на домашней странице.
Чтобы изменить свои прикрепленные репозитории, перейдите на домашнюю страницу GitHub github.com/your-user-name и прокрутите страницу до раздела «Прикрепленные». Справа вверху от ваших текущих прикрепленных репозиториев есть текст с надписью «Настроить прикрепленные». Нажмите на него, и появится модальное окно со списком всех ваших работ. Отметьте те работы, которые вы хотите показать, вы можете разместить до шести репозиториев на своей домашней странице.
Если вы хотите поднять свой профиль новый уровень, обратите внимание на GitHub README Stats . GitHub README Stats — это инструмент, который позволяет отображать статистику на домашней странице GitHub в виде красиво отформатированных карточек. Вы можете передать множество параметров информации, таких как top_langs, что даст вам «карточку» для вашего README, отображающую ваши лучшие языки. Существует множество других аргументов, которые вы можете передать в URL статистики, и документация очень полезна.
Собираем все вместе
Теперь, когда вы стали мастером Markdown и чемпионом по созданию домашней страницы GitHub, переместите свой README в основную ветку и похвастайтесь своим новым красивым GitHub на LinkedIn! Помните, что вы всегда можете вернуться и отредактировать свой README в любой момент, поэтому обязательно протестируйте несколько различных настроек.
Как добавить картинку на GitHub, чтобы отображалась в файле README.md ?

Привет. У меня в корне проекта лежат разные папки и файлики, и валяется среди них файл README.md. Я сделал скриншот, сохранил в формате .jpg screenshot.jpg. И положил этот файлик рядом с README.md в общую кучу.
Подскажите, можно ли как-то прописать какую-нибудь команду в README.md, чтобы он скриншот в себя включил? Чтобы потом при открытии проекта на GitHub в этом самом файлике README.md была видна картинка?
Добавление файла в репозиторий
Можно отправить и зафиксировать существующий файл в репозиторий GitHub или с помощью командной строки.
Platform navigation
Adding a file to a repository on GitHub
Files that you add to a repository via a browser are limited to 25 MiB per file. You can add larger files, up to 100 MiB each, via the command line. For more information, see «Adding a file to a repository using the command line.» To add files larger than 100 MiB, you must use Git Large File Storage. For more information, see «About large files on GitHub.»
Tips:
- You can upload multiple files to GitHub at the same time.
- If a repository has any protected branches, you can’t edit or upload files in the protected branch using GitHub. For more information, see «About protected branches.»
You can use GitHub Desktop to move your changes to a new branch and commit them. For more information, see «Committing and reviewing changes to your project in GitHub Desktop.»

- On GitHub.com, navigate to the main page of the repository.
- Above the list of files, select the Add file dropdown menu and click Upload files. Alternatively, you can drag and drop files into your browser.

Adding a file to a repository using the command line
You can upload an existing file to a repository on GitHub.com using the command line.
This procedure assumes you’ve already:
- Created a repository on GitHub, or have an existing repository owned by someone else you’d like to contribute to
- Cloned the repository locally on your computer
Warning: Never git add , commit , or push sensitive information to a remote repository. Sensitive information can include, but is not limited to:
- Passwords
- SSH keys
- AWS access keys
- API keys
- Credit card numbers
- PIN numbers
- On your computer, move the file you’d like to upload to GitHub into the local directory that was created when you cloned the repository.
- Open Terminal Terminal Git Bash .
- Change the current working directory to your local repository.
- Stage the file for commit to your local repository.
$ git add . # Adds the file to your local repository and stages it for commit. To unstage a file, use 'git reset HEAD YOUR-FILE'.
$ git commit -m "Add existing file" # Commits the tracked changes and prepares them to be pushed to a remote repository. To remove this commit and modify the file, use 'git reset --soft HEAD~1' and commit and add the file again.
$ git push origin YOUR_BRANCH # Pushes the changes in your local repository up to the remote repository you specified as the origin
Further reading
oleglomako / Как вставить картинку в README.md на GitHub
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
|  |
|  |
| — ваш ник на ГитХабе; |
| — репозиторий где хранятся картинки; |
| — ветка репозитория; |
| — путь к месту нахождения картинки. |