作品を出す

ギャラリーに並べたい作品の出しかたです。GitHub のアカウントがあれば、どなたでも出せます。

作った人の名前は、ニックネームにしてください。 ここに書いたことは誰でも見られる場所に出ます。本名・学校名・住所は書かないでください。

まず、作品のファイルを作る

URB Block Lab で 「.rb で保存」を押すと、作品のファイルができます。ほかの人の作品を代わりに出すときは、そのファイルを受け取ってください。

この .rb は、そのまま動く Ruby の後ろに、ブロックの並びが # urb-block/1 … というコメントで畳んで入っています。ギャラリーはそこを読んでブロックに戻すので、このコメントを消すと開けなくなります。メモ帳などで開いて消さないでください。

出しかた（GitHub のプルリクエスト）

作品 1 件は新しいファイル 2 つです。すでにあるファイルには触りません。そうしてあるので、何人が同時に出しても、ぶつかりません。

GitHub のアカウントを持っている子は、自分で出してみてください。 プルリクエストを出すこと自体が、GitHub の練習になります。世界中の開発が同じやり方で回っていて、その一通りを、自分の作品を出したいという気持ちのまま踏めます。手順は下に書いたとおりで、書きかたを間違えても点検が日本語で教えてくれますし、 取り込まれるまで一覧には何も起きません。失敗しても壊れません。

アカウントを持っていない子は、大人が代わりに出してください。

名前（id）を決める
半角英数と - _ . だけで、短くつけます（例: blink-taro）。ファイル名と、ページのアドレスに使われます。すでにある作品と同じ名前にはできません。
2 つのファイルを置く
- docs/works/<id>.rb — 保存した .rb の名前を変えたもの
- docs/works/<id>.json — 下の書きかたで作る
絵を付けたいときは docs/thumbs/<id>.png か docs/thumbs/<id>.jpg も置きます（無くてかまいません）。 1 つの作品に絵は 1 枚です。大きさは 512 KB まで、縦横は 2000 px までにしてください。
プルリクエストを出す
urb-gallery に対して出してください。 GitHub のページ上だけでもできます（次の節）。
点検が通るのを見る
プルリクエストを出すと、書きかたの点検が自動で走ります。緑になれば大丈夫です。赤くなったら、何が悪いかがそこに出ます。

GitHub のページ上だけで出す

Git のコマンドは要りません。ブラウザだけで最後まで進められます。

urb-gallery を開いて、右上の Fork を押す（自分のコピーができます）
コピーのほうで docs/works フォルダを開き、Add file → Upload files で <id>.rb を置く
同じ所で Add file → Create new file を選び、名前を <id>.json にして、下のひな形を貼って書き換える
画面の下で Commit changes（新しいブランチを作る方を選んでおくと安全です）
Contribute → Open pull request を押す

`<id>.json` の書きかた

{
  "title": "1秒ごとに光る",
  "author": "たろう",
  "group": "CoderDojo 和歌山",
  "region": "和歌山県",
  "kind": "光る",
  "desc": "ピン2につないだ LED を、1秒ごとに点けたり消したりします。",
  "tags": ["LED", "はじめて"],
  "lab": "block",
  "date": "2026-09-03"
}

項目	中身
（ファイル名）	`id` は書きません。`<id>.json` の `<id>` がそのまま使われます
`title`	題名
`author`	作った人。ニックネームで
`group`	所属（教室・クラブ・学校など。例: `CoderDojo 和歌山`）。無ければ省略できます
`region`	都道府県。「県」「府」「都」まで書きます（「和歌山」だけでは点検で止まります）
`kind`	種類。下の 7 つから 1 つ
`desc`	ひとこと説明
`tags`	自由に何個でも。`#` は付けません（出すときに付きます）
`lab`	`block`（URB Block Lab で作ったもの）
`date`	作った日。`2026-09-03` の形で

種類

光る音うごくはかるゲーム・あそび役に立つものその他

点検で止まったら

よくあるのは次のものです。書き直して、もう一度置けば通ります。

出るもの	直しかた
`<id>.rb がありません`	`.json` と `.rb` の名前を同じにします
`kind「…」は種類の一覧にありません`	上の 7 つのどれかにします
`region「…」は都道府県ではありません`	「和歌山県」のように最後まで書きます
`tags に # は付けません`	`["LED"]` のように書きます
`.rb に「# urb-block/1 …」の行がありません`	URB Block Lab の「.rb で保存」で出したファイルを置きます
`対応する作品がありません`	絵の名前を作品と同じにします（`<id>.png` か `<id>.jpg`）
`絵が 2 つあります`	`.png` と `.jpg` のどちらか 1 つを消します

作品を下げたいとき

出した作品を消したくなったら、これもプルリクエストで出します。消すのはその作品のファイルだけです。

docs/works/<id>.rb
docs/works/<id>.json
docs/thumbs/<id>.png か .jpg（置いていた場合）

3 つとも消してください。片方だけ残っていると点検で止まります。消す PR は点検では赤くなりませんが、何を消したかがコメントに出るので、取り込む前に人が確かめます。

入ったあと

プルリクエストが取り込まれると、一覧は自動で作り直されます。目次のファイルを誰かが書き足す必要はありません。しばらくすると作品の一覧に並びます。