Git
Plik .mailmap: kojarzenie dostawcy i aliasów e-mail
Szukaj…
Składnia
- # Zamień tylko adresy e-mail
<primary@example.org> <alias@example.org> - # Zamień nazwę na adres e-mail
Współtwórca <podstawowy@example.org> - # Scal wiele aliasów pod jedną nazwą i adresem e-mail
# Uwaga: nie będzie to wiązało „Inne <alias2@example.org>”.
Współtwórca <podstawowy@example.org> <alias1@example.org> Współtwórca <alias2@example.org>
Uwagi
Plik .mailmap można utworzyć w dowolnym edytorze tekstowym i jest to zwykły plik tekstowy zawierający opcjonalne nazwy współpracowników, podstawowe adresy e-mail i ich aliasy. należy go umieścić w katalogu głównym projektu, obok katalogu .git .
Należy pamiętać, że to po prostu modyfikuje wizualne wyjście poleceń takich jak git shortlog lub git log --use-mailmap . Nie spowoduje to przepisania historii zatwierdzeń ani zapobiegania zatwierdzeniom z różnymi nazwami i / lub adresami e-mail.
Aby zapobiec zatwierdzeniom na podstawie informacji takich jak adresy e-mail, powinieneś zamiast tego używać haczyków git .
Scalaj współautorów za pomocą aliasów, aby wyświetlić liczbę zatwierdzeń w krótkiej liście.
Gdy współautorzy dodają do projektu z różnych maszyn lub systemów operacyjnych, może się zdarzyć, że użyją do tego różnych adresów e-mail lub nazw, co spowoduje fragmentację list współautorów i statystyk.
Uruchomienie git shortlog -sn aby uzyskać listę współautorów i liczbę zatwierdzeń przez nich, może dać następujące wyniki:
Patrick Rothfuss 871
Elizabeth Moon 762
E. Moon 184
Rothfuss, Patrick 90
To rozdrobnienie / rozłączenie można skorygować, udostępniając zwykły plik tekstowy .mailmap , zawierający mapowania wiadomości e-mail.
Wszystkie nazwiska i adresy e-mail wymienione w jednym wierszu zostaną odpowiednio powiązane z pierwszym nazwanym podmiotem.
W powyższym przykładzie mapowanie może wyglądać następująco:
Patrick Rothfuss <fussy@kingkiller.com> Rothfuss, Patrick <fussy@kingkiller.com>
Elizabeth Moon <emoon@marines.mil> E. Moon <emoon@scifi.org>
Gdy plik ten znajdzie się w katalogu głównym projektu, ponowne uruchomienie git shortlog -sn spowoduje utworzenie skróconej listy:
Patrick Rothfuss 961
Elizabeth Moon 946