教材リポジトリを同期・インポートする
教材リポジトリ画面では、GitHub 上の教材リポジトリを Exercode に接続し、差分を確認してからインポートできます。
対象者
できること
- GitHub App 経由で教材リポジトリを追加する
- 自分が追加した教材リポジトリを管理している組織に登録する
- GitHub 側の最新状態を同期する
- インポート前に差分を確認する
- インポート済み科目を開く
開き方
- ヘッダーの
教材リポジトリ を開きます。
- 対象リポジトリのカードを確認します。
操作の流れ
- 新しい教材リポジトリを追加したい場合は
自分のGitHubから追加 を使います。
- GitHub 上の追加や権限変更を反映したい場合は
自分のGitHubと同期 を実行します。
- 自分が追加した教材リポジトリを組織に登録したい場合は、対象リポジトリの
組織に登録 を押して登録先組織を選びます。
- 対象リポジトリの
インポート を押します。
- 確認ダイアログで、科目・問題・授業・教材・課題・ファイルの差分を確認します。
- 問題がなければインポートを確定します。
組織への登録
組織に登録 は、自分が GitHub App 経由で追加した未登録の教材リポジトリに表示されます。登録先として選べるのは、自分が管理者になっている組織です。
組織に登録すると、その組織の管理者も教材リポジトリを確認し、インポートできるようになります。また、登録したリポジトリからインポートした科目は、組織やグループに追加できるようになります。
差分確認で見ておきたい点
- 削除が含まれる場合は、既存の教材構成が変わる可能性があります。
ファイル は assets 配下の画像や PDF などの差分も含みます。- 変更がない場合は、そのまま再インポートしても内容は更新されません。
インポート後
- インポート済み科目がカード内に表示されます。
- 表示された科目名から科目画面を直接開けます。
失敗しやすい場合
- GitHub App から対象リポジトリが見えなくなっている
- ほかの教材リポジトリですでに使われている科目 ID や問題 ID と重複している
- 教材定義の参照関係や YAML 形式に不整合がある
エラーが出た場合は、まず 自分のGitHubと同期 を試し、その後も解消しなければ表示内容を確認して GitHub 側の設定や教材内容を見直してください。
関連ページ
