タスクリストの作成

タスクリストは、GitHub Enterprise Cloud UI または Markdown を使用して作成できます。

この記事の内容

注: タスクリストはプライベート ベータ版であり、変更される可能性があります。 現在、ベータ版へのオンボードを一時停止しています。

UI でのタスクリストの作成

[タスクリストの追加] ボタンを使用すると、自分の issue にタスクリストをすばやく追加できます。 [タスクリストの追加] ボタンは、isuue を表示または編集する際に使用できます。

  1. 新しいタスクリストを含める issue に移動します。 issue を新規に作成することもできます。

  2. issue の説明の下部にある [ タスクリストの追加] をクリックします。

    issue のスクリーンショット。 [タスクリストの追加] ボタンがオレンジ色の枠線で囲まれています。

  3. これで、新しいタスクリストに issue、pull request、下書きタスクを追加できます。 詳しくは、「タスクリストでのタスクの管理」を参照してください。

Markdown を使用したタスクリストの作成

issue の説明 (issue の開始コメント) では Markdown を使用してタスクリストを作成できます。 issue および pull request へのリンクを含めることも、ドラフト issue を作成することもできます。

タスクリストを追加するには、以下の Markdown を issue の説明にコピーします。

Markdown
```[tasklist]
### My tasks
- [ ] https://github.com/octo-org/octo-repo/issues/45
- [ ] Draft task
```

issue の編集中に [タスクリストの追加] ボタンを使用して、タスクリストに対して Markdown を挿入することもできます。

issue のスクリーンショット。 [タスクリストの追加] ボタンがオレンジ色の枠線で囲まれています。

タスクリスト Markdown の編集を開始したら、新しいタスクを追加できます。それには、それぞれの新しいタスクの前に - [ ] を付けてから、次のいずれかを追加します。

  • 下書きタスク。 ドラフトタスクは、後で issue に変換できるテキストです。
  • issue または pull request への完全なリンク。 たとえば、https://github.com/octo-org/octo-repo/issues/45 のようにします。 issue または pull request がタスクリストと同じリポジトリにある場合は、#ISSUE-NUMBER 短縮構文を使用できます。 たとえば、#45 のようにします。

ドラフトタスクを追加する場合は、次の要件を満たす必要があります。

  • 下書きタスクは Markdown を使用して書式設定できます。
  • 下書きタスクは 512 文字以内とする必要があります。

変更内容をプレビューする場合、および issue を保存する場合、タスクリストは GitHub Enterprise Cloud によってレンダリングされます。 これで、GitHub Enterprise Cloud UI を使用することで、変更と、issue および下書きタスクの追加が行えるようになります。 issue の説明を編集する場合、Markdown を直接変更することも、Markdown をコピーして他の issue のタスクリストを複製することもできます。

タスクリストのタイトルの変更

新しいタスクリストを作成すると、既定のタイトルは "タスク" になります。 タイトルを変更するには、タスクリストのコンテキスト メニューにある [ 名前の変更] をクリックするか、issue の Markdown を編集します。

  1. issue の本文の右上にある を選び、 [編集] をクリックします。

    issue コメントのヘッダーのスクリーンショット。 右上隅に、水平方向のケバブ アイコンが濃いオレンジ色の枠線で囲まれています。

  2. ```[tasklist] で始まるフェンスされたコード ブロックで、### My new title などの新しいタイトルを含むヘッダーを追加します。

    issue のコメントの編集モードでのスクリーンショット。 "```tasklist" という行の下に、"### My new title" という行が濃いオレンジ色の枠線で囲まれています。

  3. [コメントの更新] をクリックします。

タスクリストのコピー

[Markdown のコピー] オプションを使用してタスクリストをコピーすると、GitHub Enterprise Cloud によって Markdown がクリップボードにコピーされ、issue タイトルも含められるため、コンテキストを失うことなく GitHub の外部にタスクリストを貼り付けることができます。 コピーした Markdown タスクリストの例については、以下を参照してください。

- [x] [Design new landing page](https://github.com/octocat/octoproject/issues/4)
- [ ] [Translate content into supported languages](https://github.com/octocat/octoproject/issues/11)

  1. タスクリストの右上の をクリックします。

    タスクリストのスクリーンショット。 水平のケバブ アイコンでラベル付けされた追跡ブロック項目のメニューが、濃いオレンジ色の枠線で囲まれています。

  2. メニューで、 [Markdown のコピー] をクリックします。