Создание постоянной ссылки на фрагмент кода

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

Кто может использовать эту функцию?

Markdown можно использовать в веб-интерфейсе GitHub .

В этой статье

Ссылка на код

Постоянная ссылка этого типа отображается в виде фрагмента кода только в репозитории, в котором она была создана. В других репозиториях постоянная ссылка на фрагмент кода отображается в виде URL-адреса. Это не работает в файлах Markdown только в комментариях.

Снимок экрана: комментарий о проблеме. Фрагмент кода содержит заголовок, который содержит имена файлов и номера строк, а также текст, который перечисляет код в этих строках.

Tip

Сведения о создании ссылки для всего файла см. в разделе Получение постоянных ссылок на файлы.

  1. На GitHubперейдите на главную страницу репозитория.

  2. Найдите код, на который нужно задать ссылку:

    • Чтобы создать ссылку на код из файла, перейдите к файлу.
    • Чтобы связать код из запроса на вытягивание, перейдите к запросу на вытягивание и щелкните Файлы изменены. Затем откройте файл, где находится код, который нужно включить в комментарий, и нажмите Просмотреть.

  3. Выберите, следует ли выбрать одну строку или диапазон.

    • Для выбора одной строки кода, щелкните номер строки, чтобы выделить ее.
    • Для выбора диапазона щелкните номер первой строки диапазона, чтобы выделить ее. Затем наведите указатель мыши на последнюю строку диапазона кода, нажмите клавишу SHIFT и щелкните номер строки, чтобы выбрать весь диапазон.

  4. Слева от линии или диапазона строк щелкните . В раскрывающемся меню выберите Копировать постоянную ссылку.

    Снимок экрана: файл с выбранными 8 строками. Слева от первой выбранной строки кнопка, помеченная значком кебаба, выделена темно-оранжевым цветом.

  5. Перейдите к беседе, в которой нужно оставить ссылку на фрагмент кода.

  6. Вставьте постоянную ссылку в комментарий и нажмите кнопку Комментарий.

Ссылка на Markdown

Чтобы оставить ссылку на определенные строки в файле Markdown, загрузите файл Markdown без отрисовки. Чтобы загрузить файл Markdown без отрисовки, можно использовать ?plain=1 параметр в конце URL-адреса файла. Например, github.com/<organization>/<repository>/blob/<commit_SHA>/README.md?plain=1.

Можно указать ссылку на определенную строку в файле Markdown так же, как и в ссылке на код. Добавьте #L номер строки или номера в конце URL-адреса. Например, ссылка github.com/<organization>/<repository>/blob/<commit_SHA>/README.md?plain=1#L14 выделяет 14-ю строку в простом файле README.md.

Дополнительные материалы