Сведения об анонимных URL-адресах
Если вы отправляете изображение или видео в GitHub, URL-адрес изображения или видео будет изменен, чтобы предотвратить отслеживание ваших данных.
Platform navigation
To host your images, GitHub uses the open-source project Camo. Camo generates an anonymous URL proxy for each file which hides your browser details and related information from other users. The URL starts https://.githubusercontent.com/ , with different subdomains depending on how you uploaded the image.
Videos also get anonymized URLs with the same format as image URLs, but are not processed through Camo. This is because GitHub does not support externally hosted videos, so the anonymized URL is a link to the uploaded video hosted by GitHub.
Anyone who receives your anonymized URL, directly or indirectly, may view your image or video. To keep sensitive media files private, restrict them to a private network or a server that requires authentication instead of using Camo.
Troubleshooting issues with Camo
In rare circumstances, images that are processed through Camo might not appear on GitHub. Here are some steps you can take to determine where the problem lies.
Windows users will either need to use the Git PowerShell (which is installed alongside GitHub Desktop) or download curl for Windows.
An image is not showing up
If an image is showing up in your browser but not on GitHub, you can try requesting it locally.
- Open Terminal Terminal Git Bash .
- Request the image headers using curl .
$ curl -I https://www.my-server.com/images/some-image.png > HTTP/2 200 > Date: Fri, 06 Jun 2014 07:27:43 GMT > Expires: Sun, 06 Jul 2014 07:27:43 GMT > Content-Type: image/x-png > Server: Google Frontend > Content-Length: 6507 If your content type is not supported by Camo, you can try several actions:
- If you own the server that’s hosting the image, modify it so that it returns a correct content type for images.
- If you’re using an external service for hosting images, contact support for that service.
- Make a pull request to Camo to add your content type to the list.
An image that changed recently is not updating
If you changed an image recently and it’s showing up in your browser but not GitHub, you can try resetting the cache of the image.
- Open Terminal Terminal Git Bash .
- Request the image headers using curl .
$ curl -I https://www.my-server.com/images/some-image.png > HTTP/2 200 > Expires: Fri, 01 Jan 1984 00:00:00 GMT > Content-Type: image/png > Content-Length: 2339 > Server: Jetty(8.y.z-SNAPSHOT) Check the value of Cache-Control . In this example, there’s no Cache-Control . In that case:
- If you own the server that’s hosting the image, modify it so that it returns a Cache-Control of no-cache for images.
- If you’re using an external service for hosting images, contact support for that service.
If Cache-Control is set to no-cache , contact us through the GitHub Support portal or search the GitHub Community discussions.
Removing an image from Camo’s cache
Purging the cache forces every GitHub user to re-request the image, so you should use it very sparingly and only in the event that the above steps did not work.
- Open Terminal Terminal Git Bash .
- Purge the image using curl -X PURGE on the Camo URL.
$ curl -X PURGE https://camo.githubusercontent.com/4d04abe0044d94fefcf9af2133223. > "status": "ok", "id": "216-8675309-1008701"> Viewing images on private networks
If an image is being served from a private network or from a server that requires authentication, it can’t be viewed by GitHub. In fact, it can’t be viewed by any user without asking them to log into the server.
To fix this, please move the image to a service that is publicly available.
Further reading
- «Proxying user images» on the GitHub Blog
GitHub — что это такое?
GitHub – это онлайн-платформа для хранения, управления и совместной работы над проектами с открытым исходным кодом. Это инструмент, который стал неотъемлемой частью современной разработки ПО и широко используется в различных сферах, включая науку, бизнес и государственный сектор.
Проекты, которые хранятся в GitHub, представляют собой коллекцию изменений, сделанных в коде, и хранятся в репозитории. Если вы работаете над проектом самостоятельно, вам нужно создать новый репозиторий. Если же вы работаете в команде, каждый разработчик должен клонировать репозиторий первоначального создателя проекта.
Внутри репозитория код сохраняется в виде веток и коммитов, которые позволяют отслеживать изменения и сохранять их историю.
В данной статье мы рассмотрим основы использования GitHub: от регистрации на платформе до работы с репозиториями и советов по использованию. Вы узнаете, как создавать и управлять своими репозиториями, делать коммиты и пушить изменения, работать с ветками и pull-запросами.
Если вы новичок в использовании GitHub, то этот материал поможет вам освоить основы работы с платформой.
Регистрация и создание репозитория
Чтобы зарегистрироваться на GitHub вам нужно:
1. Перейти на официальный сайт GitHub;
2. Нажать кнопку «Sign up» в верхнем правом углу экрана;
3. Ввести свои данные (имя пользователя, адрес электронной почты и пароль);
4. Нажать кнопку «Create account».
После завершения регистрации вы будете перенаправлены на главную страницу GitHub.
После прохождения регистрации, вы можете создать свой первый репозиторий:
1. На главной странице GitHub нажмите кнопку «+» в верхнем правом углу экрана;
2. Введите название вашего репозитория и описание (опционально);
3. Выберите тип репозитория: Public (открытый для всех) или Private (доступ только для вас и приглашенных вами пользователей);
4. Нажмите кнопку «Create repository».
После этого вы можете добавлять свой код, управлять версиями и работать над проектом вместе с другими людьми.
Работа с репозиторием
Сначала вам нужно настроить репозиторий и после этого вы можете начать работать с ним.
Клонирование репозитория на свой компьютер
Клонирование репозитория на свой компьютер позволит вам работать с кодом локально.
Чтобы клонировать репозиторий на свой компьютер, выполните следующие шаги:
1. Откройте терминал (командную строку) на своем компьютере;
2. Перейдите в папку, в которой вы хотите сохранить репозиторий;
3. Введите следующую команду: git clone https://github.com/ваш-username/ваш-repo.git, где ваш-username — это ваш логин на GitHub, а ваш-repo — это название вашего репозитория.
Добавление изменений в репозиторий
После того, как вы клонировали репозиторий на свой компьютер, вы можете вносить изменения в код и сохранять их на сервере.
Чтобы добавить изменения в репозиторий, выполните следующие шаги:
1. Откройте файлы, которые вы хотите изменить, и внесите нужные изменения;
2. Сохраните файлы;
3. Откройте терминал и перейдите в папку с репозиторием;
4. Введите команду git add ., чтобы добавить все измененные файлы в индекс (staging area).
Коммиты и пушинг изменений в репозиторий
После того, как вы добавили изменения в индекс (staging area), вы можете сделать коммит и отправить изменения на сервер:
1. Введите команду git commit -m «Описание ваших изменений», — т.е. краткое описание изменений, которые вы внесли;
2. Введите команду git push, чтобы отправить изменения на сервер.
Работа с ветками и их слияние
Ветки позволяют вам работать с разными версиями вашего кода. Вы можете создавать новые ветки, переключаться между ними и сливать их, чтобы объединить изменения.
Для создания новой ветки нужно:
1. Открыть терминал и перейти в папку с репозиторием;
2. Ввести команду git branch название-новой-ветки, — т.е. название вашей новой ветки;
3. Ввести команду git checkout название-новой-ветки, чтобы переключиться на новую ветку.
Теперь вы можете работать с новой веткой и вносить изменения в нее без влияния на оригинальную ветку.
Чтобы выполнить слияние веток нужно:
1. Ввести команду git checkout ветка-куда-сливаем, чтобы переключиться на ветку, в которую вы хотите слить изменения;
2. Ввести команду git merge ветка-откуда-сливаем, чтобы слить изменения из другой ветки в текущую ветку.
Теперь изменения из ветки ветка-откуда-сливаем будут объединены с текущей веткой ветка-куда-сливаем.
Создание и закрепление тегов
Теги используются для определения конкретной версии вашего проекта. Это может быть полезно, например, когда вы выпускаете новую версию своего приложения и хотите сохранить состояние кода на момент релиза.
Чтобы создать тег, выполните следующие шаги:
1. Откройте терминал и перейдите в папку с репозиторием.
2. Введите команду git tag название-тега, — т.е. название вашего тега.
Теперь вы создали новый тег в вашем репозитории. Однако этот тег еще не закреплен на конкретном коммите. Чтобы закрепить тег на определенном коммите, выполните следующие шаги:
1. Откройте терминал и перейдите в папку с репозиторием;
2. Введите команду git tag -a название-тега коммит-хэш -m «Описание», где название-тега — это название вашего тега, коммит-хэш — это хэш-код коммита, на который вы хотите закрепить тег, и «Описание» — это описание вашего тега;
Теперь вы закрепили тег на определенном коммите и можете использовать его для определения конкретной версии вашего проекта.
Работа с pull-запросами и ревью кода
Pull-запросы (pull requests) — это механизм, который позволяет отправить изменения в вашем репозитории другим участникам проекта для проверки и слияния с основной веткой. Это особенно полезно, когда вы работаете с командой, так как это позволяет контролировать изменения, которые вносятся в проект.
Чтобы создать pull-запрос, выполните следующие шаги:
1. Перейдите на страницу вашего репозитория на GitHub;
2. Нажмите кнопку «New pull request»;
3. Выберите ветку, в которую вы хотите внести изменения, и ветку, которую вы хотите сравнить;
4. Опишите изменения, которые вы внесли;
5. Нажмите кнопку «Create pull request».
После того, как вы создали pull-запрос, другие участники проекта могут оставить комментарии, задавать вопросы и предлагать изменения. Как владелец репозитория, вы можете просматривать комментарии и принимать решение о слиянии изменений в основную ветку.
Чтобы провести ревью кода, выполните следующие шаги:
1. Откройте pull-запрос на GitHub;
2. Прочитайте описание изменений и просмотрите изменения в коде;
3. Оставьте комментарии на коде, если у вас есть замечания или предложения по улучшению;
4. Если вы уверены, что изменения безопасны и не нарушают функциональность проекта, вы можете сливать изменения в основную ветку, нажав кнопку «Merge pull request».
Однако перед тем, как сливать pull-запрос, важно убедиться, что изменения не противоречат основной функциональности проекта, не вызывают ошибок и не нарушают совместимость с другими частями кода.
Для того, чтобы обеспечить более эффективное ревью кода, можно использовать инструменты, такие как GitHub Actions, которые автоматически выполняют тесты и проверки качества кода. Также можно использовать инструменты для статического анализа кода, такие как SonarQube, которые помогают выявить потенциальные проблемы и улучшить качество кода.
Советы по использованию GitHub
Кроме основных функций, о которых мы говорили выше, есть несколько советов, которые помогут вам использовать GitHub более эффективно:
1. Используйте GitHub Issues для управления задачами и багами. GitHub Issues — это инструмент для отслеживания задач и ошибок, который позволяет упорядочить все ваши задачи в одном месте и упростить их управление;
2.Используйте GitHub Pages для создания своего сайта. GitHub Pages — это бесплатный сервис, который позволяет создавать свой собственный сайт, используя статический контент из вашего репозитория на GitHub;
3.Используйте GitHub Actions для автоматизации вашего рабочего процесса. GitHub Actions — это инструмент для автоматизации задач, который позволяет выполнять скрипты и команды при определенных условиях, таких как создание pull-запроса или изменение кода в репозитории;
4.Не забывайте про безопасность. GitHub предлагает множество инструментов для обеспечения безопасности вашего кода, таких как проверка уязвимостей и анализ кода на наличие ошибок. Используйте эти инструменты для защиты своего кода и данных.
Заключение
В заключение, GitHub является мощным инструментом для работы с проектами и управления кодом. В этой статье мы рассмотрели основные функции GitHub.
Также мы дали несколько полезных советов для более эффективного использования GitHub.
Мы надеемся, что эта статья была полезной для вас и помогла разобраться в основных функциях GitHub.
Постоянная блокировка raw.githubusercontent.com
- Тема закрыта
26 ответов в этой теме
#1 
lisaiv
Отправлено 20 Май 2019 — 18:31
Здравствуйте! Последнюю неделю постоянно вылезает сообщение «URL заблокирован; ULR raw.githubusercontent.com; Причина Источник распространения вирусов».
Вылезает такое сообщение кучу раз за день при заходе на любой сайт и жутко раздражает.
Кто-то сталкивался с таким? Гугл с яндексом ничего не находят по теме.
Это баг такой или фича? А может какой-то вирус у меня?
Полная проверка ничего нового не показала.
P.s. Dr. Web Security Space 11.5, Win 7×64, Firefox 66.0.5 (x64)
Прикрепленные файлы:
#2 VVS
Отправлено 20 Май 2019 — 18:50
Тему перемещаю в «Помощь по лечению».
Почитайте правила этого раздела и выложите сюда все логи, которые там указаны.
меня вот что возмутило. что даже не начинают толком диалог сразу дампы. © alehas777
———————————
Антивирус это как ремень безопасности — всего лишь увеличивает шансы выжить или получить менее тяжкую травму при аварии.
Есть, однако, категория людей, которые рассматривают средства безопасности как ауру неуязвимости. © basid
#3 lisaiv
Отправлено 20 Май 2019 — 19:49
Прилагаю логи. Если чего то не хватает, то напишите, что еще нужно. В правилах раздела помощь не все понятно написано к сожалению.
Прикрепленные файлы:
- hijackthis.log8,12К 5 Скачано раз
- WIN-BCBDNI6Q5SG_Admin_2_200519_194115.zip12,42Мб 3 Скачано раз
#4 RomaNNN
Отправлено 20 Май 2019 — 19:52
Если есть два способа, простой и сложный, то выбирай сложный, так как он проще простого способа, который тоже сложный, но ещё и кривой.
#5 AndreyKa
Отправлено 20 Май 2019 — 20:19
Не знаю, либо github.com взломали либо ложняк на IP 151.101.36.133
#6 SergSG
Отправлено 20 Май 2019 — 21:11
Не знаю, либо github.com взломали либо ложняк на IP 151.101.36.133
На github.com сработки нет, а на 151.101.36.133 есть.
Только ТС пишет, что сообщение вылазит при заходе на другие сайты.
#7 lisaiv
Отправлено 20 Май 2019 — 22:52
Прилагаю отчет dwsysinfo.exe и отчет самой последней полной проверки сканера.
Явление пока остается. Срабатывает даже на этом форуме.
Отчеты на форум прикрепить не дает (много весят) поэтому залиты на яндекс:
#8 RomaNNN
Отправлено 20 Май 2019 — 23:26
" value="NameServer" data="91.205.204.18 185.46.188.18" />
Если есть два способа, простой и сложный, то выбирай сложный, так как он проще простого способа, который тоже сложный, но ещё и кривой.
#9 lisaiv
Отправлено 20 Май 2019 — 23:40
^В моем реестре таких ключей нет.
#10 VVS
Отправлено 21 Май 2019 — 00:01
^В моем реестре таких ключей нет.
Переформулирую вопрос — указанные выше DNS Вам знакомы, Вы их на компьютере указывали?
меня вот что возмутило. что даже не начинают толком диалог сразу дампы. © alehas777
———————————
Антивирус это как ремень безопасности — всего лишь увеличивает шансы выжить или получить менее тяжкую травму при аварии.
Есть, однако, категория людей, которые рассматривают средства безопасности как ауру неуязвимости. © basid
#11 lisaiv
Отправлено 21 Май 2019 — 00:11
Нет, не знакомы. Вручную ничего не указывали, в параметрах сети стоит автоопределение dns. Я вообще с трудом понимаю, что это такое.
#12 RomaNNN
Отправлено 21 Май 2019 — 12:56
1) У Вас есть следы блокировки софта на уровне политик. Если это делали не Вы, то надо все поудалять:
Зайдите в редактор групповых политик (gpedit.msc в коммандлайне), раскройте иерархию «Local Computer Policy» -> «Computer Configuration» -> «Windows settings» -> «Security Settings». Там надо просмотреть пункты «Software Restriction Policies» и «Application Control Policies» на предмет правил, если что-то есть, то удалить.
Плюсом будет проверить ветки реестра:
HKEY_LOCAL_MACHINE\Software\Microsoft\SystemCertificates\Disallowed\Certificates\
Если что-то есть, удалить. По отчету там есть как минимум залоченный сертификат от D-Link:
HKEY_LOCAL_MACHINE\Software\Microsoft\SystemCertificates\Disallowed\Certificates\3EB44E5FFE6DC72DED703E99902722DB38FFD1CB
2) В HOSTS файле куча записей от какого-то «Spybot — Search & Destroy»
Если не Ваше, поудаляйте.
3) По повоу DNS пардон, не в тот отчет посмотрел. Тут все чисто.
4) Сам коннект идет от браузера. Это Вы сами заходите на github? В настройках Firefox прописаны всякие прокси, правда на локальный адрес.
Если есть два способа, простой и сложный, то выбирай сложный, так как он проще простого способа, который тоже сложный, но ещё и кривой.
#13 Dmitry_rus
Dmitry_rus
Отправлено 21 Май 2019 — 14:12
В HOSTS файле куча записей от какого-то «Spybot — Search & Destroy»
Есть такая программка, позиционируется производителями как антишпион. Пытается «иммунизировать» hosts, внося в него адреса вредоносных сайтов (несколько десятков тысяч). Криминального — ничего, впрочем, и полезного тоже не много.
Сообщение было изменено Dmitry_rus: 21 Май 2019 — 14:15
#14 lisaiv
Отправлено 21 Май 2019 — 14:32
Все сделано. В груповых политиках ничего нет вообще. Реестр почищен. Hosts тоже почищен. Прокси в firefox отключены и не используются вообще. Проблема осталась.
Насчет коннекта — на github специально не заходим, но если попытаться, то на сам github.com заходит вообще без проблем.
Сообщение о блокировке githubusercontent.com вылезает на других сайтах (youtube, vk, яндекс и т.д.).
При попытке зайти на githubusercontent.com, raw.githubusercontent.com и любоедругоеслово.githubusercontent.com вылезает сообщение о блокировке.
На opera протестировали, вылезает гораздо реже, но тоже вылезает.
Мне главное понять еще раз — если это чисто блокировка сайта dr.web или РКН, то я просто скрою эти сообщения и забуду, так как github мне вообще не нужен. А если это какой-то страшный вирус у меня, то хотелось бы от него избавиться.
Прикрепленные файлы:
#15 Konstantin Yudin
Konstantin Yudin
Отправлено 21 Май 2019 — 14:43
а вариант с убиранием 151.101.36.133 их базы малвари как фолса не рассматриваем?
With best regards, Konstantin Yudin
Doctor Web, Ltd.
#16 VVS
Отправлено 21 Май 2019 — 14:48
а вариант с убиранием 151.101.36.133 их базы малвари как фолса не рассматриваем?
Одно другому не мешает.
Не должно ж оно без ведома пользователя туда лезть.
меня вот что возмутило. что даже не начинают толком диалог сразу дампы. © alehas777
———————————
Антивирус это как ремень безопасности — всего лишь увеличивает шансы выжить или получить менее тяжкую травму при аварии.
Есть, однако, категория людей, которые рассматривают средства безопасности как ауру неуязвимости. © basid
#17 AndreyKa
Отправлено 21 Май 2019 — 14:50
lisaiv, сервер DNS от Ядекса dns.yandex.ru используете?
#18 lisaiv
Отправлено 21 Май 2019 — 14:57
Определение DNS в сети стоит автоматическое. Т.е. получается, что идет от провайдера. Провайдер Билайн. Возможно у них как раз dns от Яндекса.
Кстати реально вопрос, почему так часто что-то лезет на этот githubusercontent?
#19 Konstantin Yudin
Konstantin Yudin
Отправлено 21 Май 2019 — 15:00
Определение DNS в сети стоит автоматическое. Т.е. получается, что идет от провайдера. Провайдер Билайн. Возможно у них как раз dns от Яндекса.
в настройках роутера не включена опция безопасный Интернет от Yandex?
With best regards, Konstantin Yudin
Doctor Web, Ltd.
#20 Konstantin Yudin
Konstantin Yudin
Отправлено 21 Май 2019 — 15:03
Кстати реально вопрос, почему так часто что-то лезет на этот githubusercontent?
это может быть как открытая вкладка в firefox, так и расширение какое нибудь ходить туда
With best regards, Konstantin Yudin
Doctor Web, Ltd.
Читают тему: 0
0 пользователей, 0 гостей, 0 скрытых
Ответить на цитированные сообщения Очистить
- Dr.Web forum
- → Русские форумы
- → Антивирусная лаборатория
- → Помощь по лечению
- Privacy Policy
- Terms & Rules ·
- Сменить тему
- Doctor Web mobile
- Doctor Web 7.0
- Doctor Web 6.0 (classic)
- Doctor Web 11 (beta)
- RU
- EN
- FR
- RU
- DE
- Отметить все сообщения форума как прочитанные
- Отметить все как прочитанное
- Помощь
Основные сведения о Git и GitHub для документации По Microsoft Learn
В качестве участник документации по Microsoft Learn вы будете взаимодействовать с несколькими инструментами и процессами. Вы будете работать параллельно с другими участниками над одним и тем же проектом, иногда над тем же содержимым и в то же время. Все это возможно благодаря программному обеспечению Git и GitHub.
Git — это система управления версиями с открытым исходным кодом. Она упрощает совместную работу над проектами такого типа с помощью распределенной системы управления версиями файлов, которые хранятся в репозиториях. По сути, Git позволяет интегрировать в определенный репозиторий потоки работы, выполненные несколькими участниками в течение определенного времени.
GitHub — это веб-служба размещения для репозиториев Git, например для хранения содержимого Microsoft Learn . В GitHub размещается основной репозиторий всех проектов. Из этого репозитория участники копируют свою работу.
Git
Если вы знакомы с централизованными системами управления версиями (например, Team Foundation Server, SharePoint или Visual SourceSafe), вы заметите, что Git использует уникальный рабочий процесс и специальную терминологию для поддержки распределенной модели. Например, в Git не блокируются файлы, как это обычно бывает, когда файл берут на редактирование или возвращают после редактирования. На самом деле Git учитывает изменения на более тонком уровне, сравнивая файлы байт за байтом.
Git также использует многоуровневую структуру для хранения содержимого проекта и управления им.
- Репозиторий — это единица хранения самого высокого уровня. Репозиторий содержит одну или несколько ветвей.
- Ветвь — это единица хранения с текущими файлами и папками, которые формируют содержимое проекта. Ветви используются для разделения потоков работы (обычно они называются версиями). Участники всегда вносят изменения в содержимое в определенной ветви, и эти изменения привязаны к соответствующей ветви. Все репозитории содержат ветвь по умолчанию (обычно она называется главной, «main») и одну или несколько ветвей, предназначенных для объединения с ветвью по умолчанию. Ветвь по умолчанию является текущей версией и «единственным истинно верным источником» для определенного проекта. Из этой родительской ветви создаются все остальные ветви в репозитории.
Участники взаимодействуют с Git, чтобы обновлять репозитории и управлять ими локально и на уровне GitHub.
- Для локального взаимодействия участники используют такие инструменты, как консоль Git Bash, которая поддерживает команды Git для управления локальными репозиториями и обмена данными с репозиториями GitHub.
- Кроме того, участники используют сайт www.github.com с интегрированной системой Git для управления согласованием изменений, возвращаемых обратно в основной репозиторий.
GitHub
Хотя руководство по документации основано на использовании GitHub, некоторые команды используют Visual Studio Team Services для размещения репозиториев Git. Клиент Visual Studio Team Explorer — это графический интерфейс для взаимодействия с репозиториями Team Services. Этот интерфейс является альтернативой использованию команд Git в командной строке. Кроме того, многие приведенные ниже руководства разработаны в качестве рекомендаций, которые появились в результате многолетнего размещения содержимого служб Azure в GitHub. Они могут потребоваться в некоторых репозиториях Microsoft Learn.
Все рабочие процессы начинаются и заканчиваются на уровне GitHub, где хранится основной репозиторий для любого проекта документации. Копии, создаваемые участниками для собственного использования, распространяются на нескольких компьютерах. В итоге они согласовываются в основном репозитории GitHub проекта.
Организация каталогов
Как упоминалось ранее, ветвь по умолчанию выступает в качестве текущей версии содержимого проекта. Содержимое в ветвь по умолчанию-и ветвях, созданных из него, свободно соответствует организации статей на соответствующих страницах Microsoft Learn. Подкаталоги используются для разделения содержимого (например, служб), мультимедийного содержимого (например, файлов изображений) и файлов include, которые позволяют повторно использовать содержимое.
Основной каталог articles обычно находится в корне репозитория. Этот каталог статей содержит набор подкаталогов. Статьи в подкаталогах форматируются в виде файлов Markdown, использующих расширение MD. Некоторые репозитории, которые поддерживают несколько служб, например репозиторий Azure-Docs, используют универсальный подкаталог /articles . Другие репозитории, например IntuneDocs, используют подкаталог, который называется как служба: /IntuneDocs .
В корне этого каталога находятся общие статьи, которые описывают службу или продукт в целом. Как правило, каталог содержит еще одну серию подкаталогов, которые соответствуют функциям и службам или распространенным сценариям. Например, статьи, которые описывают службу виртуальных машин Azure, находятся в подкаталоге /virtual-machines , статьи «Изучение вопроса» службы Intune размещены в подкаталоге /understand-explore .
Подкаталог Media
В каждом каталоге находится подкаталог /media для соответствующих файлов мультимедиа. Файлы мультимедиа содержат изображения, используемые в статьях со ссылками на изображения.
Подкаталог includes
Содержимое для многократного использования, которое является общим для двух или нескольких статей, помещается в подкаталог /includes основного каталога articles . В файле Markdown, где используется включаемый файл, соответствующее расширение Markdown include помещается в расположение, на которое должна указывать ссылка на включаемый файл.
Шаблон файла Markdown
Для удобства в корневом каталоге каждого репозитория обычно находится файл шаблона Markdown с именем template.md . Его можно использовать как начальный файл для создания статьи с последующей отправкой в репозиторий. Файл содержит следующие компоненты:
- Заголовок метаданных в верхней части файла, разделенный двумя строками с тремя дефисами. Он содержит различные теги, используемые для отслеживания информации, относящейся к статье. Метаданные статьи обеспечивают дополнительные возможности. Например, можно указать ссылки на автора и участника, настроить строку навигации, добавить описание статьи. Они также включают оптимизацию для поисковых систем и процессы создания отчетов, которые корпорация Майкрософт использует для оценки производительности содержимого. Как видите, метаданные имеют большое значение.
- Раздел метаданных с описанием различных тегов и значений метаданных. Если вы не знаете, какие значения нужно использовать для раздела метаданных, их можно оставить пустыми или закомментировать с помощью начального хэштега (#). Так рецензент запроса на вытягивание в репозитории сможет проверить или выполнить их.
- Различные примеры использования разметки Markdown для форматирования элементов статьи.
- Общие инструкции по использованию расширений разметки Markdown, которые можно применить для различных типов оповещений.
- Примеры встраивания видео с помощью iframe.
- Общие инструкции по использованию расширений технической документации Майкрософт, которые можно применять для специальных элементов управления, таких как кнопки и селекторы.
Запросы на включение внесенных изменений
Запрос на вытягивание — используя этот удобный способ, участник предлагает набор изменений для внесения в стандартную ветвь. Изменения (они также называются фиксациями) хранятся в ветви участника. GitHub использует их для моделирования результатов их объединения со стандартной ветвью. Запрос на вытягивание также служит механизмом для предоставления участнику отзыва рецензента запроса. Рецензент отправляет участнику отзыв после процесса сборки и проверки, чтобы решить потенциальные проблемы или вопросы до того, как изменения будут объединены в стандартной ветви.
Существует два способа работы с запросом на вытягивание в зависимости от размера изменений, которые вы хотите предложить. Дополнительные сведения см. в статье Рабочий процесс для участников GitHub: незначительные или эпизодические изменения.
Подробнее
Если вы не знакомы с Git или GitHub, эти ресурсы помогут вам научиться, быть продуктивным или отвечать на вопросы.
Ресурсы управления версиями Git
- Электронная книга Pro Git (web): подробный справочник по Git в формате HTML.
- Электронная книга Pro Git (PDF) — этот же справочник в формате PDF.
- Учебный курс Git из Codecademy
- Попробуйте курс Git из Code School в Pluralsight
- Курс Git и Github из Udacity
Ресурсы по GitHub
- Краткое руководство по GitHub Hello World: интерактивное руководство, которое предоставляет основные сведения о Git с помощью GitHub.
- Руководства по GitHub — основная страница с документацией GitHub.
- Ресурсы, связанные с изучением GitHub — другие полезные материалы по GitHub.
- Глоссарий: удобный глоссарий терминов Git и GitHub.
- Пакет разработчика для учащихся GitHub: бесплатный доступ к лучшим средствам разработчика для учащихся.