리포지토리에 대한 단일 문제 템플릿 수동으로 만들기

지원 폴더에 ISSUE_TEMPLATE/ 하위 디렉터리를 만들어서 다중 문제 템플릿을 포함하고 template 쿼리 매개 변수를 사용하여 문제 본문을 채울 템플릿을 지정할 수 있습니다. 자세한 내용은 "문제 만들기"을(를) 참조하세요.

각 문제 템플릿에 YAML 프런트매터를 추가하여 문제 제목을 미리 채우고, 레이블 및 담당자를 자동으로 추가하고, 다른 사용자가 내 리포지토리에서 새 문제를 만들 때 볼 수 있는 템플릿 선택기에서 표시되는 이름과 설명을 템플릿에 제공할 수 있습니다.

다음은 YAML 프런트매터의 예시입니다.

---
name: Tracking issue
about: Use this template for tracking new features.
title: "[DATE]: [FEATURE NAME]"
labels: tracking issue, needs triage
assignees: octocat
---

검사마크를 커뮤니티 프로필 검사 목록에 표시하려면 문제 템플릿이 .github/ISSUE_TEMPLATE 폴더에 있어야 하며 유효한 name: 및 YAML 프런트매터(.md 파일에 정의된 문제 템플릿의 경우)의 about: 키 또는 name: 및 description: 키(.yml 파일에 정의된 문제 양식의 경우)에 있어야 합니다.

기본 문제 템플릿을 만들고 조직 또는 개인 계정에 대한 문제 템플릿의 기본 구성 파일을 만들 수 있습니다. 자세한 내용은 "Creating a default community health file(기본 커뮤니티 상태 파일 만들기)"을(를) 참조하세요.

문제 템플릿 추가

1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

2. 파일 목록 위에서 파일 추가 드롭다운 메뉴를 선택하고 새 파일 만들기를 클릭합니다.

   또는 왼쪽의 파일 트리 보기에서 을(를) 클릭합니다.

   

3. 파일 이름 필드에서 다음을 수행합니다.

   • 리포지토리의 루트 디렉터리에 문제 템플릿을 표시하려면 issue_template 이름을 입력합니다. 예들 들어 issue_template.md입니다.
   • 리포지토리의 docs 디렉터리에 문제 템플릿을 표시하려면 docs/ 다음에 issue_template 이름을 입력합니다. 예시: docs/issue_template.md.
   • 파일을 숨겨진 디렉터리에 저장하려면 .github/ 다음에 issue_template 이름을 입력하세요. 예들 들어 .github/issue_template.md입니다.
   • 여러 문제 템플릿을 만들고 template 쿼리 매개 변수를 사용하여 문제 본문을 채울 템플릿을 지정하려면 .github/ISSUE_TEMPLATE/ 을 입력한 다음 문제 템플릿의 이름을 입력합니다. 예들 들어 .github/ISSUE_TEMPLATE/issue_template.md입니다. 루트 또는 docs/ 디렉터리 내의 ISSUE_TEMPLATE 하위 디렉터리에 여러 문제 템플릿을 저장할 수도 있습니다. 자세한 내용은 "문제 만들기"을(를) 참조하세요.

4. 새 파일의 본문에 문제 템플릿을 추가합니다. 여기에는 다음이 포함될 수 있습니다.

   • YAML 프런트매터
   • 예상 동작 및 실제 동작
   • 문제를 재현하기 위한 단계
   • 프로젝트 버전, 운영 체제 또는 하드웨어

5. 변경 내용 커밋... 을 클릭합니다.

6. "커밋 메시지" 필드에, 파일의 변경 내용을 설명하는 커밋 메시지를 간결하고 명확하게 입력합니다. 커밋 메시지에서 둘 이상의 작성자가 커밋의 특성을 지정할 수 있습니다. 자세한 내용은 "여러 작성자와 커밋 만들기"을(를) 참조하세요.

7. 커밋 메시지 필드 아래에서 현재 분기 또는 새 분기에 커밋을 추가할지 여부를 결정합니다. 현재 분기가 기본 분기인 경우 커밋에 대한 새 분기를 만든 다음 끌어오기 요청을 만들도록 선택해야 합니다. 자세한 내용은 "끌어오기 요청 만들기"을(를) 참조하세요.

   
   템플릿과 같은 사양은 협력자가 리포지토리의 기본 분기에 병합할 때 사용할 수 있습니다.

8. 변경 내용 커밋 또는 변경 내용 제안을 클릭합니다.

추가 참고 자료

• "문제 및 끌어오기 요청 템플릿 사용"
• "리포지토리에 대한 문제 템플릿 구성"
• "문제 만들기"