Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы может все еще выполняться. Актуальные сведения см. в документации на английском языке.
В настоящее время GitHub AE находится в ограниченном выпуске.

Создание одного шаблона проблем для репозитория вручную

Когда вы добавите шаблон созданной вручную проблемы в репозиторий, участники проекта автоматически увидят содержимое шаблона в текстовой области проблемы.

Это устаревший рабочий процесс для создания шаблона проблемы. Для создания шаблонов проблем рекомендуется использовать обновленный построитель шаблонов нескольких проблем или формы проблем. Дополнительные сведения см. в статье "Сведения о шаблонах проблем и запросов на вытягивание.

Можно создать подкаталог 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".

Добавление шаблона проблемы

  1. На ваше предприятие перейдите на главную страницу репозитория. 1. Над списком файлов в раскрывающемся списке Добавить файл щелкните Создать файл. "Создать файл" в раскрывающемся списке "Добавить файл"
  2. В поле имени файла:
    • Чтобы сделать шаблон проблемы видимым в корневом каталоге репозитория, введите имя 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. Можно также хранить шаблоны для нескольких проблем в подкаталоге ISSUE_TEMPLATE в корне или каталогах docs/. Дополнительную информацию см. в разделе Сведения об автоматизации проблем и запросов на вытягивание с параметрами запроса. Шаблон для нескольких новых проблем в скрытом каталоге
  3. Добавьте шаблон проблемы в текст нового файла. Это может быть:
    - Титульный лист YAML
    - Ожидаемое поведение и фактическое поведение
    - Шаги по воспроизведению проблемы
    - Спецификации, такие как версия проекта, операционной системы или оборудования 1. В нижней части страницы введите короткое понятное сообщение о фиксации, описывающее внесенное в файл изменение. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе [Создание фиксации с несколькими соавторами](/articles/creating-a-commit-with-multiple-authors).
    
    Сообщение о фиксации для изменения 1. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание нового запроса на вытягивание. Параметры фиксации ветви Шаблоны доступны участникам совместной работы при слиянии их в ветвь по умолчанию репозитория.
  4. Щелкните Предложить новый файл Кнопка "Предложить новый файл"

Дополнительные материалы