리포지토리에 대한 문제 템플릿 구성

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

문제 템플릿 만들기

1. GitHub Enterprise Server 인스턴스에서 리포지토리의 기본 페이지로 이동합니다.

2. 리포지토리 이름 아래에서 Settings(설정)를 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

3. “기능” 섹션의 문제에서 템플릿 설정을 클릭합니다. 단추를 보려면 문제를 허용하고 페이지를 새로 고쳐야 할 수도 있습니다.

4. 템플릿 추가 드롭다운 메뉴를 사용하여 만들려는 템플릿 유형을 클릭합니다.

   

5. 리포지토리에 커밋하기 전에 템플릿을 미리 보거나 편집하려면 템플릿 옆에 있는 미리 보기 및 편집을 클릭합니다.

6. 템플릿을 편집하려면 을(를) 클릭하고 필드에 입력하여 콘텐츠를 편집합니다.

   

7. 기본 문제 제목을 자동으로 설정하거나, 리포지토리에 대한 읽기 권한이 있는 사용자에게 문제를 할당하거나, 템플릿에 발생한 문제에 레이블을 적용하려면 “선택적 추가 정보” 아래에 있는 필드를 사용합니다. YAML Frontmatter 형식의 title, labels 또는 assignees을(를) 사용하여 문제 템플릿에 이러한 세부 정보를 추가할 수도 있습니다.

8. 템플릿 수정 및 미리 보기가 끝나면 페이지 오른쪽 위에 있는 변경 내용 제안을 클릭합니다.

9. "메시지 커밋" 필드에 변경 내용을 설명하는 커밋 메시지 입력합니다.

10. 커밋 메시지 필드 아래에서 템플릿을 기본 분기에 직접 커밋할지 또는 새 분기를 만들고 끌어오기 요청을 열 것인지 결정합니다. 끌어오기 요청에 대한 자세한 내용은 "끌어오기 요청 정보"을(를) 참조하세요.

11. 변경 내용 커밋을 클릭합니다. 이러한 변경 내용이 기본 분기에 병합되면 참가자가 리포지토리에서 새 문제를 열 때 사용할 수 있는 템플릿이 제공됩니다.

템플릿 선택기 구성

.github/ISSUE_TEMPLATE 폴더에 config.yml 파일을 추가하여 사용자가 리포지토리에서 새 이슈를 만들 때 표시되는 이슈 템플릿 선택기를 사용자 지정할 수 있습니다.

blank_issues_enabled을(를) false(으)로 설정하여 기여자가 문제 템플릿을 사용하도록 권장할 수 있습니다. blank_issues_enabled을(를) true(으)로 설정하면 사람들이 빈 문제를 열 수 있는 옵션을 갖게 됩니다.

GitHub Enterprise Server을 외부에서 특정 보고서를 받으려면 사용자를 외부 사이트로 contact_links을(를) 보낼 수 있습니다.

다음은 config.yml 파일 예제입니다.

blank_issues_enabled: false
contact_links:
  - name: GitHub Community Support
    url: https://github.com/orgs/community/discussions
    about: Please ask and answer questions here.
  - name: GitHub Security Bug Bounty
    url: https://bounty.github.com/
    about: Please report security vulnerabilities here.

blank_issues_enabled: false
contact_links:
  - name: GitHub Community Support
    url: https://github.com/orgs/community/discussions
    about: Please ask and answer questions here.
  - name: GitHub Security Bug Bounty
    url: https://bounty.github.com/
    about: Please report security vulnerabilities here.

구성 파일은 파일이 리포지토리의 기본 분기에 병합될 때 템플릿 선택기를 사용자 지정합니다.

1. GitHub Enterprise Server 인스턴스에서 리포지토리의 기본 페이지로 이동합니다.

2. 파일 목록 위에서 파일 추가 드롭다운을 사용하여 새 파일 만들기를 클릭합니다.

3. 파일 이름 필드에 .github/ISSUE_TEMPLATE/config.yml을(를) 입력합니다.

4. 새 파일의 본문에 구성 파일의 내용을 입력합니다.

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

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

   

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

템플릿 순서 변경

문제 템플릿이 템플릿 선택기에 표시되는 순서를 설정할 수 있습니다. 템플릿 파일 이름을 변경하면 됩니다. .github/ISSUE_TEMPLATE 내의 템플릿은 영숫자 기준으로 목록으로 기재되며 파일 유형에 따라 그룹으로 묶입니다. YAML 파일이 Markdown 파일 앞에 표시됩니다.

템플릿 순서를 제어하려면 파일 이름 앞에 숫자를 접두사로 붙이세요. 예: 1-bug.yml, 2-feature-request.yml 및 3-epic.yml.

템플릿이 10개가 넘는 경우, 영숫자로 순서를 지정하면 11-bug.yml이 1-feature.yml과 2-support.yml 사이에 위치하게 됩니다. 원하는 순서를 유지하려면 숫자 형식의 파일 이름 앞에 추가로 0을 접두사로 붙이면 됩니다. 예: 01-feature.yml, 02-support.yml 및 11-bug.yml.

추가 참고 자료

• "문제 및 끌어오기 요청 템플릿 사용"
• "리포지토리에 대한 단일 문제 템플릿 수동으로 만들기"