Składnia zatwierdzania Github do łączenia żądania ściągnięcia / problemu

81

Widziałem komunikaty o zatwierdzaniu, które odnoszą się do konkretnego problemu / żądania ściągnięcia. Jaka jest składnia, aby uwzględnić problem z konkretnym repozytorium lub żądanie ściągnięcia?

git github commit github-flavored-markdown AlbertEngelB
źródło
Na githubie jest świetna biblioteka do tworzenia tych linków programowo: github.com/doowb/github-issue-template oraz strona internetowa, na której możesz podać kilka informacji i wygeneruje link: doowb.github.io / github-issue-template
jonschlinkert
Zobacz także „ Szablony wielu wydań i żądań ściągnięcia ”, od stycznia 2018 r.
VonC
1
Możliwy duplikat linku do numeru wydania na GitHub w komunikacie o zatwierdzeniu
Didier L
@DidierL Jeśli chodzi o datę, pytanie, do którego prowadzi łącze, nie powinno być duplikatem mojego? Rozumiem, że zamykając to dla połączonego pytania, patrząc na głosy za i treść ( Fixes XXXXskładnia nie została skonfigurowana, gdy została zadana na początku), bardziej zastanawiam się, co stanowi duplikat pytania w stosunku do drugiego. Miałem już zamknięte podobne stare pytania, ale nazwanie ich duplikatem nie jest do końca poprawne.
AlbertEngelB
Cóż, drugie pytanie jest starsze, prawda? (2009 vs 2014). Jak zauważyłeś, ma również więcej głosów, a ODPOWIEDŹ, pytania są dokładnie takie same, a odpowiedzi tutaj zawarte są zawarte w zaakceptowanej odpowiedzi.
Didier L

Odpowiedzi:

88

Użyj udokumentowanego formatu automatycznego łączenia problemów w repozytoriach.

  • Składnia: {owner}/{repository}#{issue_number}
  • Przykład: mojombo/jekyll#1

Gdy taki sformatowany tekst jest obecny w komunikacie zatwierdzenia, jest on automatycznie przekształcany w klikalny link, który przekieruje do https://github.com/{owner}/{repository}/issues/{issue_number}

nulltoken
źródło
7
Dostarczona składnia działa w przypadku łączenia między repozytoriami (tj. Zatwierdzenie w repozytorium B, które łączy się z problemem w repozytorium A). Wskazując na problemy w tym samym repozytorium, możesz użyć krótkiej składni#{issue_number}
nulltoken
4
Jest to dobre w przypadku problemów, ale nie widzę nic na temat łączenia z żądaniem ściągnięcia.
bryanbraun
2
@bryanbraun Ta składnia działa również w przypadku żądań ściągania.
nulltoken
2
@nulltoken Jaka jest dokładnie składnia cytowania (i łączenia) z żądaniem ściągnięcia? Jeśli mojombo/jekyll#1dotyczy problemu 1, jaka jest składnia żądania ściągnięcia 1?
Rob Stewart
15
@RobStewart to samo. Nie możesz mieć w repozytorium zarówno wydania 1, jak i żądania ściągnięcia 1.
nulltoken
32

Numer PR / numer wydania akcji Github używa tej samej sekwencji.

A więc jeden numer albo jeden PR lub jeden problem.

Po prostu użyj #numer jest OK.

zw963
źródło
Ta odpowiedź zasługuje na więcej uwagi. Nigdy tego nie zauważyłem. Dziękuję Ci!
Wildcard
Żałuję, że nie przeliterowali tego w dokumentacji githuba. Jestem pewien, że gdzieś tam jest, ale go nie widziałem.
Darryl
31

Użyj #1234w komentarzu, aby odwołać się do żądania ściągnięcia 1234 z bieżącego repozytorium.

geg
źródło
1

W przypadku linku do innego repozytorium, jeśli po prostu wkleisz link do problemu lub żądanie ściągnięcia, powiedzmy https://github.com/{owner}/{repository}/issues/{issue_number}, GitHub wyrenderuje go jako

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

Na przykład https://github.com/jlord/sheetsee.js/issues/26 wyrenderuje się jako jlord / sheetsee.js # 26 .

Zobacz https://help.github.com/articles/autolinked-references-and-urls/#issues-and-pull-requests

Matt G.
źródło