Skip to main content

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

리포지토리에 수동으로 만든 문제 템플릿을 추가하면 프로젝트 기여자가 문제 본문에서 템플릿의 콘텐츠를 자동으로 볼 수 있습니다.

이슈 템플릿을 만드는 레거시 워크플로입니다. 업그레이드된 다중 이슈 템플릿 작성기 또는 이슈 양식을 사용하여 이슈 템플릿을 만드는 것이 좋습니다. 자세한 내용은 "문제 및 끌어오기 요청 템플릿 사용"을 참조하세요.

지원 폴더에 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
---

참고: 앞의 문제 값에 YAML 예약 문자(예: : )가 포함된 경우 전체 값을 따옴표로 넣어야 합니다. 예를 들어 ":bug: Bug" 또는 ":new: triage needed, :bug: bug"입니다.

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

문제 템플릿 추가

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

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

    기본 분기에 직접 커밋하거나 새 분기를 만드는 라디오 단추를 보여 주는 GitHub 끌어오기 요청의 스크린샷. 새 분기를 선택했습니다.
    템플릿과 같은 사양은 협력자가 리포지토리의 기본 분기에 병합할 때 사용할 수 있습니다.

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

추가 참고 자료