自作教材の配布方法

PyHiroba で教材を作る

コードセル・テキストセル・スライドセルを使って、演習ノートブックを作ります。説明（テキスト）、プログラム（コード）、図やスライドを 1 つのノートにまとめられます。

Google Colaboratory で作ったノートブックを使うこともできます。

.ipynb としてダウンロードする

ヘッダーの「ダウンロード」ボタンを押すと、作った教材が .ipynb ファイルとして手元に保存されます。

Google Drive にアップロードして公開する

保存した .ipynb ファイルを Google Drive にアップロードします。ファイルを右クリックして「共有」を開き、共有設定を「リンクを知っている全員（閲覧者）」にします。

例えば、都立AI などの API を使う教材では、コードに API キーを書くことがあります。共有したファイルはリンクを知っている人なら誰でも中身を読めるため、公開用のファイルからはキーを消しておき、キーの部分を ここにAPIキーを入力してください のような文言に置き換えておくと、生徒が自分のキーを入れて使えます。

URL につなげて生徒に配布する

共有リンクを次の欄に貼り、「リンクを作る」を押してください。生徒に配る短いリンクができます。ノートブックでも、フォルダでも作れます。

ノートブックを1本だけ配る

ファイルID は、共有リンクの /d/ や /drive/ の後ろにある文字列です。Google Colaboratory の共有リンクからも作れます。

フォルダごとまとめて配る

1回の授業で使うものが複数あるときは、フォルダごと配れます。ノートブックのほか、ドキュメント・スライド・PDF もまとめて渡せます。

Google Drive でフォルダを作り、配りたいファイルを入れます。フォルダの共有設定も、ファイルと同じように「リンクを知っている全員（閲覧者）」にします。

フォルダID は、共有リンクの /folders/ の後ろにある文字列です。

この URL を開くと、フォルダの中身が一覧で表示されます。ノートブックはその場で開き、Google ドキュメントは docx、Google スライドは pptx、スプレッドシートは xlsx でダウンロードできます。PDF は画面上で読むこともできます。

一覧から開いた教材では、コードセルに #pyhiroba files data.csv と書くと、同じフォルダにあるデータのファイル（csv・xlsx など）を読み込めます。ノートブックを1本だけ配るリンクから開いたときは使えません。

フォルダの共有設定は、中に入れたファイルすべてに及びます。生徒も同じ書き方で同じフォルダのファイルを読み込めるため、名簿や解答、採点用のファイルは、別のフォルダに分けておきます。

どちらの場合も、URL を生徒に知らせれば配布は完了です。Drive 上のファイルを差し替えると、同じ URL から最新の教材が開きます。