注: タスクリストはプライベート ベータ版であり、変更される可能性があります。 現在、ベータ版へのオンボードを一時停止しています。
UI でのタスクリストの作成
[タスクリストの追加] ボタンを使用すると、自分の issue にタスクリストをすばやく追加できます。 [タスクリストの追加] ボタンは、isuue を表示または編集する際に使用できます。
-
新しいタスクリストを含める issue に移動します。 issue を新規に作成することもできます。
-
issue の説明の下部にある [ タスクリストの追加] をクリックします。
-
これで、新しいタスクリストに issue、pull request、下書きタスクを追加できます。 詳しくは、「タスクリストでのタスクの管理」を参照してください。
Markdown を使用したタスクリストの作成
issue の説明 (issue の開始コメント) では Markdown を使用してタスクリストを作成できます。 issue および pull request へのリンクを含めることも、ドラフト issue を作成することもできます。
タスクリストを追加するには、以下の Markdown を issue の説明にコピーします。
```[tasklist] ### My tasks - [ ] https://github.com/octo-org/octo-repo/issues/45 - [ ] Draft task ```
```[tasklist]
### My tasks
- [ ] https://github.com/octo-org/octo-repo/issues/45
- [ ] Draft task
```
issue の編集中に [タスクリストの追加] ボタンを使用して、タスクリストに対して Markdown を挿入することもできます。
タスクリスト 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 を編集します。
-
issue の本文の右上にある を選び、 [編集] をクリックします。
-
```[tasklist]
で始まるフェンスされたコード ブロックで、### My new title
などの新しいタイトルを含むヘッダーを追加します。 -
[コメントの更新] をクリックします。
タスクリストのコピー
[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)
-
タスクリストの右上の をクリックします。
-
メニューで、 [Markdown のコピー] をクリックします。