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
45 changes: 29 additions & 16 deletions docs/dncl/README.md

Large diffs are not rendered by default.

9 changes: 9 additions & 0 deletions docs/dncl/design.md
Original file line number Diff line number Diff line change
Expand Up @@ -148,6 +148,15 @@ Ruby や日本語のプログラムの `表示する` は、キャラクター
Ruby タブは Scratch の部分集合(Scratch でできることを Ruby で書く)なので、コンソールのブロックを Ruby で書く形は足さない。
- 将来の案: Ruby タブに「コンソールモード」のような切りかえを置き、そのときだけ `puts` / `gets` がコンソールを使う。いまは作らない。

### ステージの変数は書かない

- 日本語モードは、**ターミナルで動かすような、1 つで動くプログラム**を想定する。上のとおりステージはコンソールになり、
ステージという考え方はできるだけ薄くする。ステージの変数・リストや、ほかのスプライトの変数は使わない。
- そのため、Ruby の `$a`(ステージの変数・リスト)は日本語にしない。Ruby → 日本語では、`$a` の書いてある位置に
「ステージの変数($a)は日本語モードでは書けません。Ruby モードでは書けます。」の誤りを出す(ほかの日本語にできない Ruby と同じく、
日本語に切りかえず Ruby タブにとどまる)。日本語の変数は、いつもそのスプライトの変数(Ruby の `@a`)になる。
- ステージの変数を使うプログラムは Ruby タブで書く。

### 要素の追加

- 日本語の `A に 値 を追加する` で書けるようにする。
Expand Down
2 changes: 1 addition & 1 deletion docs/dncl/policy.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@
| 種類 | 扱い | 例 |
|---|---|---|
| **意味が変わるもの、または問題文で約束されるもの** | **設定にする**。選んだ設定はプログラムの冒頭に説明文として書く | 添字の始まり(0 から / 1 から)、コメントの記号(`#` か `//` か。`//` をコメントにしたときは、`//` を整数の割り算に使えない)、論理演算子の書き方 |
| **意味が変わらない、見た目だけの揺れ** | **設定にしない**。読むとき(貼り付けなど)はどの書き方も受け付ける。書くとき(ブロックや Ruby から日本語にするとき)は 1 つにそろえる | 行番号の形(`(01)` / `(1)`)、罫線の文字(`|` `⎿` / `|` `└`)、`:` と `:`、全角と半角の演算子(`+` `%` `<`)、引き算の記号(`-` / `−` / `–`)、`,` の後の空白 |
| **意味が変わらない、見た目だけの揺れ** | **設定にしない**。読むとき(貼り付けなど)はどの書き方も受け付ける。書くとき(ブロックや Ruby から日本語にするとき)は 1 つにそろえる | 行番号の形(`(01)` / `(1)`)、罫線の文字(`|` `⎿` / `|` `└`)、`:` と `:`、全角と半角の演算子(`+` `%` `<`)、文字列とコメントの外の全角英字・全角数字(`x1` `12`)、引き算の記号(`-` / `−` / `–`)、`,` の後の空白 |

- 書くときにそろえる 1 つは、上の「文法の決め方」で決める(新しい年度の問題に合わせる)。
- 専門的でない受験者には細かい設定が難しいので、**よくある設定のパターンを用意**する。
Expand Down
7 changes: 5 additions & 2 deletions docs/smalruby-dncl-spec.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -151,8 +151,8 @@ c = "「く」がある" # → "「く」がある" のまま
### 識別子に使える文字

- ASCII 英字(`a-z`, `A-Z`)、アンダースコア(`_`)、2 文字目からは数字(`0-9`)
- ひらがな・カタカナ・漢字(CJK 拡張の漢字も)と、`々` `〆` `ヶ` `ー` など名前に使う文字。全角英字・ギリシャ文字など、ほかの文字体系の文字も使えます(`佐々木`、`α`)
- 全角英字は半角とは別の名前です(`x` と `x` は別の変数)
- ひらがな・カタカナ・漢字(CJK 拡張の漢字も)と、`々` `〆` `ヶ` `ー` など名前に使う文字。ギリシャ文字など、ほかの文字体系の文字も使えます(`佐々木`、`α`)
- 全角英字・全角数字は半角として読みます(`x1` は `x1` と同じ変数)。文字列とコメントの中は書いたとおりです
- `☆` `①` のような記号は使えません

範囲の詳細は `docs/dncl/README.md` の「名前に使える文字」を参照してください。
Expand Down Expand Up @@ -382,6 +382,8 @@ DNCL 風の形の終端キーワードも読みます(読み込みだけ)。
| `を繰り返す` | `の間`(while ループ)、`ずつ増やしながら/減らしながら`(for ループ) |
| `と定義する` | `関数〜`(関数定義) |

ブロックの種類に合わない終端キーワードで閉じると誤りです(`もし〜ならば` を `を繰り返す` で閉じるなど。「「もし〜ならば」は「を繰り返す」ではなく「を実行する」で閉じてください」)。`end` はどのブロックも閉じます。

## 7. 関数

### 関数定義
Expand Down Expand Up @@ -652,6 +654,7 @@ Monaco エディタで以下の要素がハイライトされます:
| 等価比較 | `==`(条件式の中の `=` も比較として読むが、`==` を推奨) |
| 割り算 | `/`(小数になる割り算)、`÷`(商の整数値)。`//` も商の整数値として使える(コメントの記号を `//` にしたときを除く)。負の数の商は小さいほうへ丸める(`-7 ÷ 2` は `-4`) |
| 全角の記号 | `%` `≦` `≧` `≠` `+` などの全角の演算子、`:` `,` も読む。書き出しは半角(余りだけ `%`) |
| 全角英字・全角数字 | 文字列とコメントの外では半角として読む(`x1` は `x1`、`12` は `12`) |
| 入力 | `【外部からの入力】`(答えをそのまま使う)と `【整数を入力】`(整数にする) |
| 要素の追加 | `A に 値 を追加する`(最後に足す。例題に無いので、方針の決め方の ⑤ で決めた) |
| 戻り値 | `値 を返す`(例題に無いので、方針の決め方の ⑤ で決めた) |
Expand Down
1 change: 1 addition & 0 deletions packages/ja-notation/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,4 +87,5 @@ npm run test:unit --workspace=packages/ja-notation
- データは **自作のプログラムだけ** にします。**大学入試センターの問題は使いません**(`docs/dncl/policy.md`)。
- AGPL のコードを写しません(MIT で出すため)。ファイルの先頭に `// SPDX-License-Identifier: MIT` を書きます(`test/boundary.test.js` が確かめます)。
- `src/` は `src/` の中だけを import します(拡張子 `.js` 付き)。
- 構文木をたどる処理は再帰で書かず、ジェネレーターにして `src/run.js` の `run` で動かします(子をたどるところで `yield`)。数千項の式や深いブロックでも呼び出しのスタックが尽きないように(`test/deep.test.js`)。
- スモウルビーの表を通した記録(コーパスとゴールデン)は scratch-gui の `test/fixtures/ja-notation/` にあります。
Loading
Loading