Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 14 additions & 14 deletions docs/extension-smalrubot-s1/README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# 拡張機能: アーテックロボ(Studuino)/旧 スモウルボットS1
# 拡張機能: アーテックロボ/旧 スモウルボットS1

> **🆕 Smalruby 独自** — upstream に存在しない、Smalruby のために新規追加された拡張機能

- **Smalruby ランタイム対応**: ❌(smalruby3 gem は未対応。WebSerial API 経由でハードウェアと通信するためブラウザ専用)
- **デフォルト表示**: ✅(拡張機能ライブラリにデフォルトで表示される)

> **いまの状態とこれから**: この拡張機能は、**同じ拡張機能のまま「アーテックロボ(Studuino)」の名前に変えた**(前の名前は「スモウルボットS1」。2027-11-30 までは前の名前のカードも残す。下の「移行期間(前の名前のカード)」)。
> **いまの状態とこれから**: この拡張機能は、**同じ拡張機能のまま「アーテックロボ」の名前に変えた**(前の名前は「スモウルボットS1」。2027-11-30 までは前の名前のカードも残す。下の「移行期間(前の名前のカード)」)。
> ブロックの表示は一般的な名前にし、実機が無くても動かせる **練習用の基板**(VM の中のしくみと、ステージの横のパネル)を入れた。
> このページは、いまの挙動と、リニューアルで決まった方針の両方を書く。
> 見分けがつくように、まだ実装していないことには **🚧 これから** と付ける(印の無いことは、いまの挙動)。
Expand All @@ -18,7 +18,7 @@

### リニューアルのねらい

- 中学校技術・家庭科の「計測・制御」の授業で、**アーテックロボ(Studuino)で授業ができる** と先生に伝わるようにする(スモウルボットは名前が知られていない)。
- 中学校技術・家庭科の「計測・制御」の授業で、**アーテックロボで授業ができる** と先生に伝わるようにする(スモウルボットは名前が知られていない)。
- 教科書は「光センサー」「仕事を行う部分」のような一般的な言葉で書かれているので、ブロックの表示も一般的な名前にする(いまは「左のセンサー」のようなロボットの部品の名前)。
- 実機がつながっていないと、センサーの値は 0 のままで、LED・モーター・サーボの命令は何もしない。そのため、2 人で 1 台・自宅・欠席の補習では進められず、レッスンの「できた」の判定もできない。これを **練習用の基板** で解決する。

Expand All @@ -33,15 +33,15 @@

## 名前の変更と互換の方針

**同じ拡張機能のまま、表示の名前だけを「アーテックロボ(Studuino)」にした**。前の作品(sb3・Ruby)はそのまま開けて、そのまま動く。
**同じ拡張機能のまま、表示の名前だけを「アーテックロボ」にした**。前の作品(sb3・Ruby)はそのまま開けて、そのまま動く。

### キットと基板の呼び分け

中学校の教員用テキスト「計測と制御キットB」に合わせて、**キット全体を「アーテックロボ(ArtecRobo)」、制御基板を「Studuino(スタディーノ)」** と呼び分ける。

| 呼び名 | 使うところ |
|---|---|
| **アーテックロボ(Studuino)**(英語は ArtecRobo (Studuino)、ひらがなの表示は「アーテックロボ (Studuino)」) | 拡張機能の名前(ライブラリのカード・ブロックのカテゴリ・メニューバー・接続モーダルの見出し)、紹介ページ。名前の後ろに基板の名前を添えて、「Studuino で授業ができる」と先生に伝わるようにする |
| **アーテックロボ**(英語は ArtecRobo。ラベルはすべてこの名前にし、Studuino の名前はカードの説明に書く) | 拡張機能の名前(ライブラリのカード・ブロックのカテゴリ・メニューバー・接続モーダルの見出し)、紹介ページ。名前の後ろに基板の名前を添えて、「Studuino で授業ができる」と先生に伝わるようにする |
| **アーテックロボ** | Ruby タブのふりがな(`studuino` の上に出る名前。短いままにする) |
| **Studuino**(スタディーノ) | 基板のこと: 接続の手順の文・ファームウェアのモーダル・練習用の基板のパネル・カードの説明文(「アーテックロボの Studuino 基板」) |

Expand All @@ -51,7 +51,7 @@ Ruby の書き方は `studuino.` のまま(下の「Ruby の書き方」)。

| 対象 | 前 | いま |
|---|---|---|
| 拡張機能の名前(ライブラリ・カテゴリ・メニューバー・接続モーダルの見出し) | スモウルボットS1 | **アーテックロボ(Studuino)**(カテゴリ・メニューバーも同じ。ひらがなの表示は「アーテックロボ (Studuino)」、英語は「ArtecRobo (Studuino)」) |
| 拡張機能の名前(ライブラリ・カテゴリ・メニューバー・接続モーダルの見出し) | スモウルボットS1 | **アーテックロボ**(カテゴリ・メニューバーも同じ。ひらがなの表示は「アーテックロボ」、英語は「ArtecRobo」) |
| 基板を指す文(接続モーダルの文・ファームウェアのモーダル・練習用の基板のパネル) | スモウルボットS1 | **Studuino**(ひらがなの表示の文の中は「スタディーノ」) |
| ライブラリの絵(カード・接続モーダル・カテゴリの絵) | スモウルボットS1 のロボットの写真 | **自分たちで用意した基板の絵**(アーテック社の写真・ロゴは使わない。下の「ライブラリの絵と商標の表記」) |
| ライブラリのカードの説明 | スモウルボットS1を制御する。 | アーテック社の表記に合わせた紹介と、登録商標の一文(下の「ライブラリの絵と商標の表記」) |
Expand All @@ -61,19 +61,19 @@ Ruby の書き方は `studuino.` のまま(下の「Ruby の書き方」)。

### ライブラリの絵と商標の表記

- **絵**: 人間が Gemini で描いた、青い基板を斜めから見たイラストを **もとにして** 作った。アーテック社の製品の写真やロゴは使っていない。基板の上の文字(「STUDY」「EDU」「Servo」「Sensor」「POWER」「ANALOG IN」「Reset」)は、アーテック社の製品やロゴに見えないように消した。
- カード(600×372)は背景ごと切り出して縮小した。接続モーダルの絵(95×95)とカテゴリ・カードの小さい絵(40×40)は、基板だけを切り抜いて背景を透明にした。カテゴリの絵(VM の `blockIconURI`)は 40×40 と同じ絵。
- **商標の表記**: カードの説明は「アーテックロボ(ArtecRobo)の Studuino®(スタディーノ)基板を動かす。**アーテックロボは株式会社アーテックの製品で、Studuino® は同社の登録商標です。**」。Studuino® は登録商標なので ® を付ける。アーテックロボ(ArtecRobo)は商標の扱いを確かめていないので、「登録商標」と言い切らず「株式会社アーテックの製品」と書く。カードには「協力: Artec Co., Ltd.」も出る(実際に協力いただき、基板も提供いただいている)。紹介ページ(`pages/about.html`)の紹介にも同じ一文を入れ、写真はこの基板の絵にした。
- **絵**: 人間が Gemini で描いた、ケースに入った青い基板を斜めから見たオレンジ背景のイラストを **もとにして** 作った。アーテック社の製品の写真やロゴは使っていない。左下の小さいアイコンと外側の白い枠は取り除いた(左下は上の背景で塗りつぶした)。
- カード(600×372)は背景ごと切り出して縮小した。接続モーダルの絵(95×95)とカテゴリ・カードの小さい絵(40×40)は、基板とケースを正方形に切り出し、同じオレンジの背景で余白を埋めた。カテゴリの絵(VM の `blockIconURI`)は 40×40 と同じ絵。
- **商標の表記**: カードの説明は「アーテックロボの Studuino®(スタディーノ)基板を動かす。**アーテックロボは株式会社アーテックの製品で、Studuino® は同社の登録商標です。**」。Studuino® は登録商標なので ® を付ける。アーテックロボは商標の扱いを確かめていないので、「登録商標」と言い切らず「株式会社アーテックの製品」と書く。カードには「協力: Artec Co., Ltd.」も出る(実際に協力いただき、基板も提供いただいている)。紹介ページ(`pages/about.html`)の紹介にも同じ一文を入れ、写真はこの基板の絵にした。

![紹介ページの計測と制御のカード](screenshots/0701-about-page-1280x800.png)

### 移行期間(前の名前のカード)

前の名前の資料(授業の手引き・プリント)が「スモウルボットS1 を選ぶ」と書いているので、**1 年の移行期間**を置く。

- 拡張機能ライブラリには、**アーテックロボ(Studuino)** のカードのすぐ後ろに、前の名前・前の絵(スモウルボットS1 のロボットの写真。`smalrubot-s1/legacy-smalrubot-s1*.png`)の **スモウルボットS1** のカードも出す。説明は「アーテックロボ(Studuino)の前の名前です。選ぶと、アーテックロボ(Studuino)が使えます。」。
- 拡張機能ライブラリには、**アーテックロボ** のカードのすぐ後ろに、前の名前・前の絵(スモウルボットS1 のロボットの写真。`smalrubot-s1/legacy-smalrubot-s1*.png`)の **スモウルボットS1** のカードも出す。説明は「アーテックロボの前の名前です。選ぶと、アーテックロボが使えます。」。
- どちらのカードを選んでも、読みこむのは同じ拡張機能 `smalrubotS1`(ブロック・作品・Ruby は同じ)。拡張機能の ID は 1 つのまま。前のカードはライブラリの中だけの別の項目(キーと DOM の id は `smalrubotS1Legacy`)で、選ぶと今のカードに置きかえてから読みこむので、接続の流れも同じになる。
- 前のカードを選ぶと、画面の上に **名前が変わったことの知らせ**(アラート・閉じるボタンつき。`data-testid="smalrubot-s1-renamed-alert"`)が出る: 「スモウルボットS1 は「アーテックロボ(Studuino)」に名前が変わりました。中身は同じです。これからは「アーテックロボ(Studuino)」を選んでください。」。アラートは接続モーダルより上に出るので、接続の手順の途中でも読める。
- 前のカードを選ぶと、画面の上に **名前が変わったことの知らせ**(アラート・閉じるボタンつき。`data-testid="smalrubot-s1-renamed-alert"`)が出る: 「スモウルボットS1 は「アーテックロボ」に名前が変わりました。中身は同じです。これからは「アーテックロボ」を選んでください。」。アラートは接続モーダルより上に出るので、接続の手順の途中でも読める。
- 前のカードには `smalrubot` / `スモウルボット` などのタグを付けてある(拡張機能ライブラリはいまは検索欄を出していないが、検索を出したときに前の名前で見つかる)。
- **期限**: 前のカードを出すのは **2027-11-30 まで**(その日の終わりまで。端末の日付で判断)。日付は `legacy-card.jsx` の `SMALRUBOT_S1_LEGACY_CARD_LAST_DAY` の 1 か所で、過ぎると自動で出なくなる。期限が来たら、前のカードのコード(`legacy-card.jsx`・前の絵・知らせ・翻訳・テスト・このセクション)を消す。

Expand Down Expand Up @@ -354,7 +354,7 @@ GUI は、イベントを聞いて表示し、センサーの値はこのメソ

### 接続

1. ブロックパレットの「拡張機能を追加」から **アーテックロボ(Studuino)** を選ぶ(2027-11-30 までは **スモウルボットS1** のカードを選んでもよい)
1. ブロックパレットの「拡張機能を追加」から **アーテックロボ** を選ぶ(2027-11-30 までは **スモウルボットS1** のカードを選んでもよい)
2. 接続モーダルが専用フローで開く(`smalrubot-s1-*-step.jsx` 系)。**生徒用 (接続) / 先生用 (ファームウェア書き込み)** のいずれかを選択

![Studuino 初期ステップ](screenshots/0101-initial-step-1280x800.png)
Expand All @@ -365,7 +365,7 @@ GUI は、イベントを聞いて表示し、センサーの値はこのメソ

### ファームウェアフラッシュ

1. 接続モーダルの「ファームウェアを書き込む(先生用)」 もしくはメニューバーの「アーテックロボ(Studuino)」メニューから起動
1. 接続モーダルの「ファームウェアを書き込む(先生用)」 もしくはメニューバーの「アーテックロボ」メニューから起動
2. ファームウェアフラッシュモーダル (`smalrubot-firmware-modal`) が開く。**macOS では PL2303 Serial Driver アプリのインストール案内** が先に表示される

![ファームウェアモーダル (macOS)](screenshots/0201-firmware-modal-macos-1280x800.png)
Expand All @@ -375,7 +375,7 @@ GUI は、イベントを聞いて表示し、センサーの値はこのメソ

### ブロックパレット

接続後はブロックパレットの **アーテックロボ(Studuino)** カテゴリに専用ブロックが表示される(ブロックの一覧は上の「ブロックと選択肢」):
接続後はブロックパレットの **アーテックロボ** カテゴリに専用ブロックが表示される(ブロックの一覧は上の「ブロックと選択肢」):

![アーテックロボのブロックパレット](screenshots/0301-block-palette-1280x800.png)

Expand Down
2 changes: 1 addition & 1 deletion docs/furigana/furigana-mapping.md
Original file line number Diff line number Diff line change
Expand Up @@ -604,7 +604,7 @@ TryRuby 対応で追加された Ruby メソッドのふりがな。
| `mesh_v1`(レシーバー) | `メッシュ(従来)` | — |
| `mesh_v1.sensor_value("x")` | `メッシュ(従来)` `センサーの値` | 「xセンサーの値」 |

### アーテックロボ(Studuino)拡張機能(旧 スモウルボットS1)
### アーテックロボ拡張機能(旧 スモウルボットS1)

`studuino` は事前定義レシーバー。レシーバー自体に `アーテックロボ` のふりがなが付く(読みの「スタディーノ」ではなく、意味としてキットの名前を書く)。ブロックからは `studuino.` を書き出す。前の書き方の `smalrubot_s1` も同じふりがな(レシーバー・メソッド・選択肢)が付く。

Expand Down
4 changes: 2 additions & 2 deletions docs/lessons/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -697,8 +697,8 @@ design.md の「中 2 のコース」。コースの ✓ もこれで数える
| `currentCostume` | いまのコスチューム(`target: 'stage'` なら背景)。`number` = 何番め(1 から)、`changed: true` = 開いたときと別のコスチュームになった。始めにいたものだけ見る | `number`, `changed`, `target`(どちらか 1 つは要る) |
| `tab` | いま開いているタブ(エディタの画面の状態。`code` / `costumes` / `sounds`) | `tab` |
| `partQuiz` | 「どこでしょう?」のクイズに `count` 問正しく答えた(エディタの画面の状態) | `count` |
| `boardCommand` | アーテックロボ(Studuino)の拡張機能が基板に出した命令(実機でも練習用の基板でも同じ記録) | `kind`(必須。`led` / `motor` / `servo` / `servoCalibration`。配列も可), `port`, `value`, `speed`, `whenSensor` |
| `sensorRead` | アーテックロボ(Studuino)の拡張機能がセンサーの値を読んだ | `port`, `sensor`, `value` |
| `boardCommand` | アーテックロボの拡張機能が基板に出した命令(実機でも練習用の基板でも同じ記録) | `kind`(必須。`led` / `motor` / `servo` / `servoCalibration`。配列も可), `port`, `value`, `speed`, `whenSensor` |
| `sensorRead` | アーテックロボの拡張機能がセンサーの値を読んだ | `port`, `sensor`, `value` |

`tab` と `partQuiz` は VM ではなく**エディタの画面の状態**を見る。見張り(`attachGoalMonitor`)に `getUi`(`{activeTab, partQuizSolved}` を
返す関数)を渡し、`containers/lesson-goal-watcher.jsx` がタブ・クイズの答えが変わったら `refresh()` で判定を予約する。
Expand Down
2 changes: 1 addition & 1 deletion docs/maintenance/smalruby-markers-gui.md
Original file line number Diff line number Diff line change
Expand Up @@ -212,7 +212,7 @@ upstream ファイルに追加した Smalruby 固有コードのマーカー一
| `src/components/blocks/blocks.css` | show whole block shape on flyout hover | フライアウトにマウスを乗せている間、長いブロックが右へはみ出して見えるようにする(`clip-path`・RTL 対応)。スクロールバーを左に 4px 離し、ホバー中のスクロールバーの地を不透明度 0.4 にする |
| `src/components/blocks/blocks.css` | v2 toolbox category label selector | カテゴリ名を 0.65rem に縮める規則のクラス名を、scratch-blocks v2.1.19 が描く `.blocklyToolboxCategoryLabel` にする(上流は v1 の `.scratchCategoryMenuItemLabel` のままで効かない) |
| `src/components/library/library.jsx` | extension library key | 拡張機能の項目のキーに `extensionId` を使う |
| `src/containers/extension-library.jsx` | Smalrubot S1 legacy card | 移行期間(2027-11-30 まで)だけ、アーテックロボ(Studuino)のカードの後ろに前の名前のカード「スモウルボットS1」を差しこみ、選ばれたら同じ拡張機能 `smalrubotS1` を読みこんで知らせを出す(import・`handleItemSelect`・render・propTypes・mapDispatchToProps の 5 ペア。処理は `src/lib/libraries/extensions/smalrubot-s1/legacy-card.jsx`) |
| `src/containers/extension-library.jsx` | Smalrubot S1 legacy card | 移行期間(2027-11-30 まで)だけ、アーテックロボのカードの後ろに前の名前のカード「スモウルボットS1」を差しこみ、選ばれたら同じ拡張機能 `smalrubotS1` を読みこんで知らせを出す(import・`handleItemSelect`・render・propTypes・mapDispatchToProps の 5 ペア。処理は `src/lib/libraries/extensions/smalrubot-s1/legacy-card.jsx`) |
| `src/components/library/library.jsx` | modal header actions | `headerActions` を `Modal` に渡す(prop と propType) |
| `src/components/modal/modal.jsx` | modal header actions | ヘッダーの右のボタン置き場 `headerActions`(拡張機能のライブラリ・甲子園のテストのモーダルが使う)。描画と propType |
| `src/components/modal/modal.css` | modal header actions | `.header-item-actions`(`headerActions` の置き場。LTR / RTL の余白) |
Expand Down
Loading
Loading