Issueテンプレートビルダー

GitHubのYAML Issueフォーム（2021年導入）は、ドロップダウンやチェックボックスなどの特定のフィールドタイプを持つ構造化フォームを作成します。一貫性があり、機械解析可能なIssueを生成します。クラシックMarkdownテンプレートは、ユーザーが自由に編集できる事前入力済みのMarkdownドキュメントを提供します。YAMLフォームはより良い構造を、Markdownテンプレートはより柔軟性を提供します。GitLabは現在Markdownフォーマットのみをサポートしています。

GitHub YAMLイシューフォームの場合、.github/ISSUE_TEMPLATE/bug-report.yml（.ymlで終わる任意の名前）として保存します。クラシックMarkdownテンプレートの場合、.github/ISSUE_TEMPLATE/bug-report.mdとして保存します。GitHubは.github/ISSUE_TEMPLATE/ディレクトリ内のテンプレートを自動的に検出します。GitLabの場合、.gitlab/issue_templates/ディレクトリにMarkdownテンプレートを配置します。

はい。.github/ISSUE_TEMPLATE/ディレクトリに好きなだけテンプレートファイルを追加できます。GitHubは新しいIssue作成時にテンプレート選択画面をユーザーに表示します。config.ymlファイルを追加して、外部リンクでチューザーをカスタマイズしたり、空白のIssueを無効にしたりすることもできます。

GitHub Issueフォームは5つのフィールドタイプをサポートしています：textarea（オプションのMarkdownレンダリング付き複数行テキスト入力）、input（オプションのバリデーション正規表現付き単一行テキスト）、dropdown（単一または複数選択の選択メニュー）、checkboxes（チェック可能な項目リスト）、markdown（説明用の静的表示テキスト）。markdown以外の各タイプには必須にするバリデーションオプションがあります。

このビルダーでは、textareaとinputフィールドにプレースホルダーテキストを設定できます。dropdownフィールドでは最初のオプションがデフォルトで表示されます。生成されたYAMLでは、textareaまたはinputフィールドに手動で'value'属性を追加して、ユーザーが変更できるデフォルトテキストを事前入力できます。

はい。すべてのテンプレート生成はJavaScriptを使用してブラウザ内で完全に実行されます。テンプレート名、ラベル、担当者、フォームコンテンツなどのデータがサーバーに送信されることはありません。ツール使用中にブラウザの開発者ツールのネットワークタブで確認できます。

はい、ただし制限があります。'クラシックMarkdownテンプレート'出力フォーマットを選択してください。GitHubとGitLabの両方に対応するMarkdownが生成されます。GitLabはYAML Issueフォーム構文をサポートしていないため、GitLabリポジトリにはMarkdownフォーマットを使用してください。生成されたファイルはリポジトリの.gitlab/issue_templates/に保存してください。