커밋에서 변경 로그 초안 작성
Changelog draft는 두 시점 사이의 첫 번째 상위 커밋을 읽고, 그룹화하고, 다음 버전을 제안하고, Markdown을 복사할 수 있게 해줍니다. 메모에는 초안일 뿐이라고 나와 있습니다. 아무것도 태그되거나 해제되거나 푸시되지 않습니다. 메시지를 공유하기 전에 검토합니다.
GitTree 무료로 작동합니다. 모든 로컬 Git 기능은 계정이 필요하지 않습니다.
시작하기 전에
- 변경 로그 초안은 무료 계획의 일부입니다. 두 끝점 모두 이미 커밋되어 있어야 합니다. 대화상자에는 완료될 때까지 Choose both committed endpoints라고 표시됩니다.
- 그룹화하려는 메시지는 Conventional Commits(
feat:,fix:,feat!:) 뒤에 와야 합니다. 일반 메시지도 검토 대상으로 간주됩니다. 그것들은 발명된 카테고리가 아닙니다.
어디서 찾을 수 있나요?
- 커밋 메뉴 또는 태그 메뉴: Changelog draft.
Alt+L또는 명령 팔레트입니다.
| 액션 | macOS | Windows 및 Linux |
|---|---|---|
| Changelog draft | ⌥L | Alt+L |
| 명령 팔레트 | ⌘⇧P | Ctrl+Shift+P |
단계
변경 로그 초안 열기
범위를 종료해야 하는 커밋 또는 메모를 작성 중인 태그를 선택하고 Changelog draft을 선택합니다.
Alt+L를 누를 수도 있습니다. 제목은 Changelog draft입니다. 메모에는 다음과 같습니다. Draft only. Review commit messages before sharing. Nothing is published.
변경 로그 초안은 이 메뉴와 태그 메뉴에 있습니다. 여전히 커밋 메뉴가 표시됩니다.데모 저장소와의 GitTree 인터페이스입니다. 범위 설정
From (excluded)은(는) 이미 릴리스한 커밋 또는 태그입니다. To (included)은(는) 새로운 팁입니다. 범위 라인은 초안이 첫 번째 상위 기록을 사용한다고 말합니다. 병합을 통해서만 도착한 커밋은 하나씩 나열되지 않고 병합 커밋으로 표시됩니다.
초안 생성
Generate draft를 누르세요. Stop는 기록 읽기를 완료하도록 요청합니다. 초안은 Editable Markdown draft 아래에 표시됩니다. 버전이 제안될 수 있으면 Suggested version, 버전 태그가 제외된 끝점을 가리킬 때는 Baseline tag가 표시됩니다. Copy Markdown이(가) 복사했습니다. Markdown copied이 사본을 확인합니다.
편집한 다음 어디로 갈지 결정하세요
상자에서 Markdown을 편집합니다. Replace draft with proposal는 편집 후 생성된 텍스트를 다시 넣습니다. 엔드포인트를 변경하면 GitTree에서는 엔드포인트가 변경되었으며 편집한 초안이 유지된다는 메시지를 표시합니다. 릴리스에 대한 메모를 작성할 때 Insert draft into release notes가 제공됩니다. 편집 후 닫으면 Discard edited draft? 단어가 필요한 경우 먼저 복사하세요.
예상되는 결과
클립보드나 릴리스 노트 필드에 Markdown이 있습니다. 태그가 생성되지 않았고 릴리스도 게시되지 않았습니다. 릴리스에 그룹을 붙여넣기 전에 그룹을 읽어보세요. 일반 메시지, 되돌리기 및 병합이 호출되어 다시 작성할 수 있습니다.
커밋을 그룹화하는 방법
| 그룹 | 거기에 무엇이 놓여 있는지 |
|---|---|
| 주요 변경 사항 | ! 또는 BREAKING CHANGE 바닥글을 포함하여 중단된 것으로 표시된 커밋 |
| 특징 | 위업 커밋 |
| 수정 | 커밋 수정 |
| 성능 | 성능 커밋 |
| 기타 | 위에 해당되지 않는 인식된 유형과 아직 확인이 필요한 메시지 |
카운트 라인은 일반 메시지, 되돌리기, 병합 및 디코딩할 수 없는 메시지가 포함된 Needs review입니다. 이러한 숫자로 인해 버전이 보류될 수 있습니다. No commits in this range; no release is proposed은 엔드포인트가 모든 커밋을 제외함을 의미합니다.
제안된 버전을 선택하는 방법
제안은 제외된 엔드포인트의 버전 태그에서 시작됩니다. 대화 상자에서는 이유를 설명합니다. 주요 변경 사항은 주요 버전을 제안하거나, 주요 버전이 0인 동안 부 버전을 제안합니다. 기능은 미성년자를 제안합니다. 다른 인정된 Conventional Commits이(가) 패치를 제안했습니다. 제안을 무시할 수 있습니다. Choose the next version after review은 GitTree가 하나를 선택하지 않을 때 나타납니다.
git log --first-parent --pretty=format:%s v1.2.0..HEAD
git tag --points-at v1.2.0^{}제외된 커밋부터 포함된 팁까지 터미널의 동일한 범위는 git log --first-parent입니다. GitTree는 git tag을(를) 실행하지 않습니다. 태그를 생성하는 것은 태그입니다. 호스트에 노트를 게시하는 것은 별도의 릴리스 작업입니다. 태그에 대한 튜토리얼 강의에서는 태그가 커밋 이름을 지정하는 방법을 보여줍니다.
아무것도 게시되지 않았습니다
Copy Markdown는 텍스트만 복사합니다. Insert draft into release notes은 필드를 채웁니다. 태그, GitHub 릴리스 또는 푸시도 생성하지 않습니다. 복사가 실패하면 대화 상자에 Could not copy. Select and copy the draft text. 편집된 초안은 교체하거나 폐기할 때까지 상자에 남아 있습니다.
뭔가 잘못되면
"커밋된 엔드포인트를 모두 선택하세요."
From 또는 To는 아직 커밋이 아닙니다. 두 개의 커밋을 선택하거나 커밋을 가리키는 태그를 선택하세요. 확인되지 않는 분기 이름은 생성되지 않습니다.
"제외된 엔드포인트에는 버전 태그가 없습니다."
늘릴 것이 없습니다. 다음 버전을 직접 선택하거나 제외된 커밋에 먼저 태그를 지정하고 다시 생성하세요.
"다른 버전 태그가 제외된 엔드포인트를 가리킵니다. 기준 버전을 선택하세요."
해당 커밋에는 두 개 이상의 버전 태그가 있습니다. 원하는 기준선을 선택하세요. GitTree는 어떤 태그가 제품 버전인지 추측하지 않습니다.
"기준은 시험판입니다. 릴리스 채널과 버전을 선택하세요."
시험판 태그는 다음 안정 번호를 의미하지 않습니다. 채널과 버전을 선택한 다음 초안을 유지하세요.
"복사할 수 없습니다. 초안 텍스트를 선택하여 복사하세요."
클립보드가 거부되었습니다. 상자에서 Markdown을 선택하고 시스템 바로가기를 사용하여 복사합니다. 초안은 아직 남아있습니다.
질문
변경 로그 초안이 릴리스를 생성합니까?
아니요. 메모에는 게시된 내용이 없다고 나와 있습니다. Markdown을 복사하거나 릴리스 노트에 삽입합니다. 자신을 태그하고 게시합니다.
어떤 커밋이 포함되나요?
제외된 끝점부터 팁까지의 첫 번째 상위 기록입니다. 병합된 브랜치의 커밋은 병합 커밋으로 표시됩니다.
추천 버전이 없는 이유는 무엇입니까?
기본 태그가 없거나 모호하거나 시험판인 경우, 일반 메시지, 되돌리기, 병합 또는 디코딩할 수 없는 메시지를 검토해야 하는 경우 또는 버전 구성 요소를 증분할 수 없는 경우 대화 상자에서는 하나를 보류합니다.
내 편집 내용이 새로운 범위에서도 유지되나요?
네, 교체할 때까지요. 대화상자에는 편집한 초안이 보존된다는 메시지가 표시됩니다. 초안을 제안으로 바꾸면 새 텍스트로 덮어쓰게 됩니다.
Conventional Commits을(를) 사용해야 합니까?
아니요. 일반 메시지는 검토 필요 아래에 나열됩니다. 그룹과 제안된 버전은 피험자가 feat, fix 및 주요 변경 마커를 사용할 때 더 구체적입니다.