Синтаксис фиксации Github для связывания запроса / выпуска на извлечение

81

Я видел сообщения о фиксации, относящиеся к конкретной проблеме / запросу на перенос. Каков синтаксис для включения конкретной проблемы репозитория или запроса на перенос?

git github commit github-flavored-markdown АльбертЭнгельБ
источник
На github есть отличная библиотека для создания этих ссылок программным способом : github.com/doowb/github-issue-template и веб-сайт, на котором вы можете добавить несколько фрагментов информации, и он сгенерирует ссылку: doowb.github.io / github-issue-template
jonschlinkert
См. Также « Шаблоны множественных задач и запросов на вытягивание» с января 2018 г.
VonC,
1
Возможный дубликат ссылки на номер проблемы на GitHub в сообщении о фиксации
Дидье Л.
@DidierL С точки зрения даты, разве связанный вопрос не должен дублировать мой? Я могу понять, закрывая это для связанного вопроса, глядя на голоса за и контент ( Fixes XXXXсинтаксис не был настроен при первоначальном запросе ), мне больше интересно, что представляет собой вопрос, дублирующий другой. Раньше у меня были закрытые похожие старые вопросы, но называть это дубликатом не совсем правильно.
AlbertEngelB
Ну, другой вопрос старше, не так ли? (2009 по сравнению с 2014 годом). Как вы заметили, у него также больше голосов, и, AFAICT, вопросы точно такие же, и ответы, представленные здесь, покрыты принятым ответом там.
Didier L

Ответы:

88

Используйте документированный формат автоматической связи для проблем в репозиториях.

  • Синтаксис: {owner}/{repository}#{issue_number}
  • Пример: mojombo/jekyll#1

Когда такой форматированный текст присутствует в сообщении фиксации, он автоматически преобразуется в интерактивную ссылку, которая перенаправляет ее на https://github.com/{owner}/{repository}/issues/{issue_number}

нулевой токен
источник
7
Предоставленный синтаксис работает для связывания между репозиториями (т. Е. Фиксация в репо B, связанная с проблемой в репозитории A). Указывая на проблемы в том же репозитории, вы можете использовать короткий синтаксис#{issue_number}
nulltoken
4
Это хорошо для проблем, но я не вижу ничего о связи с запросом на слияние.
bryanbraun
2
@bryanbraun Этот синтаксис также работает для запросов на вытягивание.
nulltoken
2
@nulltoken Каков именно синтаксис цитирования (и ссылки) на пул-реквест? Если mojombo/jekyll#1речь идет о проблеме 1, каков синтаксис запроса на вытягивание 1?
Роб Стюарт
15
@RobStewart то же самое. У вас не может быть одновременно проблемы 1 и запроса на вытягивание 1 в репо.
nulltoken
32

Номер PR / номера проблемы Github должен использовать ту же последовательность.

Итак, один номер либо один PR, либо одна проблема.

Просто используйте # номер в порядке.

zw963
источник
Этот ответ заслуживает большего внимания. Я никогда этого не замечал. Спасибо!
Wildcard
Я бы хотел, чтобы они прописали это в документации github. Я уверен, что он где-то есть, но я его не видел.
Дэррил
31

Используйте #1234в комментарии для ссылки на пул-реквест 1234 из текущего репо.

geg
источник
1

Для связывания с другим репозиторием, если вы просто вставите ссылку на проблему или запрос на перенос, скажем https://github.com/{owner}/{repository}/issues/{issue_number}, GitHub отобразит ее как

[{owner}/{repository}#{issue_number}](https://github.com/{owner}/{repository}/issues/{issue_number})

Например, https://github.com/jlord/sheetsee.js/issues/26 будет отображаться как jlord / sheetsee.js # 26 .

См. Https://help.github.com/articles/autolinked-references-and-urls/#issues-and-pull-requests

Мэтт Дж.
источник