Подтвердить что ты не робот

Ссылка на файл Markdown на GitHub

Я часто ссылаюсь на исходный код GitHub с помощью параметра #L в URI.

например.: https://github.com/github/learn.github.com/blob/gh-pages/episodes.yaml#L1

Но есть ли способ ссылки на строки в файле Markdown?

например. https://github.com/github/learn.github.com/blob/gh-pages/README.md#L1 (не работает!)

Я знаю, что могу ссылаться на "разделы", но линии намного лучше!

например. https://github.com/github/learn.github.com/blob/gh-pages/README.md#learngithubcom

4b9b3361

Ответ 2

Короткий ответ: нет. Markdown отображается в HTML-документе GitHub, поэтому в настоящее время невозможно увидеть его в необработанном виде, что также позволяет вам ссылаться на отдельные строки. Возможно, GitHub будет реализовывать такую ​​функцию в будущем, но пока это невозможно.

Ответ 3

В интересах читателя: длинный ответ - да, это сложно, но возможно.

GitHub позволяет встроить постоянные ссылки в текстовую часть файлов Markdown.

Однако в настоящее время, похоже, нет возможности создавать такие постоянные ссылки напрямую, вы должны создать их вручную. Следующее:

  • Показать документ уценки
  • Над документом щелкните правой кнопкой мыши на сокращенном SHA документа.
    (вы также можете использовать "Историю" и коммит)
  • Коммит diff показан.
  • Над коммитом щелкните правой кнопкой мыши по 3 точкам ... и выберите "Просмотр файла"
  • Теперь Mardown представлен снова, однако это постоянный вариант.
  • Над документом справа кликни на "Обвинение"
  • Прокрутите вниз до строк, которые содержат представление Markdown текста для цитирования
  • Выберите строку или строки, о которых идет речь
  • Скопируйте URL из адресной строки браузера
  • Вставьте URL в проблему и т.д.
  • Этот шаг необходим только при проблемах: в URL замените /blame/ by /blob/

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

Недостаток /blob/ -variant

Если щелкнуть URL-адрес, в браузере отобразится полная уценка, текстовая часть не будет отмечена должным образом.

Это ограничение того, как GitHub обрабатывает эти URL-адреса.

Недостаток /blame/ -variant

Это просто нечитаемо из-за всех этих аннотаций и отсутствия рендеринга уценки.

пример

Обратите внимание, что мне пришлось клонировать этот пример, чтобы создать проблему:

https://github.com/hilbix/learn.github.com/blob/gh-pages/README.md

  • Нажмите на SHA

https://github.com/hilbix/learn.github.com/commit/38034b3aee7f4fb7f46e94b3f9c2b3d3554291ba

  • "Просмотреть файл"

https://github.com/hilbix/learn.github.com/blob/38034b3aee7f4fb7f46e94b3f9c2b3d3554291ba/README.md

  • "Виноваты"

https://github.com/hilbix/learn.github.com/blame/38034b3aee7f4fb7f46e94b3f9c2b3d3554291ba/README.md

  • Отметьте несколько строк

https://github.com/hilbix/learn.github.com/blame/38034b3aee7f4fb7f46e94b3f9c2b3d3554291ba/README.md#L20-L23

  • Изменить URL

https://github.com/github/learn.github.com/blob/38034b3aee7f4fb7f46e94b3f9c2b3d3554291ba/README.md#L20-L23

  • Вставьте этот URL в какую-то проблему

Результат: https://github.com/hilbix/learn.github.com/issues/1

Это было введено в вопрос:

https://github.com/hilbix/learn.github.com/blob/38034b3aee7f4fb7f46e94b3f9c2b3d3554291ba/README.md#L20-L23

see https://stackoverflow.com/a/57202063/490291

Это приводит к следующему выводу (извините, мне тоже не удалось скопировать CSS):

<td class="d-block comment-body markdown-body  js-comment-body">
          <p></p><div class="border rounded-1 my-2">
  <div class="f6 px-3 py-2 lh-condensed border-bottom bg-gray-light">
    <p class="mb-0 text-bold">
      <a href="#" onclick="location.href='https://github.com/hilbix/learn.github.com/blob/38034b3aee7f4fb7f46e94b3f9c2b3d3554291ba/README.md#L20-L23'; return false;">learn.github.com/README.md</a>
    </p>
    <p class="mb-0 text-gray-light">
        Lines 20 to 23
      in
      <a data-pjax="true" class="commit-tease-sha" href="/hilbix/learn.github.com/commit/38034b3aee7f4fb7f46e94b3f9c2b3d3554291ba">38034b3</a>
    </p>
    </div>
    <div itemprop="text" class="blob-wrapper blob-wrapper-embedded data">
    <table class="highlight tab-size mb-0 js-file-line-container" data-tab-size="8">

        <tbody><tr class="border-0">
          <td id="L20" class="blob-num border-0 px-3 py-0 bg-white js-line-number" data-line-number="20"></td>
          <td id="LC20" class="blob-code border-0 px-3 py-0 bg-white blob-code-inner js-file-line"> <span class="pl-s1">$ git clone https://github.com/github/learn.github.com</span> </td>
        </tr>

        <tr class="border-0">
          <td id="L21" class="blob-num border-0 px-3 py-0 bg-white js-line-number" data-line-number="21"></td>
          <td id="LC21" class="blob-code border-0 px-3 py-0 bg-white blob-code-inner js-file-line"> <span class="pl-s1">$ <span class="pl-c1">cd</span> learn.github.com</span> </td>
        </tr>

        <tr class="border-0">
          <td id="L22" class="blob-num border-0 px-3 py-0 bg-white js-line-number" data-line-number="22"></td>
          <td id="LC22" class="blob-code border-0 px-3 py-0 bg-white blob-code-inner js-file-line"> <span class="pl-s1">$ script/bootstrap</span> </td>
        </tr>

        <tr class="border-0">
          <td id="L23" class="blob-num border-0 px-3 py-0 bg-white js-line-number" data-line-number="23"></td>
          <td id="LC23" class="blob-code border-0 px-3 py-0 bg-white blob-code-inner js-file-line"> <span class="pl-s1">$ jekyll --server</span> </td>
        </tr>
    </tbody></table>
  </div>
</div>
<p></p>
<p>see <a rel="nofollow" href="#" onclick="location.href='https://stackoverflow.com/a/57202063/490291'; return false;">https://stackoverflow.com/a/57202063/490291</a></p>
      </td>